Compartilhar via

Get-ManagedFolder (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-05

Use o cmdlet Get-ManagedFolder para recuperar os atributos de uma ou mais pastas gerenciadas.

Sintaxe

Get-ManagedFolder [-Identity <ELCFolderIdParameter>] [-DomainController <Fqdn>]

Get-ManagedFolder [-DomainController <Fqdn>] [-Mailbox <MailboxIdParameter>]

Descrição detalhada

Use o cmdlet Get-ManagedFolder para recuperar os atributos da pasta gerenciada especificada:

  • Se apenas um valor de parâmetro Identity estiver presente, o comando retornará a pasta especificada e todos os atributos associados.

  • Se um valor de parâmetro Mailbox estiver presente, o comando recuperará todas as pastas que se aplicam a esse usuário por meio de uma diretiva de caixa de correio de pasta gerenciada, aplicada por um administrador.

    Dica

       As pastas gerenciadas que os usuários adicionam através de um site opt-in de pasta gerenciada da organização não serão exibidas por esse comando. Para obter mais informações sobre como criar um site opt-in de pasta gerenciada, consulte o Kit de desenvolvimento de software para o Microsoft Exchange Server 2007.

  • Se nenhum valor de parâmetro for especificado, o comando retornará todos os objetos da pasta e seus atributos associados.

O cmdlet Get-ManagedFolder aceita um objeto ManagedFolder ou uma cadeia de caracteres de identidade como entrada em pipeline.

Para executar o cmdlet Get-ManagedFolder, você deve usar uma conta à 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

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que recupera dados do serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando.

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter

O parâmetro Identity especifica o nome, o nome distinto ou a GUID da pasta gerenciada.

Mailbox

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

O parâmetro Mailbox especifica os métodos pelos quais uma caixa de correio será identificada. Esses métodos incluem endereços de protocolo SMTP, nome de domínio e alias. O comando recupera todas as pastas que se aplicam ao usuário especificado.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

Neste exemplo, o comando Get-ManagedFolder recupera informações sobre a pasta gerenciada especificada chamada MyManagedFolder. A saída do comando Get-ManagedFolder é comunicada por pipe ao comando Format-List para que todas as informações disponíveis sejam exibidas no resultado.

Get-ManagedFolder MyManagedFolder | Format-List