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 个字符。

如果 NameDisplayName 的值不同:

  • Name 指定 Active Directory 用户和计算机中以及 Exchange 管理控制台的“组名”字段中的动态通讯组名称。

  • DisplayName 指定 Exchange 管理控制台和 Exchange 全局地址列表 (GAL) 中的动态通讯组名称。

OrganizationalUnit

必需

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 参数使用规范名称语法,指定在 Active Directory 中的哪个位置创建动态通讯组。

RecipientFilter

必需

System.String

RecipientFilter 参数可筛选用于构建动态通讯组的已启用邮件的收件人。如果指定了下列任意参数,则不能使用 RecipientFilter

  • IncludedRecipients

  • ConditionalCompany

  • ConditionalCustomAttribute N(其中 N 是介于 1 到 15 之间的值)

  • ConditionalDepartment

  • ConditionalStateOrProvince

RecipientFilter 使用 OPath 语法查询 Active Directory 和筛选收件人。

有关可筛选属性的详细信息,请参阅 -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"