Update-EmailAddressPolicy

  • 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 Update-EmailAddressPolicy para aplicar uma diretiva de endereço de email a todos os destinatários.

Sintaxe

update-EmailAddressPolicy -Identity <EmailAddressPolicyIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-FixMissingAlias <SwitchParameter>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Update-EmailAddressPolicy permite que os administradores apliquem uma diretiva de endereço de email a todos os destinatários. Esse comando realiza uma consulta de todos os destinatários que correspondem à diretiva de endereço de email especificada e salva os objetos no serviço de diretório do Active Directory. Use o cmdlet Update-EmailAddressPolicy após utilizar o cmdlet Set-EmailAddressPolicy para aplicar todas as alterações.

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

  • Função Administrador do Exchange Server e grupo Administradores local para o 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.

Para obter mais informações sobre o cmdlet Set-EmailAddressPolicy, consulte Set-EmailAddressPolicy.

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter

Use o parâmetro Identity para especificar a GUID, o nome distinto ou o nome da diretiva de endereço de email que representa uma diretiva de endereço de email 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 seja fornecido.

Confirm

Optional

System.Management.Automation.SwitchParameter

O parâmetro Confirm faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

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 Active Directory, inclua o parâmetro DomainController no comando.

FixMissingAlias

Optional

System.Management.Automation.SwitchParameter

Use o parâmetro FixMissingAlias para reparar destinatários que não possuem um alias. O alias é gerado com base no nome do destinatário. Será necessário usar o parâmetro FixMissingAlias se você receber uma mensagem de erro ao tentar atualizar uma diretiva de endereçamento de email, lista de endereços global ou lista de endereços.

UseRusServer

Opcional

System.String
noteObservação:
Esse parâmetro está disponível somente no Exchange 2007 SP2.

O parâmetro UseRusServer instrui o comando para usar o servidor de Caixa de Correio especificado em que o serviço Lista de Endereços está sendo executado para obter e definir atributos de caixa de correio e de usuário do Active Directory.

O serviço Lista de Endereços é um componente no serviço Atendedor do Sistema Exchange. Esse serviço cria e mantém valores de atributos específicos do Exchange no Active Directory. Você pode usar o serviço Lista de Endereços para atualizar objetos de destinatário em um domínio usando informações específicas, como associação da lista de endereços e endereços de email.

WhatIf

Optional

System.Management.Automation.SwitchParameter

O parâmetro WhatIf instrui o comando a simular as ações que ele executará no objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar nenhum valor com o parâmetro WhatIf.

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 Update-EmailAddressPolicy. Esse exemplo aplica a diretiva de endereço de email denominada EMAIL_ADDRESS_POLICY01 a todos os destinatários afetados.

Update-EmailAddressPolicy -Identity EMAIL_ADDRESS_POLICY01