Get-PublicFolder (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-06-06
Use o cmdlet Get-PublicFolder para recuperar os atributos de uma pasta pública ou um conjunto de pastas públicas.
Sintaxe
Get-PublicFolder [-Identity <PublicFolderIdParameter>] [-DomainController <Fqdn>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -GetChildren <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
Get-PublicFolder [-Identity <PublicFolderIdParameter>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]
Descrição detalhada
Para executar o cmdlet Get-PublicFolder, você deve usar uma conta à qual esteja delegada o seguinte:
- 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 |
|---|---|---|---|
GetChildren |
Necessário |
System.Management.Automation.SwitchParameter |
Use o parâmetro GetChildren para recuperar apenas os filhos da pasta especificada pelo parâmetro Identity. O parâmetro GetChildren é mutuamente exclusivo ao parâmetro Recurse. |
Recurse |
Necessário |
System.Management.Automation.SwitchParameter |
O parâmetro Recurse especifica se o comando deve retornar a pasta pública especificada e todos os seus filhos. |
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.PublicFolderIdParameter |
Utilize o parâmetro Identity para especificar a GUID ou o nome da pasta pública que representa uma pasta pública específica. Você pode também incluir o caminho utilizando o formato TopLevelPublicFolder\PublicFolder. Você pode omitir o rótulo do parâmetro Identity para que somente o nome da pasta pública ou a GUID seja fornecido. |
ResultSize |
Opcional |
Microsoft.Exchange.Data.Unlimited |
O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. O máximo padrão é 10.000. Para não limitar os resultados retornados, defina esse parâmetro como Unlimited. Esse parâmetro só pode ser passado em conjunto com os parâmetros Recurse ou GetChildren. |
Server |
Opcional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
O parâmetro Server especifica o servidor no qual executar as operações selecionadas. |
Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
Exceções
| Exceções | Descrição |
|---|---|
|
Exemplo
Os exemplos de código a seguir mostram como usar o comando Get-PublicFolder.
O primeiro exemplo usa o comando Get-PublicFolder sem parâmetros para retornar o objeto da pasta pública raiz (IPM_SUBTREE).
O segundo exemplo retorna os nomes de todas as pastas do sistema (que não são exibidas por padrão), começando pela raiz da pasta do sistema, \NON_IPM_SUBTREE):
O terceiro exemplo retorna a pasta pública com o identificador de entrada de longo prazo especificado.
O quarto exemplo retorna a pasta pública Pending Litigation de \Legal\Documents\.
O quinto exemplo retorna a pasta pública Pending Litigation de \Legal\Documents\ e até 9.999 pastas públicas na pasta Pending Litigation.
O sexto exemplo retorna a pasta pública Pending Litigation de \Legal\Documents\ e todas as pastas públicas que ela contém, sem um limite para o número retornado.
Get-PublicFolder
Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name
Get-PublicFolder -Identity <long-term entry identifier of a public folder>
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse
Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited