Update-EmailAddressPolicy

 

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	Observaçã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