Remove-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 comando Remove-AddressList para remover uma lista de endereços existente.

Sintaxe

Remove-AddressList -Identity <AddressListIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Recursive <SwitchParameter>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet Remove-AddressList, 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(s)	Tipo	Descrição
Identity	Necessário(s)	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	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 remover a lista de endereços do serviço de diretório do Active Directory.
Recursive	Opcional	System.Management.Automation.SwitchParameter	Este parâmetro especifica se o comando removerá todas as listas de endereços filhas da lista de endereços especificada pelo parâmetro Identity. Se você não especificar esse parâmetro e a lista de endereços a ser removida tiver listas de endereços filhas, ocorrerá falha no 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 a utilizar o servidor de Caixa de Correio especificado no serviço Lista de Endereços em execução, a fim de obter e então definir a caixa de correio e os atributos de usuário Active Directory. O serviço Lista de Endereços é um componente do serviço Assistente do Sistema Exchange. O serviço Lista de Endereços cria e mantém valores de atributo 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 na lista de endereços e endereços de email.
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

Exceções

Exemplo

O exemplo a seguir mostra como remover uma lista de endereços com o nome "Address_List_1" e todas as respectivas listas de endereços filhas.

Remove-AddressList -Identity "Address_List_1" -Recursive

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, depois, canalize a saída diretamente para Remove-AddressList.