Set-EcpVirtualDirectory

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

Use o cmdlet Set-EcpVirtualDirectory para modificar os diretórios virtuais do painel de controle do Exchange (ECP) usados nos serviços de informações da Internet (IIS) em servidores do Microsoft Exchange. O diretório virtual do ECP gerencia o centro de administração do Exchange.

A interface de gerenciamento da Web de ECP foi introduzida no Exchange Server 2010. No Exchange Server 2013 e no Exchange Server 2016, os diretórios virtuais do Eat e os cmdlets de gerenciamento correspondentes ainda usam o ECP no nome. Você pode usar esses cmdlets para gerenciar diretórios virtuais ECP nos servidores Exchange 2010, Exchange 2013 e Exchange 2016.

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

Syntax

Set-EcpVirtualDirectory
   [-Identity] <VirtualDirectoryIdParameter>
   [-AdfsAuthentication <Boolean>]
   [-AdminEnabled <Boolean>]
   [-BasicAuthentication <Boolean>]
   [-Confirm]
   [-DigestAuthentication <Boolean>]
   [-DomainController <Fqdn>]
   [-ExtendedProtectionFlags <MultiValuedProperty>]
   [-ExtendedProtectionSPNList <MultiValuedProperty>]
   [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
   [-ExternalAuthenticationMethods <MultiValuedProperty>]
   [-ExternalUrl <Uri>]
   [-FormsAuthentication <Boolean>]
   [-GzipLevel <GzipLevel>]
   [-InternalUrl <Uri>]
   [-LiveIdAuthentication <Boolean>]
   [-OwaOptionsEnabled <Boolean>]
   [-WhatIf]
   [-WindowsAuthentication <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.

Examples

Exemplo 1

Set-EcpVirtualDirectory -Identity "Server01\ecp (Default Web site)" -BasicAuthentication:$false

Este exemplo desabilita a autenticação Básica no diretório virtual padrão do ECP no servidor chamado Server01.

Exemplo 2

Set-EcpVirtualDirectory -Identity "Server01\ecp (Default Web site)" -AdminEnabled $false

Este exemplo desativa o acesso à Internet para o Eat no servidor chamado Server01.

Parameters

- FormsAuthentication

O parâmetro FormsAuthentication especifica se a autenticação baseada em formulário está habilitada no diretório virtual do ECP. Os valores válidos são:

  • $true: a autenticação de formulários está habilitada. O parâmetro BasicAuthentication está definido como $true e os parâmetros DigestAuthentication e WindowsAuthentication estão definidos como $false.

  • $false: a autenticação de formulários está desabilitada.

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

O parâmetro AdfsAuthentication especifica que o diretório virtual do ECP permite que os usuários autentiquem através da autenticação dos serviços de Federação do Active Directory (AD FS). Esse parâmetro aceita $true ou $false. O valor padrão é $false.

São informadas as configurações de autenticação do ADFS para Set-OwaVirtualDirectory e Set-EcpVirtualDirectory. Defina o parâmetro AdfsAuthentication de Set-EcpVirtualDirectory como $true, antes de definir o parâmetro AdfsAuthentication de Set-OwaVirtualDirectory como $true. Da mesma forma, defina o parâmetro AdfsAuthentication de Set-OwaVirtualDirectory como $false, antes de definir o parâmetro AdfsAuthentication de Set-EcpVirtualDirectory como $false.

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

O parâmetro AdminEnabled especifica se o EAC não pode ser acessado pela Internet. Para saber mais, confira Desativar o acesso ao centro de administração do Exchange. Esse parâmetro aceita $true ou $false.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-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.

Esse parâmetro pode ser usado com o parâmetro FormsAuthentication ou com os parâmetros DigestAuthentication e WindowsAuthentication.

Type:Boolean
Position:Named
Default value:None
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, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação 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 confirmar o comando antes de continuar.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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 Digest está habilitada.

  • $false: a autenticação Digest está desabilitada. Esse é o valor padrão.

Type:Boolean
Position:Named
Default value:None
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
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 as configurações personalizadas para a 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ê deseja usar os valores de nome de entidade de serviço (SPN) que não contêm FQDNs (por exemplo, HTTP/ContosoMail em vez de HTTP/mail. contoso. com). Você especifica os SPNs com o parâmetro ExtendedProtectionSPNList. Essa configuração torna a proteção estendida para autenticação menos segura porque certificados sem segurança não são exclusivos, portanto, não é possível garantir que a conexão de cliente para proxy tenha sido estabelecida por meio de um canal seguro.

  • NoServiceNameCheck: a lista SPN 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 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 para cliente no servidor Exchange.

Type:MultiValuedProperty
Position:Named
Default value:None
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 nomes de entidade de serviço (SPNs) válidos se você estiver usando a proteção estendida para autenticação no diretório virtual. Os valores válidos são:

  • $null: Este é o valor padrão.

  • Único SPN 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 é 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
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:

  • None: a 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: a proteção estendida para autenticação é usada para todas as conexões entre os clientes e o diretório virtual. Se o cliente ou servidor não oferecer suporte a ele, a conexão falhará. Se você usar esse valor, também precisará definir um valor de 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 para cliente no servidor de caixa de correio que está configurado para encerrar o canal SSL cliente-para-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ExternalAuthenticationMethods

O parâmetro ExternalAuthenticationMethods especifica os métodos de autenticação suportados no servidor do Exchange de fora do firewall.

Type:MultiValuedProperty
Position:Named
Default value:None
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.

Esta configuração também é importante quando SSL (Secure Sockets Layer) é usado. É preciso definir esse parâmetro para permitir que o serviço de Descoberta Automática retorne a URL do diretório virtual do ECP.

Type:Uri
Position:Named
Default value:None
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 informações de configuração Gzip para o diretório virtual do ECP.

Type:GzipLevel
Position:Named
Default value:None
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 ECP que você deseja modificar. É possível usar qualquer valor que identifique exclusivamente o diretório virtual. Por exemplo:

  • Nome ou <Server> \ nome

  • DN (nome diferenciado)

  • GUID

O valor Name usa a sintaxe " <VirtualDirectoryName> ( <WebsiteName> )" nas propriedades do diretório virtual. Você pode especificar o caractere curinga ( * ) em vez do site padrão usando a sintaxe <VirtualDirectoryName> * .

Para gerenciar o primeiro diretório virtual ECP criado em uma organização do Exchange, você precisa usar este cmdlet no computador que inclui o primeiro diretório virtual do ECP. Se diretórios virtuais do ECP adicionais forem criados, será possível gerenciá-los remotamente.

Type:VirtualDirectoryIdParameter
Position:1
Default value:None
Accept pipeline input:True
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.

Esta configuração também é importante quando SSL é usado. É preciso definir esse parâmetro para permitir que o serviço de Descoberta Automática retorne a URL do diretório virtual do ECP.

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

Esse parâmetro está disponível ou funcional somente no Exchange Server 2010.

O parâmetro LiveIdAuthentication especifica se a autenticação do Windows Live ID está habilitada para o diretório virtual do painel de controle do Exchange.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-OwaOptionsEnabled

O parâmetro OwaOptionsEnabled especifica que o Outlook nas opções da Web está habilitado para os usuários finais. Se esse parâmetro for definido como $false, os usuários não poderão acessar o Outlook nas opções da Web. Você pode querer desabilitar o acesso se sua organização usar ferramentas de provedor terceirizado. Esse parâmetro aceita $true ou $false.

Type:Boolean
Position:Named
Default value:None
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
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 a autenticação integrada do Windows está habilitada no diretório virtual. Os valores válidos são:

  • $true: a autenticação integrada do Windows está habilitada. Esse é o valor padrão.

  • $false: a autenticação integrada do Windows está desabilitada.

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

Inputs

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.

Outputs

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.