Get-MailPublicFolder

  • 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-MailPublicFolder para recuperar informações relacionadas a email sobre pastas públicas habilitadas para email. Se você desejar obter informações sobre as configurações básicas, não relacionadas a email, de pastas públicas habilitadas para email, use o cmdlet Get-PublicFolder.

Sintaxe

Get-MailPublicFolder [-Identity <MailPublicFolderIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]

Get-MailPublicFolder [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]

Get-MailPublicFolder [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-Server <ServerIdParameter>] [-SortBy <String>]

Descrição detalhada

Para executar o cmdlet Get-MailPublicFolder, você deve usar a conta à qual esteja delegada a seguinte função:

  • Função de Administrador de Pasta Pública do Exchange e grupo Administradores local no servidor de destino

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão.

Parâmetros

Parâmetro Necessário Tipo Descrição

Anr

Opcional

System.String

O parâmetro Anr adota um conjunto de caracteres como valores de parâmetro com os quais realiza uma pesquisa de ANR (resolução de nomes ambíguos).

O serviço de diretório do Active Directory usa o valor e as pesquisas especificados de acordo com sua configuração. Alguns dos atributos padrão pesquisados são CN (nome comum) e alias (mailNickname).

Credential

Opcional

System.Management.Automation.PSCredential

O parâmetro Credential especifica a conta a ser usada para ler o Active Directory. Esse parâmetro é útil principalmente quando o catálogo global é especificado.

A senha deve ser solicitada de maneira segura.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController no comando.

Filter

Opcional

System.String

O parâmetro Filter especifica um conjunto de atributos usados para construir uma consulta para recuperar um conjunto de caixas de correio.

Para obter mais informações sobre as propriedades filtráveis, consulte Propriedades filtráveis do parâmetro -Filter.

Identity

Opcional

Microsoft.Exchange.Configuration.Tasks.MailPublicFolderIdParameter

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.

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração de escopo do destinatário padrão do Shell de Gerenciamento do Exchange e usar toda a floresta como escopo. Isso permite que o comando acesse objetos do Active Directory que não estejam atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:

  • Você não pode usar o parâmetro DomainController. O comando usará automaticamente um servidor de catálogo global adequado.

  • Você pode usar apenas o nome distinto do parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.

  • Você não pode usar os parâmetros OrganizationalUnit e Identity juntos.

  • Você não pode usar o parâmetro Credential.

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

O parâmetro OrganizationalUnit especifica uma UO (unidade organizacional) à qual a pesquisa será limitada. A UO ou o domínio podem ser especificados. O nome canônico da UO deve ser especificado.

ReadFromDomainController

Opcional

System.Management.Automation.SwitchParameter

O parâmetro ReadFromDomainController especifica se as informações do usuário são lidas a partir de um controlador de domínio no domínio do usuário. Se você definir o escopo do destinatário para incluir todos os destinatários da floresta e não usar este parâmetro, talvez as informações do usuário sejam lidas a partir de um catálogo global com informações desatualizadas. Se você usar este parâmetro, várias leituras poderão ser necessárias para obter as informações.

Dica

Por padrão, o escopo do destinatário é definido como o domínio que hospeda seus servidores Exchange.

ResultSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados.

Server

Opcional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

O parâmetro Server especifica a identidade do servidor do qual executar a operação. Se um servidor não for especificado, o comando verificará se o servidor local é um servidor de Caixa de Correio que está executando o Microsoft Exchange 2007 com um armazenamento de pasta pública. Se for, a pasta será criada localmente. Se não for, o comando encontrará o servidor de Caixa de Correio do Exchange 2007 mais próximo (por custo do site) que tenha um armazenamento de pasta pública montado.

SortBy

Opcional

System.String

O parâmetro SortBy especifica o atributo pelo qual os resultados são classificados. A classificação é feita com um atributo de cada vez. O conjunto de resultados classificados é fornecido em ordem crescente.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

Exceções

Exceções Descrição

 

Exemplo

Esse exemplo retorna todas as pastas públicas habilitadas para email. Neste exemplo, a saída do comando Get-MailPublicFolder é canalizada para o comando Format-List para que todas as informações disponíveis sejam exibidas no resultado.

Get-MailPublicFolder | Format-List