Get-EmailAddressPolicy (RTM)

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-05

Use o cmdlet Get-EmailAddressPolicy para retornar todos os atributos de uma diretiva ou de um conjunto de diretivas.

Sintaxe

Get-EmailAddressPolicy [-Identity <EmailAddressPolicyIdParameter>] [-DomainController <Fqdn>] [-IncludeMailboxSettingOnlyPolicy <SwitchParameter>]

Descrição detalhada

Use o cmdlet Get-EmailAddressPolicy para retornar objetos de diretiva de endereço de email que correspondam à identidade especificada ou retornar todos os objetos de Diretiva de Endereço de Email existentes.

Para executar o cmdlet Get-EmailAddressPolicy, deve ser delegada à conta que você usa a seguinte função:

• 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
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. O parâmetro DomainController não tem suporte em computadores que executam a função de servidor Transporte de Borda. A função de servidor Transporte de Borda grava somente na instância local do Active Directory Application Mode (ADAM).
Identity	Opcional	Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter	Use o parâmetro Identity para especificar a GUID, o nome distinto e o nome da diretiva de endereço de e-mail que representa um endereço de e-mail específico. Você também pode incluir o caminho usando o formato Path\EmailAddressPolicy. Você pode omitir o rótulo do parâmetro Identity para que somente o nome da diretiva de endereço de e-mail ou a GUID
IncludeMailboxSettingOnlyPolicy	Opcional	System.Management.Automation.SwitchParameter	O parâmetro IncludeMailboxSettingOnlyPolicy recupera diretivas de endereços de email do Microsoft Exchange Server 2003 que contenham apenas configuração de gerenciamento de caixa de correio. O Exchange Server 2007 suporta diretivas que contenham apenas configurações de diretivas de endereços de email, e diretivas que contenham configurações de diretivas de endereços de email e configuração de gerenciamento de caixa de correio. O Exchange 2007 não suporta diretivas que contenham apenas configuração de gerenciamento de caixa de correio, mas as diretivas do Exchange 2003 que contêm apenas configuração de gerenciamento de caixas de correio são, por padrão, preservadas e não são atualizadas. O parâmetro IncludeMailboxSettingOnlyPolicy é necessário para recuperar essas diretivas. Os atributos das diretivas de endereço de email que contiverem apenas a configuração de gerenciamento de caixa de correio não poderão ser modificados no Exchange 2007. Essas diretivas só podem ser removidas.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

O código a seguir é um exemplo do comando Get-EmailAddressPolicy, que é usado para recuperar os atributos de "Diretiva de Endereço de Email 1".

Get-EmailAddressPolicy -Identity "Email Address Policy 1"