Set-WebServicesVirtualDirectory
Este cmdlet está disponível somente no Exchange local.
Utilize o cmdlet Set-WebServicesVirtualDirectory para modificar diretórios virtuais do Serviços Web do Exchange existentes que são utilizados nos Serviços de Informação Internet (IIS) nos servidores do 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, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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á ativada no diretório virtual. Os valores válidos são:
- $true: a autenticação básica está ativada. Este valor é a predefiniçã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. Este parâmetro afeta o <Servername>/ews/management/ diretório virtual. 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 este comutador 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 estes cmdlets, especificar o comutador Confirmar sem um valor introduz uma pausa que o obriga 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á ativada no diretório virtual. Os valores válidos são:
- $true: a autenticação resumida está ativada.
- $false: a autenticação resumida está desativada. Este valor é a predefiniçã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 definições personalizadas para Proteção Expandida para Autenticação no diretório virtual. Os valores válidos são:
- Nenhuma: Esta é a configuração padrão.
- AllowDotlessSPN: necessário se quiser utilizar valores de Nome Principal de Serviço (SPN) que não contenham FQDNs (por exemplo, HTTP/ContosoMail em vez de HTTP/mail.contoso.com). Especifique SPNs com o parâmetro ExtendedProtectionSPNList. Esta definição torna a Proteção Expandida para Autenticação menos segura porque os certificados sem pontos não são exclusivos, pelo que não é possível garantir que a ligação cliente a proxy foi estabelecida através de um canal seguro.
- NoServiceNameCheck: a lista SPN não está selecionada para validar um token de enlace de canal. Esta definição torna a Proteção Expandida para Autenticação menos segura. Geralmente, essa configuração não é recomendada.
- Proxy: um servidor proxy é responsável por terminar o canal TLS. Para utilizar esta definição, tem de registar um SPN com o parâmetro ExtendedProtectionSPNList.
- ProxyCoHosting: o tráfego HTTP e HTTPS pode estar a aceder ao diretório virtual e um servidor proxy está localizado entre, pelo menos, alguns dos clientes e os serviços de Acesso de 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 Nomes de Principais de Serviço (SPNs) válidos se estiver a utilizar a Proteção Expandida para Autenticação no diretório virtual. Os valores válidos são:
- $null: este valor é a predefinição.
- SPN único ou lista delimitada por vírgulas de SPNs válidos: o formato de valor SPN é
Protocol\FQDN. Por exemplo, HTTP/mail.contoso.com. Para adicionar um SPN que não seja um FQDN (por exemplo, HTTP/ContosoMail), também tem de utilizar 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 Expandida para Autenticação é utilizada para ligações de cliente ao diretório virtual. Os valores válidos são:
- Nenhuma: a Proteção Expandida para Autenticação não é utilizada para ligações de cliente ao diretório virtual. Este valor é a predefinição.
- Permitir: a Proteção Expandida para Autenticação é utilizada para ligações de cliente ao diretório virtual se o cliente e o servidor o suportarem.
- Exigir: a Proteção Alargada para Autenticação é necessária para as ligações de cliente ao diretório virtual. Se o cliente ou servidor não o suportar, a ligação falhará. Este valor também requer um valor de Nome Principal de Serviço (SPN) para o parâmetro ExtendedProtectionSPNList.
Nota: se um servidor proxy à frente do servidor Exchange terminar o canal TLS (Transport Layer Security) cliente para proxy, os valores Permitir ou Exigir precisam de um ou mais valores 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 o URL que se liga ao diretório virtual de fora da firewall.
O valor deste parâmetro é importante quando as ligações são encriptadas pelo Transport Layer Security (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
O comutador 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 Exchange. Os valores válidos são:
- Desativado: sem compressão.
- Baixa: apenas compressão estática. Este valor é a predefinição. Este valor tem o mesmo resultado que o valor Desativado, porque o conteúdo dos Serviços Web Exchange é dinâmico.
- Alta: compressão estática e dinâmica. O conteúdo dos Serviços Web exchange é comprimido se os clientes indicarem suporte para compressão Gzip nos pedidos.
- Erro: identifica erros na configuração de compressã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 do EWS que pretende 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 utiliza a sintaxe "VirtualDirectoryName (WebsiteName)" das propriedades do diretório virtual. Pode especificar o caráter universal (*) em vez do site predefinido com 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
Nota: Este parâmetro aplica-se apenas ao Exchange 2010. Por predefinição, o Exchange 2013 ou posterior já tem o valor InternalNLBBypassUrl configurado no diretório virtual dos Serviços Web exchange (EWS) de back-end em servidores de Caixa de Correio.
O parâmetro InternalNLBBypassUrl especifica o URL do servidor Exchange que tem a função de servidor de Acesso de Cliente instalada, independentemente de estar ou não protegida por uma matriz de Balanceamento de Carga na Rede (NLB).
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 o URL que se liga ao diretório virtual a partir do interior da firewall.
O valor deste parâmetro é importante quando as ligações são encriptadas pelo Transport Layer Security (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 pretende ativar o MRSProxy para o diretório virtual dos Serviços Web Exchange em servidores Exchange que tenham a função de servidor de Acesso de Cliente instalada. O MRSProxy ajuda a mover a caixa de correio de proxy entre florestas do Active Directory. O valor predefinido é $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 aceites por uma instância do MRSProxy. Esta definição aceita valores de 0 a ilimitados. O valor padrão é 100. Para obter mais informações sobre o MRSProxy, veja Compreender os Pedidos 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á ativada no diretório virtual. Os valores válidos são:
- $true: a autenticação OAuth está ativada. Este valor é a predefinição.
- $false: a autenticação OAuth está desativada.
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
O parâmetro WhatIf mostra o que o comando faz sem efetuar alterações. 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 o autenticação do Windows Integrado está ativado no diretório virtual. Os valores válidos são:
- $true: a autenticação do Windows integrada está ativada. Este valor é a predefinição.
- $false: a autenticação do Windows integrada está desativada.
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 a autenticação WS-Security (Segurança dos Serviços Web) está ativada no diretório virtual. Os valores válidos são:
- $true: WS-Security autenticação está ativada. Este valor é a predefiniçã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 suporta os 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.