Compartilhar via


Get-PublicFolder

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Get-PublicFolder para recuperar os atributos de uma pasta pública ou um conjunto de pastas públicas.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-GetChildren]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]
Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-Recurse]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]
Get-PublicFolder
   [-LostAndFound]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-PublicFolder
   [[-Identity] <PublicFolderIdParameter>]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-Organization <OrganizationIdParameter>]
   [-ResidentFolders]
   [-Server <ServerIdParameter>]
   [<CommonParameters>]

Description

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-PublicFolder

Este exemplo usa o comando Get-PublicFolder sem parâmetros para retornar o objeto da pasta pública raiz (IPM_SUBTREE).

Exemplo 2

Get-PublicFolder -Identity \NON_IPM_SUBTREE -Recurse | Format-List Name

Este 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).

Exemplo 3

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation"

Este exemplo retorna a pasta pública Pending Litigation de \Legal\Documents\.

Exemplo 4

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse

Este exemplo retorna a pasta pública Pending Litigation de \Legal\Documents\ e todas as pastas públicas na pasta pública Pending Litigation. Como o tamanho do resultado não está especificado, o comando retorna até o número máximo de pastas públicas, que é 10.000.

Exemplo 5

Get-PublicFolder -Identity "\Legal\Documents\Pending Litigation" -Recurse -ResultSize Unlimited

Este exemplo retorna a pasta pública Pending Litigation de \Legal\Documents\ e todas as pastas públicas na pasta pública Pending Litigation, sem um limite do número retornado.

Exemplo 6

Get-PublicFolder -Mailbox "Legal Department" -ResidentFolders

Este exemplo retorna as pastas públicas que residem na caixa de correio de conteúdo de pasta público Departamento Jurídico.

Parâmetros

-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GetChildren

A opção GetChildren especifica se deve retornar apenas os filhos da pasta especificada pelo parâmetro Identity. Não é preciso especificar um valor com essa opção.

Você não pode usar essa opção com as opções Recurse ou LostAndFound.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

O parâmetro Identidade especifica o nome e o caminho da pasta pública que você deseja exibir. Um valor válido usa a sintaxe: \Level1\Level2\...\LevenN\PublicFolder. Por exemplo: "\Customer Discussion" ou "\Engineering\Customer Discussion".

Type:PublicFolderIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-LostAndFound

A opção LostAndFound especifica se deve retornar apenas pastas órfãs localizadas em \NON_IPM_SUBTREE\LOST_AND_FOUND. Não é preciso especificar um valor com essa opção.

A pasta LOST_AND_FOUND contém pastas ausentes que são recriadas pelo processo de reconciliação de hierarquia de pasta pública quando a pasta existe em uma caixa de correio de pasta pública secundária, mas não na primária.

Você não pode usar essa opção com o parâmetro Identity ou os comutadores Recurse ou LostAndFound.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-Mailbox

O parâmetro Mailbox especifica a identidade da hierarquia da caixa de correio de pasta pública. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN
Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Organization

Este parâmetro está disponível somente no Exchange local.

Esse parâmetro está reservado para uso interno da Microsoft.

Type:OrganizationIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Recurse

A opção Recurse especifica se deve retornar a pasta pública especificada e todos os seus filhos. Não é preciso especificar um valor com essa opção.

Você não pode usar essa opção com as opções GetChildren ou LostAndFound.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResidentFolders

A opção ResidentFolders especifica se deve retornar pastas públicas que residem em uma caixa de correio de pasta pública de conteúdo específica. Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, o comando retornará apenas pastas públicas cujo conteúdo reside na caixa de correio de pasta pública de hierarquia primária.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ResultSize

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.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Server

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro Server filtra os resultados pelo servidor exchange especificado. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

  • Nome
  • FQDN
  • DN (nome diferenciado)
  • DN Herdado do Exchange
Type:ServerIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.