Set-WebServicesVirtualDirectory
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Set-WebServicesVirtualDirectory para modificar os diretórios virtuais existentes dos Serviços Web do Exchange que são usados no IIS (Serviços de Informações da Internet) em servidores Microsoft Exchange.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Set-WebServicesVirtualDirectory
[-Identity] <VirtualDirectoryIdParameter>
[-BasicAuthentication <Boolean>]
[-CertificateAuthentication <Boolean>]
[-Confirm]
[-DigestAuthentication <Boolean>]
[-DomainController <Fqdn>]
[-ExtendedProtectionFlags <MultiValuedProperty>]
[-ExtendedProtectionSPNList <MultiValuedProperty>]
[-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
[-ExternalUrl <Uri>]
[-Force]
[-GzipLevel <GzipLevel>]
[-InternalNLBBypassUrl <Uri>]
[-InternalUrl <Uri>]
[-MRSProxyEnabled <Boolean>]
[-MRSProxyMaxConnections <Unlimited>]
[-OAuthAuthentication <Boolean>]
[-WhatIf]
[-WindowsAuthentication <Boolean>]
[-WSSecurityAuthentication <Boolean>]
[<CommonParameters>]
Description
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Set-WebServicesVirtualDirectory -Identity Contoso\EWS(Default Web Site) -ExternalUrl https://www.contoso.com/EWS/exchange.asmx -BasicAuthentication $true -InternalUrl https://contoso.internal.com/EWS/exchange.asmx
Este exemplo define o método de autenticação como Autenticação básica para o diretório virtual EWS no servidor Contoso. Este exemplo também define as URLs externas e internas desse diretório virtual.
Exemplo 2
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/EWS/exchange.asmx
Este exemplo usa um caractere curinga em vez do "default Web site" usado no Exemplo 1.
Exemplo 3
Set-WebServicesVirtualDirectory -Identity "EWS (Default Web Site)" -MRSProxyEnabled $true
Este exemplo habilita o MRSProxy no site padrão EWS. O MRSProxy é o serviço encarregado de auxiliar nas movimentações da caixa de correio remota.
Parâmetros
-BasicAuthentication
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro BasicAuthentication especifica se a autenticação Básica está habilitada no diretório virtual. Os valores válidos são:
- $true: a autenticação Básica está habilitada. Esse valor é o padrão.
- $true: a autenticação Básica está habilitada. Este é o valor padrão.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CertificateAuthentication
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro CertificateAuthentication especifica se a autenticação de certificado está habilitada. Esse parâmetro afeta o <Servername>/ews/management/ diretório virtual. Isso não afeta o <Servername>/ews/ diretório virtual.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a reconhecer o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DigestAuthentication
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro DigestAuthentication especifica se a autenticação Digest está habilitada no diretório virtual. Os valores válidos são:
- $true: A autenticação Digest está habilitada.
- $false: A autenticação Digest está desabilitada. Esse valor é o padrão.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExtendedProtectionFlags
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro ExtendedProtectionFlags especifica configurações personalizadas para Proteção Estendida para Autenticação no diretório virtual. Os valores válidos são:
- Nenhuma: Esta é a configuração padrão.
- AllowDotlessSPN: necessário se você quiser usar valores de SPN (Nome da Entidade de Serviço) que não contêm FQDNs (por exemplo, HTTP/ContosoMail em vez de HTTP/mail.contoso.com). Você especifica SPNs com o parâmetro ExtendedProtectionSPNList. Essa configuração torna a Proteção Estendida para Autenticação menos segura porque os certificados sem ponto não são exclusivos, portanto, não é possível garantir que a conexão de cliente para proxy foi estabelecida em um canal seguro.
- NoServiceNameCheck: a lista de SPNs não é verificada para validar um token de associação de canal. Essa configuração torna a Proteção Estendida para Autenticação menos segura. Geralmente, essa configuração não é recomendada.
- Proxy: Um servidor proxy é responsável por encerrar o canal TLS. Para usar essa configuração, você precisa registrar um SPN usando o parâmetro ExtendedProtectionSPNList.
- ProxyCoHosting: o tráfego HTTP e HTTPS pode estar acessando o diretório virtual e um servidor proxy está localizado entre pelo menos alguns dos clientes e os serviços de Acesso para Cliente no servidor Exchange.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExtendedProtectionSPNList
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro ExtendedProtectionSPNList especifica uma lista de SPNs (Nomes de Entidade de Serviço) válidos se você estiver usando a Proteção Estendida para Autenticação no diretório virtual. Os valores válidos são:
- $null: esse valor é o padrão.
- SPN único ou lista delimitada por vírgulas de SPNs válidos: O formato de valor do SPN é
Protocol\FQDN. Por exemplo, HTTP/mail.contoso.com. Para adicionar um SPN que não seja um FQDN (por exemplo, HTTP/ContosoMail), você também precisa usar o valor AllowDotlessSPN para o parâmetro ExtendedProtectionFlags.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExtendedProtectionTokenChecking
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro ExtendedProtectionTokenChecking especifica se a Proteção Estendida para Autenticação é usada para conexões de cliente com o diretório virtual. Os valores válidos são:
- Nenhum: a Proteção Estendida para Autenticação não é usada para conexões de cliente com o diretório virtual. Esse valor é o padrão.
- Permitir: a Proteção Estendida para Autenticação será usada para conexões de cliente com o diretório virtual se o cliente e o servidor a suportarem.
- Exigir: a Proteção Estendida para Autenticação é necessária para conexões de cliente com o diretório virtual. Se o cliente ou servidor não for compatível, a conexão falhará. Esse valor também requer um valor de SPN (Nome da Entidade de Serviço) para o parâmetro ExtendedProtectionSPNList.
Observação: se um servidor proxy na frente do servidor Exchange encerrar o canal TLS (Transport Layer Security) de cliente para proxy, os valores Permitir ou Exigir precisarão de um ou mais valores de SPN para o parâmetro ExtendedProtectionSPNList.
Propriedades do parâmetro
| Tipo: | ExtendedProtectionTokenCheckingMode |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExternalUrl
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro ExternalURL especifica a URL que se conecta ao diretório virtual de fora do firewall.
O valor desse parâmetro é importante quando as conexões são criptografadas pelo protocolo TLS.
Propriedades do parâmetro
| Tipo: | Uri |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-GzipLevel
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro GzipLevel define a configuração Gzip para o diretório virtual dos Serviços Web do Exchange. Os valores válidos são:
- Desligado: Sem compactação.
- Baixa: Somente compactação estática. Esse valor é o padrão. Esse valor tem o mesmo resultado que o valor Desativado, pois o conteúdo dos Serviços Web do Exchange é dinâmico.
- Alto: Compressão estática e dinâmica. O conteúdo dos Serviços Web do Exchange será compactado se os clientes indicarem suporte para compactação Gzip em suas solicitações.
- Erro: identifica erros na configuração de compactação Gzip.
Propriedades do parâmetro
| Tipo: | GzipLevel |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro Identity especifica o diretório virtual EWS que você deseja modificar. É possível usar qualquer valor que identifique exclusivamente o diretório virtual. Por exemplo:
- Nome ou Servidor\Nome
- DN (nome diferenciado)
- GUID
O valor Nome usa a sintaxe "VirtualDirectoryName (WebsiteName)" das propriedades do diretório virtual. Você pode especificar o caractere curinga (*) em vez do site padrão usando a sintaxe VirtualDirectoryName*.
Propriedades do parâmetro
| Tipo: | VirtualDirectoryIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-InternalNLBBypassUrl
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Observação: Esse parâmetro se aplica apenas ao Exchange 2010. Por padrão, o Exchange 2013 ou posterior já tem o valor InternalNLBBypassUrl configurado no diretório virtual de back-end do EWS (Serviços Web do Exchange) em servidores de Caixa de Correio.
O parâmetro InternalNLBBypassUrl especifica a URL do servidor Exchange que tem a função de servidor de Acesso para Cliente instalada, independentemente de ele estar atrás de uma matriz NLB (Balanceamento de Carga de Rede) ou não.
Quando você define o parâmetro InternalUrl para a URL da matriz NLB, você deve definir o parâmetro InternalNLBBypassUrl para a URL do próprio servidor de acesso para cliente.
Propriedades do parâmetro
| Tipo: | Uri |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-InternalUrl
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro InternalURL especifica a URL que se conecta ao diretório virtual de dentro do firewall.
O valor desse parâmetro é importante quando as conexões são criptografadas pelo protocolo TLS.
Propriedades do parâmetro
| Tipo: | Uri |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MRSProxyEnabled
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro MRSProxyEnabled especifica se o MRSProxy deve ser habilitado para o diretório virtual de Serviços Web do Exchange em servidores Exchange que tenham a função de servidor de Acesso para Cliente instalada. O MRSProxy ajuda a fazer proxy de movimentações de caixa de correio entre florestas do Active Directory. O valor padrão é $false.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-MRSProxyMaxConnections
Aplicável: Exchange Server 2010
O parâmetro MRSProxyMaxConnections especifica o número máximo de sessões de movimentação simultâneas que uma instância de MRSProxy aceita. Essa configuração aceita valores de 0 a ilimitado. O valor padrão é 100. Para obter mais informações sobre MRSProxy, consulte Noções básicas sobre solicitações de movimentação.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OAuthAuthentication
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro OAuthAuthentication especifica se a autenticação OAuth está habilitada no diretório virtual. Os valores válidos são:
- $true: a autenticação OAuth está habilitada. Esse valor é o padrão.
- $false: a autenticação OAuth está desabilitada.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WindowsAuthentication
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro WindowsAuthentication especifica se a autenticação do Windows integrada está habilitada no diretório virtual. Os valores válidos são:
- $true: O autenticação do Windows integrado está habilitado. Esse valor é o padrão.
- $false: O autenticação do Windows integrado está desabilitado.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WSSecurityAuthentication
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro WSSecurityAuthentication especifica se WS-Security autenticação (Web Services Security) está ativada no diretório virtual. Os valores válidos são:
- $true: WS-Security autenticação está habilitada. Esse valor é o padrão.
- $true: a autenticação WS-Security está habilitada. Este é o valor padrão.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.