Update-AddressList
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-AddressList para atualizar os destinatários incluídos na lista de endereços especificada.
Sintaxe
update-AddressList -Identity <AddressListIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Descrição detalhada
Para executar o cmdlet Update-AddressList, você deve usar uma conta à qual esteja delegada o seguinte:
- Função de 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.
Esse comando pode demorar algumas horas para ser concluído, dependendo do tamanho da organização do Exchange.
Parâmetros
| Parâmetro | Necessário | Tipo | Descrição | ||
|---|---|---|---|---|---|
Identity |
Necessário |
Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter |
Utilize o parâmetro Identity para especificar a GUID, o nome distinto ou o nome da lista de endereços que representa uma lista específica de endereços. Você também pode incluir o caminho utilizando o formato Path\AddressListName. Você pode omitir o rótulo do parâmetro Identity para que somente o nome da lista de endereços 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 |
Esse parâmetro especifica o controlador de domínio a ser usado para fazer as modificações nos destinatários incluídos na lista de endereços do Active Directory. |
||
UseRusServer |
Opcional |
System.String |
O parâmetro UseRusServer instrui o comando a usar o servidor Caixa de Correio especificado no qual 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 do serviço Atendedor do Sistema do Exchange. O serviço Lista de Endereços cria e mantém valores de atributo específicos do Exchange no Active Directory. O serviço Lista de Endereços pode ser usado para atualizar objetos de destinatário em um domínio usando informações específicas, como a associação na 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. |
.gif "note")
Observação:Tipos de entrada
Tipos de retorno
Erros
| Erro | Descrição |
|---|---|
|
|
Exceções
| Exceções | Descrição |
|---|---|
|
|
Exemplo
O exemplo a seguir mostra como atualizar os destinatários da lista de endereços chamada "building4" e no contêiner All Users\Sales.
Update-AddressList -Identity "All Users\Sales\building4"
Use o cmdlet Get-AddressList, canalizado para Format-List, para obter a GUID, o nome distinto, ou o caminho e o nome de uma lista de endereços existente. Ou use Get-AddressList para obter uma lista de endereços existente específica e, em seguida, canalize a saída diretamente para Update-AddressList.