New-DynamicDistributionGroup (RTM)
Aplica-se a: Exchange Server 2007
Tópico modificado em: 2007-10-23
Use o cmdlet New-DynamicDistributionGroup para criar um novo grupo dinâmico de distribuição.
Sintaxe
New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> -OrganizationalUnit <OrganizationalUnitIdParameter> [-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>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]
New-DynamicDistributionGroup -Name <String> -OrganizationalUnit <OrganizationalUnitIdParameter> -RecipientFilter <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]
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:
|
OrganizationalUnit |
Necessário |
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. |
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:
RecipientFilter usa a sintaxe 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 |
System.String |
O parâmetro ConditionalCustomAttribute1 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute10 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute10 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute11 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute11 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute12 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute12 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute13 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute13 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute14 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute14 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute15 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute15 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute2 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute2 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute3 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute3 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute4 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute4 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute5 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute5 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute6 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute6 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute7 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute7 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute8 |
Opcional |
System.String |
O parâmetro ConditionalCustomAttribute8 especifica atributos personalizados. Você pode usar esses atributos para armazenar informações adicionais. |
ConditionalCustomAttribute9 |
Opcional |
System.String |
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. |
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. |
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. |
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"