Compartilhar via

Set-DynamicDistributionGroup (RTM)

  • Artigo

 

Aplica-se a: Exchange Server 2007

Tópico modificado em: 2007-10-23

Use o cmdlet Set-DynamicDistributionGroup para modificar as definições de um grupo dinâmico de distribuição existente.

Sintaxe

Set-DynamicDistributionGroup -Identity <DynamicGroupIdParameter> [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-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>] [-ForceUpgrade <SwitchParameter>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IncludedRecipients <Nullable>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-RecipientFilter <String>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-WindowsEmailAddress <SmtpAddress>]

Set-DynamicDistributionGroup [-AcceptMessagesOnlyFrom <RecipientIdParameter[]>] [-AcceptMessagesOnlyFromDLMembers <RecipientIdParameter[]>] [-Alias <String>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-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>] [-ForceUpgrade <SwitchParameter>] [-GrantSendOnBehalfTo <MailboxOrMailUserIdParameter[]>] [-HiddenFromAddressListsEnabled <$true | $false>] [-IncludedRecipients <Nullable>] [-Instance <DynamicDistributionGroup>] [-ManagedBy <GeneralRecipientIdParameter>] [-MaxReceiveSize <Unlimited>] [-MaxSendSize <Unlimited>] [-Name <String>] [-Notes <String>] [-PhoneticDisplayName <String>] [-PrimarySmtpAddress <SmtpAddress>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-RecipientFilter <String>] [-RejectMessagesFrom <RecipientIdParameter[]>] [-RejectMessagesFromDLMembers <RecipientIdParameter[]>] [-ReportToManagerEnabled <$true | $false>] [-ReportToOriginatorEnabled <$true | $false>] [-RequireSenderAuthenticationEnabled <$true | $false>] [-SendOofMessageToOriginatorEnabled <$true | $false>] [-SimpleDisplayName <String>] [-UMDtmfMap <MultiValuedProperty>] [-WindowsEmailAddress <SmtpAddress>]

Descrição detalhada

Um grupo dinâmico de distribuição consulta os objetos habilitados para email do serviço de diretório do Active Directory e cria a associação de grupos com base nos resultados. A associação de grupos é recalculada sempre que uma mensagem de email é enviada a um grupo. Você pode usar Set-DynamicDistributionGroup para substituir definições existentes ou para adicionar novas definições.

Para executar o cmdlet Set-DynamicDistributionGroup, você deve usar uma conta à qual esteja delegada a seguinte função:

  • 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 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.DynamicGroupIdParameter

O parâmetro Identity identifica o objeto a ser modificado. O parâmetro Identity pode aceitar qualquer um dos seguintes valores para o objeto do grupo dinâmico de distribuição:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • Alias

  • DN Herdado do Exchange

  • Endereço de email 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 para esse grupo de distribuição. O parâmetro AcceptMessagesOnlyFrom pode obter qualquer um dos seguintes valores para os remetentes válidos:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • Alias

  • DN do Exchange

  • Endereço de email SMTP principal

Por padrão, esse parâmetro fica em branco. Esse valor padrão 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.

AcceptMessagesOnlyFromDLMembers

Opcional

Microsoft.Exchange.Configuration.Tasks.RecipientIdParameter[]

O parâmetro AcceptMessagesOnlyFromDLMembers especifica os grupos de distribuição 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 grupos de distribuição permitidos:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • DN Herdado do Exchange

  • Endereço de email SMTP principal.

Por padrão, esse parâmetro fica em branco. Esse valor padrão permite que o grupo de distribuição aceite mensagens de todos os grupos de distribuição.

Alias

Opcional

System.String

O parâmetro Alias especifica o alias do objeto. O valor de Alias não pode conter espaços.

ConditionalCompany

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalCompany filtra os usuários da caixa de correio ou os contatos habilitados para email usados para criar o grupo dinâmico de distribuição.

Quando vários valores do parâmetro ConditionalCompany são separados por vírgulas, o operador Booleano OR é aplicado. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute1

Opcional

System.String

O parâmetro ConditionalCustomAttribute1 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute10

Opcional

System.String

O parâmetro ConditionalCustomAttribute10 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute11

Opcional

System.String

O parâmetro ConditionalCustomAttribute11 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute12

Opcional

System.String

O parâmetro ConditionalCustomAttribute12 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute13

Opcional

System.String

O parâmetro ConditionalCustomAttribute13 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute14

Opcional

System.String

O parâmetro ConditionalCustomAttribute14 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute15

Opcional

System.String

O parâmetro ConditionalCustomAttribute15 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute2

Opcional

System.String

O parâmetro ConditionalCustomAttribute2 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute3

Opcional

System.String

O parâmetro ConditionalCustomAttribute3 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute4

Opcional

System.String

O parâmetro ConditionalCustomAttribute4 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute5

Opcional

System.String

O parâmetro ConditionalCustomAttribute5 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute6

Opcional

System.String

O parâmetro ConditionalCustomAttribute6 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute7

Opcional

System.String

O parâmetro ConditionalCustomAttribute7 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute8

Opcional

System.String

O parâmetro ConditionalCustomAttribute8 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalCustomAttribute9

Opcional

System.String

O parâmetro ConditionalCustomAttribute9 especifica atributos personalizados condicionais. Você pode usar esses atributos para armazenar informações adicionais. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalDepartment

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalDepartment filtra os usuários da caixa de correio ou os contatos habilitados para email usados para criar o grupo dinâmico de distribuição.

Quando vários valores do parâmetro ConditionalDepartment são separados por vírgulas, o operador Booleano OR é aplicado. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

ConditionalStateOrProvince

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

O parâmetro ConditionalStateOrProvince filtra os usuários da caixa de correio ou os contatos habilitados para email usados para criar o grupo dinâmico de distribuição.

Quando vários valores do parâmetro ConditionalStateOrProvince são separados por vírgulas, o operador Booleano OR é aplicado. Use o parâmetro IncludedRecipients caso utilize um parâmetro Conditional. Você não poderá usar este parâmetro se usar o parâmetro RecipientFilter.

CreateDTMFMap

Opcional

System.Boolean

Esse parâmetro determina a criação de um mapa de multifreqüência de tom dual (DTMF) para o grupo dinâmico 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 especifica 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 especifica os endereços de email do grupo de distribuição. Todos os tipos de endereços de email do Microsoft Exchange Server 2007 são válidos. Você pode especificar vários valores para o parâmetro EmailAddresses. Separe vários valores por vírgulas.

EmailAddressPolicyEnabled

Opcional

System.Boolean

O parâmetro EmailAddressPolicyEnabled controla a aplicação de diretivas de endereços 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 aplicáveis se referem a este grupo de distribuição.

ExpansionServer

Opcional

System.String

O parâmetro ExpansionServer especifica o servidor Exchange para expandir o grupo de distribuição. Insira o servidor de expansão como um valor de Legacy Exchange DN. 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 Transporte de Hub esteja instalada.

ForceUpgrade

Opcional

System.Management.Automation.SwitchParameter

O parâmetro ForceUpgrade suprime a seguinte confirmação: “Para que as alterações feitas no objeto possam ser salvas, o objeto deve ser atualizado para a versão atual do Exchange. Após a atualização, o objeto não pode ser gerenciado por uma versão anterior do Gerenciador do Sistema do Exchange. Deseja continuar a atualizar e salvar o objeto?” Essa confirmação ocorre quando você atualiza um grupo dinâmico de distribuição criado no Microsoft Exchange Server 2003 ou no Exchange 2000 Server. Você não pode gerenciar um grupo dinâmico de distribuição do Exchange 2003 ou do Exchange 2000 usando o Console de Gerenciamento do Exchange antes de atualizar a versão do objeto e alterar o filtro de destinatário com o parâmetro RecipientFilter ou   IncludedRecipients.

GrantSendOnBehalfTo

Opcional

Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter[]

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

  • DN (nome distinto)

  • GUID

  • Name

  • Nome para exibição

  • Nome canônico

  • DN Herdado do Exchange

  • Alias

  • Endereço de email SMTP principal

Por padrão, o parâmetro GrantSendOnBehalfTo está 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 oculta o grupo de distribuição de todas as listas de endereços do Exchange. Os valores válidos são $true ou $false. O valor padrão é $false.

IncludedRecipients

Opcional

System.Nullable

O parâmetro IncludedRecipients filtra os tipos de destinatários usados para criar o grupo dinâmico de distribuição. Os valores disponíveis para o parâmetro IncludedRecipients são AllRecipients, MailboxUsers, Resources, MailContacts e MailGroups.

O valor AllRecipients pode ser usado somente por você mesmo. Quando vários valores do parâmetro IncludedRecipients são separados por vírgulas, o operador Booleano OR é aplicado.

Instance

Opcional

Microsoft.Exchange.Data.Directory.Management.DynamicDistributionGroup

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 dinâmico 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.

Anotações

Opcional

System.String

O parâmetro Notes especifica comentários sobre o grupo de distribuição.

PhoneticDisplayName

Opcional

System.String

O parâmetro PhoneticDisplayName especifica uma pronúncia fonética do parâmetro DisplayName.

O tamanho máximo desse valor de parâmetro é 255 caracteres. Para obter mais informações sobre o parâmetro PhoneticDisplayName e reconhecimento de fala, consulte Compreendendo pesquisas de diretório de Reconhecimento Automático de Fala.

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 somente se o grupo de distribuição tiver vários endereços de email SMTP.

RecipientContainer

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

O parâmetro RecipientContainer filtra os destinatários usados para criar o grupo dinâmico de distribuição com base em seus locais no Active Directory. O valor de RecipientContainer pode ser o nome canônico de uma unidade organizacional (UO) ou de um domínio. Se um valor para RecipientContainer não for especificado, o filtro de pesquisa padrão será o local do grupo dinâmico de distribuição no Active Directory.

RecipientFilter

Opcional

System.String

O parâmetro RecipientFilter filtra os destinatários habilitados para email usados para criar o grupo dinâmico de distribuição. RecipientFilter não poderá ser usado se algum dos parâmetros a seguir for especificado:

  • IncludedRecipients

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateorProvince

RecipientFilter usa a sintaxe OPath para consultar o Active Directory e filtrar destinatários. Para obter mais informações sobre as propriedades filtráveis, consulte Propriedades filtráveis do parâmetro -RecipientFilter.

RecipientFilter pode usar qualquer combinação dos seguintes tipos de objeto como filtros:

  • RecipientType

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateorProvince

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 esse grupo de distribuição. Você pode usar qualquer um dos seguintes valores para os remetentes proibidos:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

Por padrão, esse parâmetro fica em branco. Esse valor padrão 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:

  • DN (nome distinto)

  • Nome canônico

  • GUID

  • Name

  • Nome para exibição

  • DN Herdado do Exchange

  • Endereço de email SMTP principal

Por padrão, esse parâmetro fica em branco. Esse valor padrão 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 gerente 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 o envio de notificações de entrega ao remetente de mensagens de email enviadas a esse 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. Os valores válidos são $true ou $false. O valor padrão é $true. Se o valor for $true, as mensagens serão aceitas apenas de remetentes autenticados.

SendOofMessageToOriginatorEnabled

Opcional

System.Boolean

O parâmetro SendOofMessageToOriginatorEnabled permite o envio de mensagens de ausência temporária ao remetente de mensagens de email enviadas para esse 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 em caracteres ASCII de 26 a 126, inclusive.

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 dinâmico de distribuição habilitado para UM. 

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-DynamicDistributionGroup para aplicar as seguintes alterações a um grupo dinâmico de distribuição existente, chamado "Developers":

  • Altere o filtro de consulta ConditionalCompany para Contoso.

  • Altere o filtro de consulta IncludedRecipients para MailboxUsers.

  • Adicione um valor Custom Attribute 1 igual a "Internal".

Set-DynamicDistributionGroup -Identity "Developers" -ConditionalCompany "Contoso" -IncludedRecipients MailboxUsers -ConditionalCustomAttribute1 "Internal"