Update-GlobalAddressList

 

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-GlobalAddressList para atualizar uma GAL (lista de endereços global).

Sintaxe

update-GlobalAddressList -Identity <GlobalAddressListIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet Update-GlobalAddressList, você deve usar uma conta à qual esteja delegado o seguinte:

• Função Administrador da Organizaçã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
Identity	Necessário	Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter	O parâmetro Identity especifica um identificador exclusivo da GAL que está sendo atualizada. Esses identificadores exclusivos incluem o CN (nome comum), a GUID ou o DN (nome distinto).
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	O parâmetro DomainController especifica o controlador de domínio a ser usado pelo comando.
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 um valor com o parâmetro WhatIf.

Tipos de entrada

Tipos de retorno

Erros

Erro	Descrição

Exceções

Exceções	Descrição

Exemplo

A seguir, é exibido um exemplo do comando Update-GlobalAddressList.

Neste exemplo, as propriedades de filtro do objeto GlobalAddressList com o CN, a GUID ou o DN igual a <GALIdentity1> são alteradas para o valor especificado. Todos os destinatários correspondentes também são atualizados.

Update-GlobalAddressList -Identity <GALIdentity1> -BaseFilter <OpathFilter>