Partilhar via

Set-EcpVirtualDirectory

Módulo:
Exchange PowerShell

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

Utilize o cmdlet Set-EcpVirtualDirectory para modificar diretórios virtuais do Exchange Painel de Controle (ECP) que são utilizados nos Serviços de Informação Internet (IIS) em servidores do Microsoft Exchange. O diretório virtual ECP gere o centro de administração do Exchange.

A interface de gestão Web ECP foi introduzida no Exchange Server 2010. No Exchange Server 2013 e Exchange Server 2016, os diretórios virtuais EAC e os cmdlets de gestão correspondentes ainda utilizam eCP no nome. Pode utilizar estes cmdlets para gerir 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.

Sintaxe

Default (Padrão) 

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, 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-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 ao EAC no servidor com o nome Server01.

Parâmetros

-AdfsAuthentication

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

O parâmetro AdfsAuthentication especifica que o diretório virtual ECP permite que os utilizadores se autentiquem através da autenticação Serviços de Federação do Active Directory (AD FS) (AD FS). Esse parâmetro aceita $true ou $false. O valor predefinido é $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

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

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.

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

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 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 confirmar 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

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

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

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 SSL. 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

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

O parâmetro ExtendedProtectionTokenChecking define como pretende utilizar a Proteção Expandida 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:

  • Nenhuma: a Proteção Expandida para Autenticação não é utilizada no diretório virtual. Este valor é a predefinição.
  • None: a Proteção Estendida para Autenticação não é usada no diretório virtual. Connections que não suportam a Proteção Expandida para o trabalho de Autenticação, mas que podem não ser tão seguras como as ligações que utilizam a Proteção Expandida para Autenticação.
  • Exigir: a Proteção Alargada para Autenticação é utilizada para todas as ligações entre clientes e o diretório virtual. Se o cliente ou o servidor não o suportar, a ligação falhará. Se utilizar este valor, também terá de definir um valor SPN para o parâmetro ExtendedProtectionSPNList.

Nota: se utilizar o valor Permitir ou Exigir e tiver um servidor proxy entre o cliente e os serviços de Acesso de Cliente no servidor da Caixa de Correio configurado para terminar o canal SSL cliente a proxy, também terá de configurar um ou mais Nomes dos Principais de Serviço (SPNs) com 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

O parâmetro ExternalAuthenticationMethods especifica os métodos de autenticação suportados no servidor Exchange de fora da 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

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.

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

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: Forms autenticação está ativada. O parâmetro BasicAuthentication está definido como $true e os parâmetros DigestAuthentication e WindowsAuthentication estão definidos como $false.
  • $false: Forms autenticação 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

-GzipLevel

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

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

Para gerir o primeiro diretório virtual ECP criado numa organização do Exchange, tem de utilizar 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

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.

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

{{ Fill OAuthAuthentication Description }}

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

O parâmetro OwaOptionsEnabled especifica que Outlook na Web Opções está ativado para os utilizadores finais. Se este parâmetro estiver definido como $false, os utilizadores não poderão aceder às Opções de Outlook na Web. Poderá querer desativar o acesso se a sua organização utilizar ferramentas de fornecedor não 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

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.

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

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

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.