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 ambiente ou de outro.
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.
Sintaxe
GetChildren
Get-PublicFolder
[[-Identity] <PublicFolderIdParameter>]
[-GetChildren]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-ResultSize <Unlimited>]
[-Server <ServerIdParameter>]
[<CommonParameters>]
Recurse
Get-PublicFolder
[[-Identity] <PublicFolderIdParameter>]
[-Recurse]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-ResultSize <Unlimited>]
[-Server <ServerIdParameter>]
[<CommonParameters>]
LostAndFound
Get-PublicFolder
[-LostAndFound]
[-DomainController <Fqdn>]
[-Mailbox <MailboxIdParameter>]
[-Organization <OrganizationIdParameter>]
[-ResidentFolders]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Identity
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 artigo 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-GetChildren
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Não é possível usar essa opção com as opções Recurse ou LostAndFound.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetChildren
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Identity 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".
Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | PublicFolderIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetChildren
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
Recurse
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
Identity
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-LostAndFound
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção LostAndFound especifica se deseja 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 da hierarquia de pastas públicas quando a pasta existe em uma caixa de correio de pasta pública secundária, mas não na primária.
Não é possível usar essa opção com o parâmetro Identity ou as opções Recurse ou LostAndFound.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
LostAndFound
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Mailbox
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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)
- Domínio\Nome de usuário
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Propriedades do parâmetro
| Tipo: | MailboxIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Organization
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | OrganizationIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Recurse
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção Recurse especifica se a pasta pública especificada e todos os seus filhos devem ser retornados. Não é preciso especificar um valor com essa opção.
Não é possível usar essa opção com as opções GetChildren ou LostAndFound.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Recurse
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ResidentFolders
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção ResidentFolders especifica se deseja retornar pastas públicas que residem em uma caixa de correio de pasta pública de conteúdo específico. Não é preciso especificar um valor com essa opção.
Se você não usar esta opção, o comando retornará apenas pastas públicas cujo conteúdo reside na caixa de correio de pasta pública da hierarquia primária.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ResultSize
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetChildren
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
Recurse
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
LostAndFound
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Server
Aplicável: 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
Propriedades do parâmetro
| Tipo: | ServerIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
GetChildren
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
Recurse
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.