Get-ManagedFolder
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-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