Set-EcpVirtualDirectory
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Set-EcpVirtualDirectory para modificar diretórios virtuais do Exchange Painel de Controle (ECP) que são usados no IIS (Internet Information Services) em servidores do Exchange Microsoft. O diretório virtual do ECP gerencia o centro de administração do Exchange.
A interface de gerenciamento Web do ECP foi introduzida no Exchange Server 2010. Em Exchange Server 2013 e Exchange Server 2016, os diretórios virtuais EAC e os cmdlets de gerenciamento correspondentes ainda usam ECP no nome. Você pode usar esses cmdlets para gerenciar diretórios virtuais do 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>]
[-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.
Exemplos
Exemplo 1
Set-EcpVirtualDirectory -Identity "Server01\ecp (Default Web site)" -BasicAuthentication:$falseEste 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 $falseEste exemplo desativa o acesso à Internet ao EAC no servidor chamado Server01.
Parâmetros
-AdfsAuthentication
O parâmetro AdfsAuthentication especifica que o diretório virtual do ECP permite que os usuários se autentiquem por meio da autenticação do AD FS (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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| 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 |
-ExternalAuthenticationMethods
O parâmetro ExternalAuthenticationMethods especifica os métodos de autenticação compatíveis no servidor exchange de fora do firewall.
| 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 |
-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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-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 |
| 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 informações de configuração Gzip para o diretório virtual do ECP.
| 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 ECP 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*.
Para gerenciar o primeiro diretório virtual ECP criado em uma organização do Exchange, você precisa usar esse cmdlet no computador que inclui o primeiro diretório virtual ECP. Se diretórios virtuais do ECP adicionais forem criados, será possível gerenciá-los remotamente.
| 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 |
-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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-OwaOptionsEnabled
O parâmetro OwaOptionsEnabled especifica que Outlook na Web Options está habilitado para usuários finais. Se esse parâmetro estiver definido como $false, os usuários não poderão acessar Outlook na Web Opções. 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 |
| 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 |
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.