Get-OwaVirtualDirectory (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-06-11
Use o cmdlet Get-OwaVirtualDirectory para recuperar todos os diretórios virtuais do Outlook Web Access em um computador do Exchange 2007 em que a função de servidor de Acesso para Cliente esteja 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 que estão definidas atualmente nos diretórios virtuais do Outlook Web Access no Microsoft Exchange Server 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 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 na 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 para a qual estejam delegadas as seguintes funções:
- Função 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 Server 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. |
Identity |
Opcional |
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: |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar o nome de domínio totalmente qualificado do controlador de domínio que recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando. |
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)"