Compartilhar via


Set-WebServicesVirtualDirectory

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Set-WebServicesVirtualDirectory para modificar diretórios virtuais existentes do Exchange Web Services que são usados no IIS (Serviços de Informações da Internet) em servidores do Exchange Microsoft.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

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 tópico 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

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 é o valor padrão.
  • $true: a autenticação Básica está habilitada. Este é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-CertificateAuthentication

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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets 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 confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DigestAuthentication

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 de digestão está habilitada.
  • $false: a autenticação digest está desabilitada. Esse é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

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.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExtendedProtectionFlags

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: obrigatório se você quiser usar valores SPN (Nome da Entidade de Serviço) que não contenham 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 certificados sem ponto não são exclusivos, portanto, não é possível garantir que a conexão cliente-proxy tenha sido estabelecida em um canal seguro.
  • NoServiceNameCheck: a lista SPN não está marcada 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 SSL. 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 ao Cliente no servidor exchange.
Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExtendedProtectionSPNList

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 é o valor padrão.
  • SPN único ou lista delimitada por vírgulas de SPNs válidas: 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), você também precisa usar o valor AllowDotlessSPN para o parâmetro ExtendedProtectionFlags.
Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExtendedProtectionTokenChecking

O parâmetro ExtendedProtectionTokenChecking define como você deseja usar a Proteção Estendida para Autenticação no diretório virtual. A Proteção Estendida para Autenticação não está habilitada por padrão. Os valores válidos são:

  • Nenhum: Proteção Estendida para Autenticação não é usada no diretório virtual. Esse é o valor padrão.
  • None: a Proteção Estendida para Autenticação não é usada no diretório virtual. Este é o valor padrão.
  • Exigir: Proteção Estendida para Autenticação é usada para todas as conexões entre clientes e o diretório virtual. Se o cliente ou o servidor não der suporte a ele, a conexão falhará. Se você usar esse valor, também precisará definir um valor SPN para o parâmetro ExtendedProtectionSPNList.

Observação: se você usar o valor Permitir ou Exigir e tiver um servidor proxy entre o cliente e os serviços de Acesso ao Cliente no servidor caixa de correio configurado para encerrar o canal SSL cliente a proxy, você também precisará configurar um ou mais SPNs (Nomes de Entidade de Serviço) usando o parâmetro ExtendedProtectionSPNList.

Type:ExtendedProtectionTokenCheckingMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExternalUrl

O parâmetro ExternalURL especifica a URL usada para se conectar ao diretório virtual de fora do firewall.

Essa configuração é importante quando a SSL é usada.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Force

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GzipLevel

O parâmetro GzipLevel define a configuração de Gzip para o diretório virtual do Exchange Web Services. Os valores válidos são:

  • Desativado: sem compactação.
  • Baixa: somente compactação estática. Esse é o valor padrão. Esse valor tem o mesmo resultado que o valor Off, pois o conteúdo do Exchange Web Services é dinâmico.
  • Alta: compactaçã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 de Gzip.
Type:GzipLevel
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identity especifica o diretório virtual do 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 Name 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*.

Type:VirtualDirectoryIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalNLBBypassUrl

Nota: 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 do Exchange Web Services (EWS) de back-end nos servidores da Caixa de Correio.

O parâmetro InternalNLBBypassUrl especifica a URL do servidor exchange que tem a função de servidor de Acesso ao Cliente instalada, independentemente de estar por trá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.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalUrl

O parâmetro InternalURLespecifica a URL usada para se conectar ao diretório virtual de dentro do firewall.

Essa configuração é importante quando SSL é usado.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MRSProxyEnabled

O parâmetro MRSProxyEnabled especifica se o MRSProxy habilitará o MRSProxy para o diretório virtual do Exchange Web Services em servidores exchange que têm a função de servidor de Acesso ao Cliente instalada. O MRSProxy ajuda a mover a caixa de correio proxy entre florestas do Active Directory. O valor padrão é $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MRSProxyMaxConnections

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro MRSProxyMaxConnections especifica o número máximo de sessões de movimento simultâneas que uma instância do MRSProxy aceitará. Essa configuração aceita valores de 0 a ilimitados. O valor padrão é 100. Para obter mais informações sobre MRSProxy, consulte Noções básicas sobre solicitações de movimentação.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-OAuthAuthentication

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 é o valor padrão.
  • $false: a autenticação OAuth está desabilitada.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WindowsAuthentication

O parâmetro WindowsAuthentication especifica se o autenticação do Windows integrado está habilitado no diretório virtual. Os valores válidos são:

  • $true: o autenticação do Windows integrado está habilitado. Esse é o valor padrão.
  • $false: o autenticação do Windows integrado está desabilitado.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WSSecurityAuthentication

O parâmetro WSSecurityAuthentication especifica se a autenticação WS-Security (Segurança dos Serviços Web) está habilitada no diretório virtual. Os valores válidos são:

  • $true: WS-Security autenticação está habilitada. Esse é o valor padrão.
  • $true: a autenticação WS-Security está habilitada. Este é o valor padrão.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.