Compartilhar via

Remove-DistributionGroupMember (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-06-05

Use o cmdlet Remove-DistributionGroupMember para remover um destinatário existente de um grupo de distribuição.

Sintaxe

Remove-DistributionGroupMember -Identity <DistributionGroupIdParameter> -Member <GeneralRecipientIdParameter> [-DomainController <Fqdn>]

Descrição detalhada

Você pode usar o cmdlet Remove-DistributionGroupMember para remover um destinatário existente de um grupo de distribuição ou um grupo de segurança habilitado para email. Você não pode usar o cmdlet Remove-DistributionGroupMember para remover um destinatário de um grupo dinâmico de distribuição. Um grupo dinâmico de distribuição consulta os objetos habilitados para email do Microsoft Active Directory e cria a associação de grupo com base nos resultados. A associação de grupo é recalculada sempre que uma mensagem de email é enviada ao grupo.

Para executar o cmdlet Remove-DistributionGroupMember, 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 modificar. O parâmetro Identity pode obter qualquer um dos seguintes valores para o grupo de distribuição:

  • Nome distinto (DN)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • Alias

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

Member

Necessário

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

Esse parâmetro especifica o destinatário que você deseja remover do grupo de distribuição. O parâmetro Member pode assumir qualquer um dos seguintes valores para o destinatário:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • Alias

  • DN Herdado do Exchange

  • Endereço de email 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-DistributionGroupMember para remover Ted Bremer do grupo de distribuição chamado Suporte Técnico.

Remove-DistributionGroupMember -Identity "Technical Support" -Member "Ted Bremer"