Set-EcpVirtualDirectory
Este cmdlet está disponível somente no Exchange local.
Use o cmdlet Set-EcpVirtualDirectory para modificar os diretórios virtuais do Exchange Painel de Controle (ECP) usados no IIS (Serviços de Informações da Internet) em servidores Microsoft Exchange. O diretório virtual do ECP gerencia o centro de administração do Exchange.
A interface de gerenciamento da Web do ECP foi introduzida no Exchange Server 2010. No Exchange Server 2013 e no Exchange Server 2016, os diretórios virtuais do EAC e os cmdlets de gerenciamento correspondentes ainda usam o 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.
Sintaxe
Default (Default)
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>]
[-OAuthAuthentication <Boolean>]
[-OwaOptionsEnabled <Boolean>]
[-WhatIf]
[-WindowsAuthentication <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-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 EAC no servidor denominado Server01.
Parâmetros
-AdfsAuthentication
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro AdfsAuthentication especifica que o diretório virtual do ECP permite que os usuários se autentiquem por meio 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.
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 |
-AdminEnabled
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
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 |
-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.
Esse parâmetro pode ser usado com o parâmetro FormsAuthentication ou com os parâmetros DigestAuthentication e WindowsAuthentication.
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 |
-ExternalAuthenticationMethods
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro ExternalAuthenticationMethods especifica os métodos de autenticação com suporte no servidor Exchange de fora do firewall.
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 |
-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.
Você precisa especificar um valor para esse parâmetro para permitir que o serviço de Descoberta Automática retorne a URL para o diretório virtual ECP.
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 |
-FormsAuthentication
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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 por 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 por formulários 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 |
-GzipLevel
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro GzipLevel define informações de configuração Gzip para o diretório virtual do ECP.
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 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 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*.
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 ECP. Se diretórios virtuais do ECP adicionais forem criados, será possível gerenciá-los remotamente.
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 |
-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.
Você precisa especificar um valor para esse parâmetro para permitir que o serviço de Descoberta Automática retorne a URL para o diretório virtual ECP.
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 |
-OAuthAuthentication
Aplicável: Exchange Server 2019, Exchange Server SE
{{ Preencher descrição OAuthAuthentication }}
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 |
-OwaOptionsEnabled
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
O parâmetro OwaOptionsEnabled especifica que as Opções do Outlook na Web estão habilitadas para usuários finais. Se esse parâmetro estiver definido como $false, os usuários não conseguirão acessar Outlook na Web opções. Talvez você queira desabilitar o acesso se sua organização usar ferramentas de provedor que não sejam da Microsoft. Esse parâmetro aceita $true ou $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 |
-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 |
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.