Compartilhar via


Move-AddressList

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-06-28

Use o cmdlet Move-AddressList para mover uma lista de endereços existente para um novo contêiner na lista de endereços raiz.

Sintaxe

Move-AddressList -Identity <AddressListIdParameter> -Target <AddressListIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet Move-AddressList, você deve usar a conta à qual esteja delegada a seguinte função:

  • 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.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.

Target

Necessário

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Este parâmetro especifica o caminho para a lista de endereços pai para a qual você deseja mover esta lista de endereços.

Confirm

Opcional

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

Este parâmetro especifica o controlador de domínio a ser usado para fazer as modificações no caminho da lista de endereços no Active Directory.

WhatIf

Opcional

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

O exemplo a seguir mostra como mover a lista de endereços com a GUID c3fffd8e-026b-41b9-88c4-8c21697ac8ac para um novo local na lista de endereços pai \All Users\Sales\building4.

Move-AddressList -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -Target "\All Users\Sales\building4"

Use o comando Get-AddressList, canalizado para Format-List, para obter a GUID, um 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 Move-AddressList.