New-DynamicDistributionGroup

 

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

Tópico modificado em: 2009-05-12

Use o cmdlet New-DynamicDistributionGroup para criar um novo grupo dinâmico de distribuição.

Sintaxe

New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> [-Alias <String>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-DynamicDistributionGroup -Name <String> -RecipientFilter <String> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

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 ao grupo. Os filtros de consulta fornecidos com o Exchange são limitados a qualquer combinação dos seguintes parâmetros:

  • ConditionalCompany

  • ConditionalCustomAttribute N (em que N é um valor de 1 a 15)

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

Também é possível criar uma consulta personalizada usando o parâmetro RecipientFilter.

Para executar o cmdlet New-DynamicDistributionGroup, você deve usar uma conta à qual esteja delegada 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

IncludedRecipients

Necessário

System.Nullable

O parâmetro IncludedRecipients filtra os tipos de destinatários usados para criar o grupo dinâmico de distribuição. O parâmetro IncludedRecipients não poderá ser usado se o parâmetro RecipientFilter estiver especificado.

Os valores disponíveis do parâmetro IncludedRecipients são AllRecipients, MailboxUsers, Resources, MailContacts, MailGroups, Mail Users e None.

AllRecipients pode ser usado apenas por ele próprio. Quando vários valores de IncludedRecipients estiverem separados por vírgulas, o operador Booleano OR será aplicado.

Name

Necessário

System.String

O parâmetro Name especifica o nome do grupo dinâmico de distribuição. Se o parâmetro DisplayName não for especificado, o valor de Name também será usado para DisplayName.

O valor Name não pode exceder 64 caracteres.

Se os valores de Name e DisplayName forem diferentes:

  • Name especifica o nome do grupo dinâmico 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.

  • DisplayName especifica o nome do grupo dinâmico de distribuição no Console de Gerenciamento do Exchange e na GAL (lista de endereços global) do Exchange.

RecipientFilter

Necessário

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 nenhum dos parâmetros a seguir for especificado:

  • IncludedRecipients

  • ConditionalCompany

  • ConditionalCustomAttribute N (em que N é um valor de 1 a 15)

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

Alias

Opcional

System.String

O parâmetro Alias especifica o alias do grupo dinâmico de distribuição. O valor de Alias é usado para gerar o endereço de email SMTP principal para o grupo dinâmico de distribuição. O valor de Alias não pode conter espaços. Se o parâmetro Alias não for especificado, o valor do parâmetro Name será usado para o valor do parâmetro Alias, com qualquer espaço no parâmetro Name convertido em caracteres de sublinhado (_).

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.

ConditionalCustomAttribute1

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute10

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute11

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute12

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute13

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute14

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute15

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute2

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute3

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute4

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute5

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute6

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute7

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute8

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

ConditionalCustomAttribute9

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

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. ConditionalDepartment não poderá ser usado se o parâmetro RecipientFilter estiver especificado.

Quando vários valores de ConditionalDepartment estiverem separados por vírgulas, o operador Booleano OR será aplicado.

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. ConditionalStateOrProvince não poderá ser usado se o parâmetro RecipientFilter estiver especificado.

Quando vários valores de ConditionalStateOrProvince estiverem separados por vírgulas, o operador Booleano OR será aplicado.

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.

DisplayName

Opcional

System.String

O parâmetro DisplayName especifica o nome do grupo dinâmico de distribuição no Console de Gerenciamento do Exchange e na GAL (lista de endereços global) do Exchange. Se o parâmetro DisplayName não for especificado, o valor do parâmetro Name será usado para DisplayName.

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.

OrganizationalUnit

Opcional

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

O parâmetro OrganizationalUnit especifica onde criar o grupo dinâmico de distribuição no Active Directory com a sintaxe de nome canônico.

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 você não especificar um valor para RecipientContainer, o filtro de pesquisa padrão será o local do grupo dinâmico de distribuição no Active Directory. Esse local é especificado com o parâmetro OrganizationalUnit.

TemplateInstance

Opcional

System.Management.Automation.PSObject

Quando um objeto existente for fornecido para o parâmetro TemplateInstance, o comando usará a configuração desse objeto para criar uma cópia do objeto.

UseRusServer

Opcional

System.String

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

O parâmetro UseRusServer instrui o comando a utilizar o servidor de Caixa de Correio especificado no serviço Lista de Endereços em execução, a fim de obter e então definir a caixa de correio e os atributos de usuário Active Directory.

O serviço Lista de Endereços é um componente do serviço Assistente do Sistema Exchange. O serviço Lista de Endereços cria e mantém valores de atributo 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 na 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á visualizar 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

Os exemplos de código a seguir mostram como usar o comando New-DynamicDistributionGroup.

O primeiro exemplo cria um novo grupo dinâmico de distribuição que é chamado de Marketing Group no contêiner Usuários no domínio Contoso.com. O grupo dinâmico de distribuição "Marketing Group" contém todos os usuários de caixa de correio ou os contatos habilitados para email encontrados em qualquer lugar no domínio Contoso.com que tenham um campo Departamento que contém "Marketing" ou "Sales".

O segundo exemplo usa o parâmetro RecipientFilter para criar um grupo dinâmico de distribuição chamado "Pacific Northwest" no contêiner Usuários no domínio Contoso.com. O grupo dinâmico de distribuição "Pacific Northwest" contém todos os usuários de caixa de correio encontrados em qualquer lugar no domínio Contoso.com que tenham um campo Estado/Província que contém "Washington" ou "Oregon".

New-DynamicDistributionGroup -Name "Marketing Group" -Alias "Marketing_Group" -IncludedRecipients "MailboxUsers,MailContacts" -OrganizationalUnit "Contoso.com/Users" -ConditionalDepartment "Marketing","Sales" -RecipientContainer "Contoso.com"
New-DynamicDistributionGroup -Name "Pacific Northwest" -Alias "Pacific_Northwest" -OrganizationalUnit "Contoso.com/Users" -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington' -or StateOrProvince -eq 'Oregon')))} -RecipientContainer "Contoso.com"