Set-DistributionGroup

 

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

Tópico modificado em: 2010-10-20

Use o cmdlet Set-DistributionGroup para modificar as configurações de um grupo de distribuição existente.

Sintaxe

Set-DistributionGroup -Identity <DistributionGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-DistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-Confirm [<SwitchParameter>]] [-CreateDTMFMap <$true | $false>] [-CustomAttribute1 <String>] [-CustomAttribute10 <String>] [-CustomAttribute11 <String>] [-CustomAttribute12 <String>] [-CustomAttribute13 <String>] [-CustomAttribute14 <String>] [-CustomAttribute15 <String>] [-CustomAttribute2 <String>] [-CustomAttribute3 <String>] [-CustomAttribute4 <String>] [-CustomAttribute5 <String>] [-CustomAttribute6 <String>] [-CustomAttribute7 <String>] [-CustomAttribute8 <String>] [-CustomAttribute9 <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-EmailAddresses <ProxyAddressCollection>] [-EmailAddressPolicyEnabled <$true | $false>] [-ExpansionServer <String>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IgnoreDefaultScope <SwitchParameter>] [-Instance <DistributionGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SamAccountName <String>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Descrição detalhada

Grupos de distribuição são usados para consolidar grupos de destinatários em um único ponto de contato para mensagens de email. Os grupos de distribuição não podem ser usados para atribuir permissões a recursos de rede no serviço de diretório do Active Directory. Você pode usar o cmdlet Set-DistributionGroup para substituir configurações existentes ou para adicionar novas configurações.

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

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

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 especifica o objeto 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 do Exchange

  • Endereço SMTP principal

O parâmetro Identity não poderá ser usado se o parâmetro Instance estiver especificado.

AcceptMessagesOnlyFrom

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro AcceptMessagesOnlyFrom especifica os usuários da caixa de correio e os contatos habilitados para email que podem enviar mensagens de email a este grupo de distribuição. Também é possível especificar o Microsoft Exchange como um destinatário válido para esse parâmetro. Se você configurar um grupo de distribuição para aceitar mensagens somente do destinatário Exchange da Microsoft, ele somente receberá mensagens geradas pelo sistema.

O parâmetro AcceptMessagesOnlyFrom pode obter qualquer um dos seguintes valores para os remetentes válidos:

  • Nome distinto (DN)

  • Nome canônico

  • GUID

  • Nome

  • Nome para exibição

  • Alias

  • DN do Exchange

  • Endereço de email SMTP principal

Por padrão, o valor desse parâmetro está em branco. Isso permite que o grupo de distribuição aceite mensagens de todos os remetentes.

AcceptMessagesOnlyFromDLMembers

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro AcceptMessagesOnlyFromDLMembers especifica os grupos de distribuição cujos membros têm permissão para enviar mensagens de email a este grupo de distribuição. Você pode usar qualquer um dos seguintes valores para os grupos de distribuição permitidos:

  • Nome distinto (DN)

  • Nome canônico

  • GUID

  • Nome

  • Nome para exibição

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

Por padrão, o valor desse parâmetro está em branco. Isso permite que o grupo de distribuição aceite mensagens de todos os remetentes.

Alias

Opcional

System.String

O parâmetro Alias pode ser usado para especificar o alias do objeto. O valor de Alias não pode conter espaços.

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.

CreateDTMFMap

Opcional

System.Boolean

Esse parâmetro determina a criação de um mapa de multifreqüência de tom dual (DTMF) para o grupo de distribuição.

CustomAttribute1

Opcional

System.String

O parâmetro CustomAttribute1 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute10

Opcional

System.String

O parâmetro CustomAttribute10 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute11

Opcional

System.String

O parâmetro CustomAttribute11 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute12

Opcional

System.String

O parâmetro CustomAttribute12 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute13

Opcional

System.String

O parâmetro CustomAttribute13 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute14

Opcional

System.String

O parâmetro CustomAttribute14 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute15

Opcional

System.String

O parâmetro CustomAttribute15 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute2

Opcional

System.String

O parâmetro CustomAttribute2 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute3

Opcional

System.String

O parâmetro CustomAttribute3 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute4

Opcional

System.String

O parâmetro CustomAttribute4 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute5

Opcional

System.String

O parâmetro CustomAttribute5 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute6

Opcional

System.String

O parâmetro CustomAttribute6 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute7

Opcional

System.String

O parâmetro CustomAttribute7 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute8

Opcional

System.String

O parâmetro CustomAttribute8 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

CustomAttribute9

Opcional

System.String

O parâmetro CustomAttribute9 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais.

DisplayName

Opcional

System.String

O parâmetro DisplayName pode ser usado para especificar o nome do grupo de distribuição no Console de Gerenciamento do Exchange e na GAL (lista de endereços global) do Exchange.

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.

EmailAddresses

Opcional

Microsoft.Exchange.Data.ProxyAddressCollection

O parâmetro EmailAddresses pode ser usado para especificar o alias de email do grupo de distribuição. Todos os tipos de endereço de email do Microsoft Exchange Server 2007 válidos podem ser usados. Você pode especificar vários valores para o parâmetro EmailAddresses, como uma lista delimitada por vírgulas.

Importante

O Exchange 2007 não valida endereços personalizados para a obtenção da formatação correta. Você deve verificar se o endereço personalizado especificado é compatível com os requisitos de formatação desse tipo de endereço. Como os endereços X.400 são considerados endereços personalizados no Exchange 2007, eles também não são validados. Portanto, você deve fornecer a sintaxe correta ao especificar um endereço X.400.

EmailAddressPolicyEnabled

Opcional

System.Boolean

O parâmetro EmailAddressPolicyEnabled pode ser usado para controlar a aplicação de diretivas de endereço de email a este grupo de distribuição. Os valores válidos são $true ou $false. O valor padrão é $true. Por padrão, todas as diretivas de endereço de email aplicavéis se referem a este grupo de distribuição.

ExpansionServer

Opcional

System.String

O parâmetro ExpansionServerespecifica o servidor Exchange usado para expandir o grupo de distribuição. Insira o servidor de expansão como um valor de DN herdado do Exchange. O comportamento padrão é usar o computador com Exchange Server 2003 ou o servidor Exchange 2007 mais próximo em que a função de servidor de Transporte de Hub esteja instalada.

GrantSendOnBehalfTo

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter

O parâmetro GrantSendOnBehalfTo especifica um usuário de caixa de correio que pode enviar em nome deste grupo de distribuição. O parâmetro GrantSendOnBehalfTo pode aceitar qualquer um dos seguintes valores:

  • Nome distinto (DN)

  • GUID

  • Nome

  • Nome para exibição

  • Nome canônico

  • DN Herdado do Exchange

  • Alias

  • Endereço de email SMTP principal

Por padrão, o valor de GrantSendOnBehalfTo fica em branco. Isso significa que nenhum outro usuário da caixa de correio tem permissão para enviar em nome deste grupo de distribuição.

HiddenFromAddressListsEnabled

Opcional

System.Boolean

O parâmetro HiddenFromAddressListsEnabled pode ser usado para ocultar o grupo de distribuição de qualquer lista de endereços do Exchange. Os valores válidos são $true ou $false. O valor padrão é $false.

IgnoreDefaultScope

Opcional

System.Management.Automation.SwitchParameter

O parâmetro IgnoreDefaultScope instrui o comando a ignorar a configuração padrão de escopo do destinatário do Shell de Gerenciamento do Exchange e usar toda a floresta como o escopo. Isso permite que o comando acesse objetos do Active Directory que não estão atualmente no escopo padrão. O uso do parâmetro IgnoreDefaultScope introduz as seguintes restrições:

  • Você não pode usar o parâmetro DomainController. O comando usará automaticamente um servidor de catálogo global adequado.

  • Você pode usar o DN somente para o parâmetro Identity. Outras formas de identificação, como alias ou GUID, não são aceitas.

Instance

Opcional

Microsoft.Exchange.Data.Directory.Management.DistributionGroup

O parâmetro Instance permite que você passe um objeto inteiro para o comando a ser processado. Ele é usado principalmente quando um objeto inteiro deve ser passado para o comando.

O parâmetro Instance não poderá ser usado se o parâmetro Identity estiver especificado.

ManagedBy

Opcional

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

O parâmetro ManagedBy especifica o nome do usuário da caixa de correio, o grupo habilitado para email ou o contato habilitado para email que aparece na guia Gerenciado por do objeto do Active Directory. Você pode usar qualquer um dos valores a seguir para este parâmetro:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

MaxReceiveSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro MaxReceiveSize pode ser usado para definir o tamanho máximo permitido para mensagens de email que podem ser enviadas para este grupo de distribuição. Quando você inserir um valor, qualifique-o com uma das seguintes unidades:

  • B (bytes)

  • KB (quilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Valores não qualificados são tratados como bytes. Os valores válidos são de 0 a 2147482624 bytes.

Por padrão, o parâmetro MaxReceiveSize é definido como unlimited.

MaxSendSize

Opcional

Microsoft.Exchange.Data.Unlimited

O parâmetro MaxSendSize pode ser usado para especificar o tamanho máximo permitido para mensagens de email que podem ser enviadas deste grupo de distribuição. Quando você inserir um valor, qualifique-o com uma das seguintes unidades:

  • B (bytes)

  • KB (quilobytes)

  • MB (megabytes)

  • GB (gigabytes)

  • TB (terabytes)

Valores não qualificados são tratados como bytes. Os valores válidos são de 0 a 2147482624 bytes.

Por padrão, o parâmetro MaxSendSize é definido como unlimited.

Name

Opcional

System.String

O parâmetro Name especifica o nome do grupo de distribuição. O parâmetro Name especifica o nome do grupo de distribuição em Usuários e Computadores do Active Directory e também no campo Nome do Grupo no Console de Gerenciamento do Exchange.

PrimarySmtpAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

O parâmetro PrimarySmtpAddress especifica o endereço de email SMTP de retorno principal para o grupo de distribuição. Esse parâmetro terá significado apenas se o grupo de distribuição tiver vários endereços de email SMTP.

RejectMessagesFrom

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro RejectMessagesFrom especifica os usuários da caixa de correio e os contatos habilitados para email que têm permissão para enviar mensagens de email a este grupo de distribuição. Você pode usar qualquer um dos seguintes valores para os remetentes proibidos:

  • Nome distinto (DN)

  • Nome canônico

  • GUID

  • Nome

  • Nome para exibição

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

Por padrão, o valor desse parâmetro está em branco. Isso permite que o grupo de distribuição aceite mensagens de todos os usuários de caixa de correio e de todos os contatos habilitados para email.

RejectMessagesFromDLMembers

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro RejectMessagesFromDLMembers especifica os grupos de distribuição que não têm permissão para enviar mensagens de email ao grupo de distribuição. Você pode usar qualquer um dos seguintes valores para os grupos de distribuição proibidos:

  • Nome distinto (DN)

  • Nome canônico

  • GUID

  • Nome

  • Nome para exibição

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

Por padrão, o valor desse parâmetro está em branco. Isso permite que o grupo de distribuição aceite mensagens de todos os grupos de distribuição.

ReportToManagerEnabled

Opcional

System.Boolean

O parâmetro ReportToManagerEnabled permite que notificações de entrega sejam enviadas ao gerenciador do grupo de distribuição. Os valores válidos são $true ou $false. O valor padrão é $false.

ReportToOriginatorEnabled

Opcional

System.Boolean

O parâmetro ReportToOriginatorEnabled permite que notificações de entrega sejam enviadas aos remetentes de mensagens de email enviadas a este grupo de distribuição. Os valores válidos são $true ou $false. O valor padrão é $true.

RequireSenderAuthenticationEnabled

Opcional

System.Boolean

O parâmetro RequireSenderAuthenticationEnabled exige a entrega de mensagem de email de remetentes autenticados. Se o valor for $true, apenas as mensagens de remetentes autenticados serão aceitas. Os valores válidos são $true ou $false. O valor padrão é $true.

SamAccountName

Opcional

System.String

O parâmetro SamAccountName especifica o nome para clientes do objeto que estão executando sistemas operacionais mais antigos. O parâmetro SamAccountName é exibido no Active Directory e no Console de Gerenciamento do Exchange no campo Nome do grupo (antes do Windows 2000).

SendOofMessageToOriginatorEnabled

Opcional

System.Boolean

O parâmetro SendOofMessageToOriginatorEnabled permite que mensagens de ausência temporária sejam entregues aos remetentes de mensagens de email enviadas a este grupo de distribuição. Os valores válidos são $true ou $false. O valor padrão é $false.

SimpleDisplayName

Opcional

System.String

O parâmetro SimpleDisplayName é usado para exibir uma descrição alternativa do objeto quando somente um conjunto limitado de caracteres for permitido. Esse conjunto limitado de caracteres consiste nos seguintes caracteres:

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

UMDtmfMap

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica se você deseja criar um mapa de DTMF definido pelo usuário para o grupo de distribuição habilitado para UM. 

UseRusServer

Opcional

System.String

noteObservação:
Esse parâmetro está disponível somente no Exchange 2007 SP2.

O parâmetro UseRusServer instrui o comando para usar o servidor de Caixa de Correio especificado em que o serviço Lista de Endereços está sendo executado para obter e definir atributos de caixa de correio e de usuário do Active Directory.

O serviço Lista de Endereços é um componente no serviço Atendedor do Sistema Exchange. Esse serviço cria e mantém valores de atributos 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 da 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.

WindowsEmailAddress

Opcional

Microsoft.Exchange.Data.SmtpAddress

O parâmetro WindowsEmailAddress especifica o valor do campo Email do objeto do Active Directory.

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 comando Set-DistributionGroup para alterar o nome de exibição de um grupo de distribuição existente, chamado Contabilidade para Grupo de Contabilidade.

Set-DistributionGroup -Identity "Accounting" -DisplayName "Accounting Group"