Compartilhar via

Remove-DistributionGroup (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-05

Use o cmdlet Remove-DistributionGroup para excluir um grupo de distribuição existente do serviço de diretório do Active Directory.

Sintaxe

Remove-DistributionGroup -Identity <DistributionGroupIdParameter> [-DomainController <Fqdn>]

Descrição detalhada

O cmdlet Remove-DistributionGroup exclui um grupo de distribuição existente do serviço de diretório do Active Directory.

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

  • Função Administrador de Destinatários do Exchange

  • Função de Operador de Conta para os contêineres do Active Directory aplicáveis 

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

O parâmetro Identity especifica o grupo de distribuição que você deseja remover. O parâmetro Identity pode obter qualquer um dos seguintes valores para o grupo de distribuição:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • Alias

  • DN Herdado do Exchange

  • Endereço SMTP principal

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O exemplo de código a seguir mostra como usar o cmdlet Remove-DistributionGroup para remover um grupo de distribuição existente chamado Temporary Staff.

Remove-DistributionGroup -Identity "Temporary Staff"