Remove-DistributionGroupMember

  • Artigo

 

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 Remove-DistributionGroupMember para remover um destinatário existente de um grupo de distribuição.

Sintaxe

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

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

  • Nome

  • 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

  • Nome

  • Nome para exibição

  • Alias

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

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

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.

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 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"