New-DynamicDistributionGroup
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能是一个环境或另一个环境独占。
使用 New-DynamicDistributionGroup cmdlet 创建动态通讯组。 动态通讯组查询已启用邮件的对象，并根据结果构建组成员身份。 只要向组发送了电子邮件，就会重新计算组成员身份。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
PrecannedFilter
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>]
[-ManagedBy <GeneralRecipientIdParameter>]
[-DomainController <Fqdn>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-Notes <String>]
[-OrganizationalUnit <OrganizationalUnitIdParameter>]
[-PrimarySmtpAddress <SmtpAddress>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-SendModerationNotifications <TransportModerationNotificationFlags>]
[-WhatIf]
[<CommonParameters>]
CustomFilter
New-DynamicDistributionGroup
[-Name] <String>
-RecipientFilter <String>
[-Alias <String>]
[-ArbitrationMailbox <MailboxIdParameter>]
[-Confirm]
[-DirectMembershipOnly <Boolean>]
[-DisplayName <String>]
[-ManagedBy <GeneralRecipientIdParameter>]
[-DomainController <Fqdn>]
[-ModeratedBy <MultiValuedProperty>]
[-ModerationEnabled <Boolean>]
[-Notes <String>]
[-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 "(RecipientTypeDetails -eq 'UserMailbox') -and (Title -like 'Director*' -or Title -like 'Manager*') -and (StateOrProvince -eq 'WA')" -RecipientContainer "North America"
此示例创建名为 Washington Management Team 的动态通讯组，该通讯组包含来自华盛顿州的名为北美的组织单位中所有头衔以“Director”或“Manager”开头的用户。
参数
-Alias
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
别名参数指定 Exchange 别名 (也称为收件人的邮件昵称) 。 此值将收件人标识为已启用邮件的对象，且不得与同一个收件人的多个电子邮件地址混淆（也称为代理地址）。 收件人只能有一个 Alias 值。 最大长度为 64 个字符。
别名值可以包含字母、数字和以下字符：
- ！、#、%， *、+、-、/、=、？、^、_ 和 ~。
- $、&、'、'、{、} 和 |需要转义 (
-Alias what`'snew例如) 或整个值（例如单-Alias 'what'snew'引号 (例如) ）。 Microsoft Entra Connect同步的别名值中不支持 & 字符。 - 句点 (.) 必须由其他有效字符包围， (例如
help.desk) 。 - Unicode 字符 U+00A1 到 U+00FF。
创建收件人而不指定电子邮件地址时，将使用指定的别名值生成主电子邮件地址 (alias@domain) 。 支持的 Unicode 字符会映射到最适合的 US-ASCII 文本字符。 例如，U+00F6 (ö) 在主电子邮件地址中更改。oe
如果在创建收件人时不使用“别名”参数，则“别名”属性值将使用其他必需参数的值：
- 具有用户帐户 (例如用户邮箱和邮件用户) 的收件人： 使用 MicrosoftOnlineServicesID 或 UserPrincipalName 参数的左侧。 例如， helpdesk@contoso.onmicrosoft.com 结果为 别名属性值
helpdesk。 - 没有用户帐户的收件人 (例如，会议室邮箱、邮件联系人和通讯组) ：使用 Name 参数的值。 空格将被删除，不受支持的字符将转换为问号 (？) 。
如果修改现有收件人的别名值，则仅在收件人受电子邮件地址策略约束 (收件人) 的 EmailAddressPolicyEnabled 属性为 True 的环境中，才会自动更新主电子邮件地址。
别名参数从不生成或更新邮件联系人或邮件用户的主电子邮件地址。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ArbitrationMailbox
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此参数只在本地 Exchange 中可用。
ArbitrationMailbox 参数指定用于管理此收件人的审阅流程的仲裁邮箱。 可以使用任何能够唯一标识仲裁邮箱的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
参数属性
| 类型: | MailboxIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCompany
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCompany 参数指定基于收件人 Company 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute1
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute1 参数指定基于收件人的 CustomAttribute1 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute10
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute10 参数指定基于收件人 CustomAttribute10 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute11
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute11 参数指定基于收件人 CustomAttribute11 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute12
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute12 参数指定基于收件人的 CustomAttribute12 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute13
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute13 参数指定基于收件人的 CustomAttribute13 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute14
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute14 参数指定基于收件人 CustomAttribute14 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute15
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute15 参数指定基于收件人 CustomAttribute15 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute2
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute2 参数指定基于收件人 CustomAttribute2 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute3
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute3 参数指定基于收件人的 CustomAttribute3 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute4
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute4 参数指定基于收件人的 CustomAttribute4 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute5
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute5 参数指定基于收件人 CustomAttribute5 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute6
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute6 参数指定基于收件人的 CustomAttribute6 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute7
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute7 参数指定基于收件人的 CustomAttribute7 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute8
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute8 参数指定基于收件人的 CustomAttribute8 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalCustomAttribute9
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalCustomAttribute9 参数指定基于收件人 CustomAttribute9 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalDepartment
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalDepartment 参数指定基于收件人的 Department 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConditionalStateOrProvince
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ConditionalStateOrProvince 参数指定基于收件人的 StateOrProvince 属性值的预设筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数如何工作的详细信息，请参阅本文的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 有何影响取决于 cmdlet 在继续操作前是否需要确认。
- 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，在不带值的情况下指定“确认”开关会引入一个暂停，从而强制你在继续之前确认命令。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DirectMembershipOnly
适用：Exchange Online，用于本地邮箱的内置安全加载项
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | Boolean |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DisplayName
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
DisplayName 参数指定动态通讯组的显示名称。 显示名称在 Exchange 管理中心和地址列表中可见。 长度不得超过 256 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
如果您不使用 DisplayName 参数，Name 参数的值可用于显示名称。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DomainController
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IncludedRecipients
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
IncludedRecipients 参数指定基于收件人类型的预设筛选器。 有效值包含:
- AllRecipients：此值只能单独使用。
- MailboxUsers
- MailContacts
- 邮件组
- MailUsers
- MailUsers
可以指定用逗号分隔的多个值。 使用多个值时，将应用 OR 布尔运算符。
将任何条件参数用作预设筛选器的一部分时，需要使用此参数。 不能将此参数与用于创建自定义 OPATH 筛选器) 的 RecipientFilter 参数 (结合使用。
参数属性
| 类型: | WellKnownRecipientType |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrecannedFilter
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ManagedBy
适用：Exchange Online、Exchange Online Protection
此参数仅在基于云的服务中可用。
{{ 填充 ManagedBy 说明 }}
参数属性
| 类型: | GeneralRecipientIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ModeratedBy
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ModeratedBy 参数指定此收件人的一个或多个审查方。 在审查方批准发送给收件人的邮件后，才能传送邮件。 审查方必须是您组织中的邮箱、邮件用户或邮件联系人。 可以使用任何能够唯一标识审查方的值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 规范 DN
- GUID
Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。
将 ModerationEnabled 参数设置为值 $true 时，使用此参数指定至少一个审阅人。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ModerationEnabled
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
ModerationEnabled 参数指定是否为此收件人启用审查。 有效值包括：
- $true：已为此收件人启用审查。 发送给此收件人的消息必须在传递消息之前获得审阅人的批准。
- $false：已为此收件人禁用审查。 发送给此收件人的邮件未经审阅人批准即可发送。 此值为默认值。
可以使用 ModeratedBy 参数指定审阅人。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
Name 参数指定动态通讯组的唯一名称。 最大长度为 64 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
如果不使用 DisplayName 参数，此值还用于 DisplayName 属性。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Notes
适用：Exchange Online、Exchange Online Protection
此参数仅在基于云的服务中可用。
{{ 填写备注说明 }}
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-OrganizationalUnit
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
OrganizationalUnit 参数指定用于创建动态通讯组的组织单位 (OU)。
此参数的有效输入是 Get-OrganizationalUnit cmdlet 返回 (OU) 或域的组织单位。 可以使用任何能够唯一标识此 OU 或域的值。 例如：
- 名称
- 名称
- 可分辨名称 (DN)
- GUID
如果不使用此参数，默认值通常是所连接的 Exchange Server 域中的用户容器 (也称为收件人范围) 。 在本地 Exchange 中，可以使用 Set-AdServerSettings cmdlet 更改当前 PowerShell 会话的收件人范围。
如果不使用 RecipientContainer 参数，则动态通讯组的位置将用于默认位置 (RecipientContainer 属性，或为 OrganizationalUnit 参数) 指定的值。
注意： 虽然此参数在 Exchange Online 中可用，但 Exchange Online 组织中只有一个可用的 OU，因此使用此参数无效。
参数属性
| 类型: | OrganizationalUnitIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PrimarySmtpAddress
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
PrimarySmtpAddress 参数指定对收件人使用的主要返回电子邮件地址。
参数属性
| 类型: | SmtpAddress |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-RecipientContainer
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
RecipientContainer 参数指定基于收件人在 Active Directory 中的位置的筛选器。 此参数的有效输入是 Get-OrganizationalUnit cmdlet 返回 (OU) 或域的组织单位。 可以使用任何能够唯一标识此 OU 或域的值。 例如：
- 名称
- 名称
- 可分辨名称 (DN)
- GUID
GUID
RecipientContainer 属性不能为空。 组始终限制在特定位置（为此参数指定的值或创建该组的位置）中查找收件人。
注意： 虽然此参数在 Exchange Online 中可用，但 Exchange Online 组织中只有一个可用的 OU，因此使用此参数无效。
参数属性
| 类型: | OrganizationalUnitIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-RecipientFilter
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
RecipientFilter 参数指定基于任何可用收件人属性值的自定义 OPATH 筛选器。 可以使用任何可用的 Windows PowerShell 运算符，并且支持通配符和部分匹配。 搜索条件使用语法 "Property -ComparisonOperator 'Value'"。
- 请用双引号“ ”括住整个 OPATH 筛选器。 如果筛选器包含系统值 (例如
$true、 或$false$null) ，请改用单引号 ' '。 尽管此参数是字符串 (而不是系统块) ，但您也可以使用大括号 { }，但前提是筛选器不包含变量。 - 属性是可筛选的属性。 有关可筛选的属性，请参阅 RecipientFilter 参数的可筛选属性。
- ComparisonOperator 是一个 OPATH 比较运算符 (例如
-eq，对于等值和-like字符串比较) 。 有关比较运算符的详细信息，请参阅 about_Comparison_Operators。 - 值是要筛选依据的属性值。 请将文本值和变量括在单引号 (
'Value'或'$Variable') 中。 如果变量值包含单引号，则需要标识单引号 (转义) 正确展开变量。 例如，'$User'使用'$($User -Replace "'","''")'. 而不是 。 不要将整数或系统值括在引号中，例如，使用500、$true($false$null或改为) 。 - 在基于云的环境中，不能使用通配符作为第一个字符。 例如，
'Sales*'允许，但'*Sales'不允许。 - 在本地 Exchange 中，通配符仅作为第一个或最后一个字符有效。 例如，
'Sales*'或'*Sales'是允许的，但'Sa*les'不允许。
有关 Exchange 中 OPATH 筛选器的详细信息，请参阅 其他 OPATH 语法信息。
不能将此参数与 IncludedRecipients 参数或用于创建预设筛选器 (的任何条件参数结合使用) 。
RecipientFilter 属性的最大长度为 2048 个字符，包括内部语法。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CustomFilter
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SendModerationNotifications
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
客户端通过代理从客户端访问服务连接到本地或远程邮箱服务器上的后端服务。 有效值包含:
- 始终：当发件人的邮件未获批准时通知所有发件人。 此值为默认值。
- Always：当发件人的邮件未得到批准时，通知所有发件人。此为默认值。
- Internal：当组织中发件人的邮件未得到批准时，通知这些发件人。
仅当启用审查 (ModerationEnabled 参数的值为 $true) 时，此参数才有意义。
参数属性
| 类型: | TransportModerationNotificationFlags |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地内置安全加载项邮箱
WhatIf 开关显示命令执行的操作，而无需进行任何更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | WI |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持以下常用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。