Get-PublicFolder

  • Artigo

 

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

Tópico modificado em: 2009-05-12

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>] -Recurse <SwitchParameter> [-DomainController <Fqdn>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>]

Get-PublicFolder [-Identity <PublicFolderIdParameter>] -GetChildren <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 de Administrador de Pasta Pública do Exchange e grupo Administradores local no servidor de destino.

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 FQDN (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.

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

Quando você executar o cmdlet Get-PublicFolder e o valor UseDatabaseQuotaDefaults for verdadeiro, os seguintes valores serão exibidos com os valores do banco de dados a partir do Get-PublicFolderDatabase:

  • MaxItemSize

  • IssueWarningQuota

  • ProhibitPostQuota

Além disso, cada valor possui a cadeia de caracteres "(InheritFromDB)" anexada.