Compartilhar via


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

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

Erro Descrição

  

Exceções

Exceções Descrição

  

  

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.