New-DynamicDistributionGroup

参考

模块:: ExchangePowerShell

适用于:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。一些参数和设置可能只适用于某个特定的环境。

使用 New-DynamicDistributionGroup cmdlet 创建动态通讯组。动态通讯组查询已启用邮件的对象，并根据结果构建组成员身份。只要向组发送了电子邮件，就会重新计算组成员身份。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

New-DynamicDistributionGroup
   [-Name] <String>
   -IncludedRecipients <WellKnownRecipientType>
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-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]
   [-DirectMembershipOnly <Boolean>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-WhatIf]
   [<CommonParameters>]

New-DynamicDistributionGroup
   [-Name] <String>
   -RecipientFilter <String>
   [-Alias <String>]
   [-ArbitrationMailbox <MailboxIdParameter>]
   [-Confirm]
   [-DirectMembershipOnly <Boolean>]
   [-DisplayName <String>]
   [-DomainController <Fqdn>]
   [-ModeratedBy <MultiValuedProperty>]
   [-ModerationEnabled <Boolean>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-PrimarySmtpAddress <SmtpAddress>]
   [-RecipientContainer <OrganizationalUnitIdParameter>]
   [-SendModerationNotifications <TransportModerationNotificationFlags>]
   [-WhatIf]
   [<CommonParameters>]

说明

与 IncludedRecipients 参数结合使用的 Conditional 参数受到以下限制约束：

EQV 运算符用于每个属性值，如“Department equals Sales”所示。不支持通配符和部分匹配。
OR 运算符始终用于同一个属性的多个值，如“Department equals Sales OR Marketing”所示。
AND 运算符始终用于多个属性，如在“Department equals Sales AND Company equals Contoso”所示。

若要创建使用任何可用收件人属性且不受这些限制约束的灵活筛选器，可以使用 RecipientFilter 参数创建自定义 OPATH 筛选器。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

New-DynamicDistributionGroup -Name "Marketing Group" -IncludedRecipients "MailboxUsers,MailContacts" -ConditionalDepartment "Marketing","Sales"

本示例将创建名为“Marketing Group”的动态通讯组，其中所有收件人的部门字段等同于字符串“Marketing”或“Sales”。由于我们未使用 OrganizationalUnit 或 RecipientContainer 参数，该组将在默认位置寻找收件人（通常是“Users”容器）。

示例 2

New-DynamicDistributionGroup -Name "Washington Management Team" -RecipientFilter "(RecipientType -eq 'UserMailbox') -and (Title -like 'Director*' -or Title -like 'Manager*') -and (StateOrProvince -eq 'WA')" -RecipientContainer "North America"

此示例创建一个名为 Washington Management Team 的动态通讯组，其中包含华盛顿州名为北美的组织单位中的所有用户，其标题以“Director”或“Manager”开头。

参数

-Alias

Alias 参数指定 Exchange 别名 (也称为收件人的邮件昵称) 。此值将收件人标识为已启用邮件的对象，且不得与同一个收件人的多个电子邮件地址混淆（也称为代理地址）。收件人只能有一个 Alias 值。最大长度为 64 个字符。

别名值可以包含字母、数字和以下字符：

！、#、%*、+、-、/、=、？、^、_和 ~。
$、 &、、{、} 和|需要 (进行转义，例如 -Alias what`'snew) 或用单引号括起来的整个值 (例如 -Alias 'what'snew') 。 & Azure AD Connect 同步的“别名”值不支持该字符。
句点 (.) 必须用其他有效字符括起来， (例如 help.desk) 。
Unicode 字符 U+00A1 到 U+00FF。

在不指定电子邮件地址的情况下创建收件人时，指定的别名值用于生成主电子邮件地址 (alias@domain) 。支持的 Unicode 字符会映射到最适合的 US-ASCII 文本字符。例如，主电子邮件地址中的 U+00F6 (ö) 更改为 oe 。

如果在创建收件人时不使用 Alias 参数，则别名属性值将使用其他必需参数的值：

用户帐户 (收件人，例如，用户邮箱和邮件用户) ：使用 MicrosoftOnlineServicesID 或 UserPrincipalName 参数的左侧。例如， helpdesk@contoso.onmicrosoft.com 结果为 Alias 属性值 helpdesk。
没有用户帐户的收件人 (例如会议室邮箱、邮件联系人和通讯组) ：使用 Name 参数的值。删除空格并将不受支持的字符转换为问号 (？) 。

如果修改现有收件人的别名值，则仅在收件人受电子邮件地址策略约束的环境中自动更新主电子邮件地址， (收件人) 的 EmailAddressPolicyEnabled 属性为 True。

Alias 参数永远不会生成或更新邮件联系人或邮件用户的主要电子邮件地址。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ArbitrationMailbox

此参数只在本地 Exchange 中可用。

ArbitrationMailbox 参数指定用于管理此收件人的审阅流程的仲裁邮箱。可以使用任何能够唯一标识仲裁邮箱的值。例如：

名称
别名
可分辨名称 (DN)
可分辨名称 (DN)
域\用户名
电子邮件地址
GUID
LegacyExchangeDN
SamAccountName
用户 ID 或用户主体名称 (UPN)

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019