Get-EcpVirtualDirectory
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.