Add-DistributionGroupMember

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-06-22

Use o cmdlet Add-DistributionGroupMember para adicionar um destinatário a um grupo de distribuição.

Sintaxe

Add-DistributionGroupMember -Identity <DistributionGroupIdParameter> -Member <RecipientIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

Para executar o cmdlet Add-DistributionGroupMember, você deve usar a conta à qual estejam delegadas as seguintes funções:

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

  • Função 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 Microsoft 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 do grupo de distribuição aceita um dos seguintes formatos:

  • GUID

  • nome distinto

  • UPN

  • LegacyExchangeDN

  • Domínio\NomedaConta

  • Alias

Member

Necessário

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

O parâmetro Member especifica o destinatário a ser adicionado ao grupo de distribuição de uma das seguintes formas:

  • GUID

  • nome distinto

  • UPN

  • LegacyExchangeDN

  • Domínio\NomedaConta

  • Endereço SMTP

Confirm

Optional

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

Optional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado do controlador de domínio que grava essa alteração de configuração no Active Directory, inclua o parâmetro DomainController no comando. O parâmetro DomainController não tem suporte em computadores que executam a função de servidor Transporte de Borda. A função de servidor Transporte de Borda grava apenas para a instância ADAM local.

WhatIf

Optional

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 comando a seguir adicionar Ted Bremer ao grupo de distribuição, Staff.

Add-DistributionGroupMember  -Identity "Staff"  -Member "TedBrem@contoso.com"