New-DynamicDistributionGroup (RTM)
适用于： Exchange Server 2007
上一次修改主题： 2007-10-23
使用 New-DynamicDistributionGroup cmdlet 新建动态通讯组。
语法
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>]
详细说明
动态通讯组可以查询 Active Directory 目录服务已启用邮件的对象，并根据结果构建组成员身份。只要向组发送电子邮件，就会重新计算组成员身份。Exchange 提供的查询筛选器仅限于下列参数的任意组合：
ConditionalCompany
ConditionalCustomAttribute N（其中 N 是介于 1 到 15 之间的值）
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients
还可以使用 RecipientFilter 参数创建任何自定义查询。
若要运行 New-DynamicDistributionGroup cmdlet，必须为您使用的帐户委派下列角色：
- Exchange 收件人管理员角色
有关管理 Microsoft Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。
参数
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
IncludedRecipients |
必需 |
System.Nullable |
IncludedRecipients 参数可筛选用于构建动态通讯组的收件人类型。如果指定了 RecipientFilter 参数，则不能使用 IncludedRecipients 参数。 IncludedRecipients 参数的可用值为 AllRecipients、MailboxUsers、Resources、MailContacts、MailGroups、Mail Users 和 None。 AllRecipients 只能单独使用。当 IncludedRecipients 的多个值使用逗号分隔时，将应用 OR 布尔运算符。 |
Name |
必需 |
System.String |
Name 参数指定动态通讯组的名称。如果未指定 DisplayName 参数，则 Name 的值也用于 DisplayName。 Name 值不能超过 64 个字符。 如果 Name 和 DisplayName 的值不同：
|
OrganizationalUnit |
必需 |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
OrganizationalUnit 参数使用规范名称语法，指定在 Active Directory 中的哪个位置创建动态通讯组。 |
RecipientFilter |
必需 |
System.String |
RecipientFilter 参数可筛选用于构建动态通讯组的已启用邮件的收件人。如果指定了下列任意参数，则不能使用 RecipientFilter：
RecipientFilter 使用 有关可筛选属性的详细信息，请参阅 -RecipientFilter 参数的可筛选属性。 |
Alias |
可选 |
System.String |
Alias 参数指定动态通讯组的别名。Alias 的值用于生成动态通讯组的主简单邮件传输协议 (SMTP) 电子邮件地址Alias 值不能包含空格。如果未指定 Alias 参数，则 Name 参数的值用作 Alias 参数的值，其中 Name 参数中的所有空格将转换为下划线字符 (_)。 |
ConditionalCompany |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCompany 参数可筛选用于构建动态通讯组的邮箱用户或已启用邮件的联系人。 当 ConditionalCompany 参数的多个值用逗号分隔时，将应用 OR 布尔运算符。 |
ConditionalCustomAttribute1 |
可选 |
System.String |
ConditionalCustomAttribute1 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute10 |
可选 |
System.String |
ConditionalCustomAttribute10 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute11 |
可选 |
System.String |
ConditionalCustomAttribute11 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute12 |
可选 |
System.String |
ConditionalCustomAttribute12 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute13 |
可选 |
System.String |
ConditionalCustomAttribute13 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute14 |
可选 |
System.String |
ConditionalCustomAttribute14 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute15 |
可选 |
System.String |
ConditionalCustomAttribute15 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute2 |
可选 |
System.String |
ConditionalCustomAttribute2 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute3 |
可选 |
System.String |
ConditionalCustomAttribute3 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute4 |
可选 |
System.String |
ConditionalCustomAttribute4 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute5 |
可选 |
System.String |
ConditionalCustomAttribute5 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute6 |
可选 |
System.String |
ConditionalCustomAttribute6 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute7 |
可选 |
System.String |
ConditionalCustomAttribute7 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute8 |
可选 |
System.String |
ConditionalCustomAttribute8 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute9 |
可选 |
System.String |
ConditionalCustomAttribute9 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalDepartment |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalDepartment 参数可筛选用于构建动态通讯组的邮箱用户或已启用邮件的联系人。如果指定了 RecipientFilter 参数，则不能使用 ConditionalDepartment。 ConditionalDepartment 的多个值使用逗号分隔时，适用 OR 布尔运算符。 |
ConditionalStateOrProvince |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalStateOrProvince 参数可筛选用于构建动态通讯组的邮箱用户或已启用邮件的联系人。如果指定了 RecipientFilter 参数，则不能使用 ConditionalStateOrProvince。 ConditionalStateOrProvince 的多个值使用逗号分隔时，适用 OR 布尔运算符。 |
DisplayName |
可选 |
System.String |
DisplayName 参数指定 Exchange 管理控制台和 Exchange 全局地址列表 (GAL) 中动态通讯组的名称。如果未指定 DisplayName 参数，则 Name 参数的值用于 DisplayName。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
若要指定将此配置更改写入 Active Directory 域控制器的完全限定的域名 (FQDN)，请包含 DomainController 参数。 |
RecipientContainer |
可选 |
Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter |
RecipientContainer 参数根据在 Active Directory 中的位置筛选用于构建动态通讯组的收件人。RecipientContainer 的值可以是组织单位 (OU) 或域的规范名称。如果未指定 RecipientContainer 的值，则默认搜索筛选器是动态通讯组在 Active Directory 中的位置。该位置通过使用 OrganizationalUnit 参数指定。 |
TemplateInstance |
可选 |
System.Management.Automation.PSObject |
为 TemplateInstance 参数提供现有的对象时，命令将使用该对象的配置来创建对象的副本。 |
输入类型
返回类型
错误
| 错误 | 说明 |
|---|---|
|
|
异常
| 异常 | 说明 |
|---|---|
|
|
示例
以下代码示例显示如何使用 New-DynamicDistributionGroup 命令。
第一个示例在 Contoso.com 域的用户容器内创建名为 Marketing Group 的新动态通讯组。Marketing Group 动态通讯组包含在 Contoso.com 域中的任何位置发现的、其“部门”字段中包含“Marketing”或“Sales”的所有邮箱用户或已启用邮件的联系人。
第二个示例使用 RecipientFilter 参数在 Contoso.com 域的用户容器中创建名为 Pacific Northwest 的动态通讯组。Pacific Northwest 动态通讯组包含在 Contoso.com 域中的任何位置发现的、其“省/市/自治区”字段中包含“Washington”或“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"