Get-EcpVirtualDirectory

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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

Use o cmdlet Get-EcpVirtualDirectory para exibir diretórios virtuais do Exchange Painel de Controle (ECP) que são usados no IIS (Serviços de Informações da Internet) em servidores do Exchange Microsoft. O Centro de administração do Exchange (EAC) usa os diretórios virtuais do ECP.

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

Get-EcpVirtualDirectory
   -Server <ServerIdParameter>
   [-ADPropertiesOnly]
   [-DomainController <Fqdn>]
   [-ShowMailboxVirtualDirectories]
   [<CommonParameters>]
Get-EcpVirtualDirectory
   [[-Identity] <VirtualDirectoryIdParameter>]
   [-ADPropertiesOnly]
   [-DomainController <Fqdn>]
   [-ShowMailboxVirtualDirectories]
   [<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

Get-EcpVirtualDirectory -Server Server01

Este exemplo retorna uma lista de resumo de todos os diretórios virtuais do Exchange Painel de Controle no servidor chamado Server01.

Exemplo 2

Get-EcpVirtualDirectory -Identity "Server01\ecp*" | Format-List

Este exemplo retorna informações detalhadas para o Exchange Painel de Controle diretório virtual chamado "ecp (Site Padrão)" no servidor chamado Server01.

Exemplo 3

Get-EcpVirtualDirectory

Este exemplo retorna uma lista de resumo de todos os diretórios virtuais do Exchange Painel de Controle nos serviços de acesso ao cliente em todos os servidores de caixa de correio da organização.

Parâmetros

-ADPropertiesOnly

A opção ADPropertiesOnly especifica se deve retornar apenas as propriedades do diretório virtual armazenadas no Active Directory. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, as propriedades no Active Directory e na metabase do IIS (Serviços de Informações da Internet) serão retornadas.

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

-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

-Identity

O parâmetro Identity especifica o diretório virtual ECP que você deseja exibir. É 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*.

Não é possível usar os parâmetros Identity e Server no mesmo comando.

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

-Server

O parâmetro Server especifica o servidor exchange que hospeda o diretório virtual. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

  • Nome
  • FQDN
  • DN (nome diferenciado)
  • ExchangeLegacyDN

Não é possível usar os parâmetros Server e Identity no mesmo comando.

Type:ServerIdParameter
Position:Named
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

-ShowMailboxVirtualDirectories

A opção ShowMailboxVirtualDirectories mostra informações sobre diretórios virtuais de back-end em servidores de caixa de correio. Não é preciso especificar um valor com essa opção.

Por padrão, este cmdlet mostra informações sobre diretórios virtuais nos serviços de Acesso ao Cliente em servidores de caixa de correio. As conexões do cliente são proxied dos serviços de Acesso ao Cliente em servidores de caixa de correio para os serviços de back-end em servidores de caixa de correio. Os clientes não se conectam diretamente aos serviços de back-end.

Por padrão, esse cmdlet mostra informações sobre diretórios virtuais nos serviços de Acesso para Cliente em servidores de Caixa de Correio. As conexões do cliente são feitas por proxy dos serviços de Acesso para Cliente nos servidores de Caixa de Correio para os serviços de back-end nos servidores de Caixa de Correio. Os clientes não se conectam diretamente aos serviços de back-end.

Type:SwitchParameter
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

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.