Get-OwaVirtualDirectory

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-06-28

Use o cmdlet Get-OwaVirtualDirectory para recuperar todos os diretórios virtuais do Outlook Web Access no computador que executa o Microsoft Exchange Server 2007 com a função de servidor Acesso para Cliente instalada.

Sintaxe

Get-OwaVirtualDirectory [-Identity <VirtualDirectoryIdParameter>] [-DomainController <Fqdn>]

Get-OwaVirtualDirectory -Server <ServerIdParameter> [-DomainController <Fqdn>]

Descrição detalhada

O cmdlet Get-OwaVirtualDirectory é usado para recuperar e exibir as definições de configuração definidas atualmente nos diretórios virtuais do Outlook Web Access no Exchange 2007. O cmdlet Get-OwaVirtualDirectory pode também recuperar e exibir as definições de configuração em um diretório virtual específico do Outlook Web Access.

O cmdlet Get-OwaVirtualDirectory pode ser executado em um servidor local ou ser executado remotamente se o nome de servidor estiver especificado nos parâmetros Identity ou Server. Ele também pode ser executado sem parâmetros para recuperar as definições de configuração de todos os diretórios virtuais do Outlook Web Access em todos os sites de IIS (Serviços de Informações da Internet) localizados nos servidores de Acesso para Cliente da organização.

O cmdlet Get-OwaVirtualDirectory pode ser executado em qualquer servidor em que as ferramentas de administração do Exchange Server estejam instaladas. Você deve usar uma conta à qual esteja delegada a função de Administrador Somente para Exibição do Exchange.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão

Parâmetros

Parâmetro Necessário Tipo Descrição

Server

Necessário

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Esse parâmetro especifica o nome ou a GUID do servidor que hospeda os diretórios virtuais do Outlook Web Access que você deseja exibir. É necessário que você esteja executando o Get-OwaVirtualDirectory em um servidor em que a função de servidor Acesso para Cliente esteja instalada.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Este parâmetro especifica o nome de domínio totalmente qualificado do controlador de domínio que recupera dados do serviço de diretório do Active Directory.

Identity

Optional

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

Esse parâmetro especifica o nome ou a GUID de um diretório virtual do Outlook Web Access. Ele é representado como: ServerName\VirtualDirectoryName (WebsiteName).

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O primeiro exemplo de código mostra como usar o parâmetro Server para recuperar todos os diretórios virtuais do Outlook Web Access em um servidor chamado "Contoso".

O segundo exemplo de código mostra como usar o parâmetro Identity para recuperar as definições de configuração em um diretório virtual do Outlook Web Access chamado "owa (site padrão)" no servidor chamado "Contoso".

Get-OwaVirtualDirectory -Server Contoso
Get-OwaVirtualDirectory -Identity "Contoso\owa (default web site)"