New-EmailAddressPolicy
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 New-EmailAddressPolicy cmdlet 创建电子邮件地址策略。 在Exchange Online中，电子邮件地址策略仅适用于Microsoft 365 组。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
-IncludedRecipients <WellKnownRecipientType>
[-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]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
-RecipientFilter <String>
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
-IncludedRecipients <WellKnownRecipientType>
[-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]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
-RecipientFilter <String>
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>
[-IncludeUnifiedGroupRecipients]
[-ManagedByFilter <String>]
[-Confirm]
[-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] New-EmailAddressPolicy
[-Name] <String>
-EnabledPrimarySMTPAddressTemplate <String>
[-IncludeUnifiedGroupRecipients]
[-ManagedByFilter <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-WhatIf]
[<CommonParameters>] 说明
使用 New-EmailAddressPolicy cmdlet 在本地 Exchange 组织中创建电子邮件地址策略后，需要使用 Update-EmailAddressPolicy cmdlet 将新策略应用于收件人。
与 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-EmailAddressPolicy -Name "Southeast Offices" -IncludedRecipients MailboxUsers -ConditionalStateorProvince "GA","AL","LA" -EnabledEmailAddressTemplates "SMTP:%s%2g@southeast.contoso.com","smtp:%s%2g@southeast.contoso.net"此示例在使用固有收件人筛选器的本地 Exchange 组织中创建电子邮件地址策略：
- 名称：东南办事处
- Precanned 收件人筛选器：邮箱的州或省/自治区值为 GA、AL 或 LA (佐治亚州、阿拉巴马州或路易斯安那州) 。
- 主 SMTP 电子邮件地址：
<last name>.<first two letters of the first name>@contoso.com - 其他代理电子邮件地址：
<last name>.<first two letters of the first name>@contoso.net - Priority：N+1，其中 N 是手动创建的电子邮件地址策略的数量， (我们未使用 Priority 参数，默认值为 N+1) 。
示例 2
New-EmailAddressPolicy -Name "Northwest Executives" -RecipientFilter "(RecipientType -eq 'UserMailbox') -and (Title -like '*Director*' -or Title -like '*Manager*') -and (StateOrProvince -eq 'WA' -or StateOrProvince -eq 'OR' -or StateOrProvince -eq 'ID')" -EnabledEmailAddressTemplates "SMTP:%2g%s@contoso.com" -Priority 2此示例在使用自定义收件人筛选器的本地 Exchange 组织中创建电子邮件地址策略：
- 姓名：西北行政人员
- 自定义收件人筛选器：具有“标题”值包含“董事”或“经理”且“州/自治区”值为 WA、OR 或 ID (华盛顿、俄勒冈州或爱达荷州) 的邮箱的所有用户。
- 主 SMTP 电子邮件地址：
<first two letters of the first name><last name>@contoso.com - 其他代理电子邮件地址：无
- 优先级：2
参数
-ConditionalCompany
此参数只在本地 Exchange 中可用。
ConditionalCompany 参数指定一个基于收件人公司属性值的固有筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute1
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute1 参数指定基于收件人 CustomAttribute1 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute10
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute10 参数指定基于收件人 CustomAttribute10 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute11
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute11 参数指定基于收件人 CustomAttribute11 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute12
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute12 参数指定基于收件人 CustomAttribute12 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute13
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute13 参数指定基于收件人 CustomAttribute13 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute14
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute14 参数指定基于收件人 CustomAttribute14 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute15
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute15 参数指定基于收件人 CustomAttribute15 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute2
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute2 参数指定基于收件人 CustomAttribute2 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute3
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute3 参数指定基于收件人 CustomAttribute3 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute4
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute4 参数指定基于收件人 CustomAttribute4 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute5
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute5 参数指定基于收件人 CustomAttribute5 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute6
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute6 参数指定基于收件人 CustomAttribute6 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute7
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute7 参数指定基于收件人 CustomAttribute7 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute8
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute8 参数指定基于收件人 CustomAttribute8 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalCustomAttribute9
此参数只在本地 Exchange 中可用。
ConditionalCustomAttribute9 参数指定基于收件人 CustomAttribute9 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalDepartment
此参数只在本地 Exchange 中可用。
ConditionalDepartment 参数指定一个基于收件人 Department 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-ConditionalStateOrProvince
此参数只在本地 Exchange 中可用。
ConditionalStateOrProvince 参数指定基于收件人 StateOrProvince 属性的值的预装筛选器。 可以指定用逗号分隔的多个值。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
将此参数与 IncludedRecipients 参数结合使用，作为预设筛选器的一部分。 不能将任何条件参数与 RecipientFilter 参数 (结合使用，该参数用于) 创建自定义 OPATH 筛选器。
| Type: | MultiValuedProperty |
| 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 |
-Confirm
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
| Type: | SwitchParameter |
| Aliases: | cf |
| 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 |
-DisabledEmailAddressTemplates
此参数只在本地 Exchange 中可用。
DisabledEmailAddressTemplates 参数指定电子邮件地址策略中包含的代理电子邮件地址模板，但不用于配置收件人的电子邮件地址。
此参数的有效语法为 Type:AddressFormat：
- 类型：有效的电子邮件地址类型，如 Exchange Server 中Email地址策略中的“地址类型”部分所述。 例如，smtp 或 X400。 请注意，不能使用 SMTP 指定禁用的主 SMTP 电子邮件地址。
- AddressFormat：对于 SMTP 电子邮件地址，配置为接受域的域或子域 (权威或内部中继) ，以及有效变量和 ASCII 文本字符，如 Exchange Server Email 地址策略中的“地址格式”部分中所述。 例如： alias@contoso.com 需要值
%m@contoso.com，而 firstname.lastname@contoso.com 需要值%g.%s@contoso.com。
可以指定多个禁用的电子邮件地址模板（以逗号分隔）： "[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN"。
| Type: | ProxyAddressTemplateCollection |
| 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 |
-DomainController
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
| Type: | Fqdn |
| 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 |
-EnabledEmailAddressTemplates
若要配置被阻止的文件类型，请使用 FileTypes 参数。
此参数的有效语法为 Type:AddressFormat：
- 类型：有效的电子邮件地址类型，如 Exchange Server 中Email地址策略中的“地址类型”部分中所述。 例如，SMTP 用于主电子邮件地址，SMTP 用于代理地址。
- AddressFormat：对于 SMTP 电子邮件地址，配置为接受域的域或子域 (权威或内部中继) ，以及有效变量和 ASCII 文本字符，如 Exchange Server Email 地址策略中的“地址格式”部分中所述。 例如： alias@contoso.com 需要值
%m@contoso.com，而 firstname.lastname@contoso.com 需要值%g.%s@contoso.com。
此参数需要至少一个类型值为 SMTP (的模板来定义主 SMTP 电子邮件地址) 。 之后，如果未包含模板的类型前缀，则假定使用 smtp (SMTP 代理地址) 的值。
可以指定多个电子邮件地址模板（以逗号分隔）： "SMTP:PrimarySMTPEmailAddress","[Type1:]EmailAddress1","[Type2:]EmailAddress2",..."[TypeN:]EmailAddressN"。
不能将此参数与 EnabledPrimarySMTPAddressTemplate 参数一起使用。
在 Exchange Online PowerShell 中，不能在电子邮件地址模板中使用变量。
| Type: | ProxyAddressTemplateCollection |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-EnabledPrimarySMTPAddressTemplate
EnabledPrimarySMTPAddressTemplate 参数指定电子邮件地址策略中用于为收件人生成主 SMTP 电子邮件地址的规则。 如果策略仅应用主电子邮件地址而不应用其他代理地址，则可以使用此参数而不是 EnabledEmailAddressTemplates。
此参数的有效语法是配置为权威接受域的域或子域，以及有效变量和 ASCII 文本字符，如Email地址策略Exchange Server中的“地址格式”部分所述。 例如： alias@contoso.com 需要值 %m@contoso.com，而 firstname.lastname@contoso.com 需要值 %g.%s@contoso.com。
不能将此参数与 EnabledEmailAddressTemplates 参数一起使用。
在 Exchange Online PowerShell 中，不能在电子邮件地址模板中使用变量。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludedRecipients
此参数只在本地 Exchange 中可用。
IncludedRecipients 参数指定基于收件人类型的预设筛选器。 有效值包含:
- AllRecipients：此值只能单独使用。
- MailboxUsers
- MailContacts
- MailGroups
- MailUsers
- MailUsers
可以指定用逗号分隔的多个值。 使用多个值时，将应用 OR 布尔运算符。
在将任何条件参数用作固有筛选器的一部分时，需要使用此参数。 不能将此参数与 RecipientFilter 参数 (结合使用，后者用于) 创建自定义 OPATH 筛选器。
| Type: | WellKnownRecipientType |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludeUnifiedGroupRecipients
此参数仅在基于云的服务中可用。
IncludeUnifiedGroupRecipients 开关指定电子邮件地址策略仅适用于Microsoft 365 组。 不必为此开关指定值。
Exchange Online PowerShell 中，始终需要使用此开关，因为 Exchange Online 中的电子邮件地址策略仅适用于 Microsoft 365 个组。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ManagedByFilter
此参数仅在基于云的服务中可用。
ManagedByFilter 参数根据创建Microsoft 365 组的用户的属性指定要应用于Microsoft 365 组的电子邮件地址策略。
此参数是基于任何可用收件人属性的值的 OPATH 筛选器， (例如 "Department -eq 'Sales'" ，) 。 可以使用任何可用的 Windows PowerShell 运算符，并且支持通配符和部分匹配项。 搜索条件使用 语法 "Property -ComparisonOperator 'Value'"。
- 将整个 OPATH 筛选器括在双引号“”中。 如果筛选器包含系统值 (，例如
$true、$false或$null) ，请改用单引号 ' 。 虽然此参数是一个字符串 (不是) 的系统块，但也可以使用大括号 { }，但前提是筛选器不包含变量。 - 属性是可筛选的属性。 有关可筛选收件人属性，请参阅 RecipientFilter 参数的可筛选属性。
- ComparisonOperator 是一个 OPATH 比较运算符， (例如
-eq用于等于和-like字符串比较) 。 有关比较运算符的详细信息，请参阅 about_Comparison_Operators。 - Value 是要搜索的属性值。 将文本值和变量括在单引号 (
'Value'或'$Variable') 。 如果变量值包含单引号，则需要识别 (转义) 单引号才能正确展开变量。 例如，使用'$($User -Replace "'","''")'而不是'$User'。 不要将整数或系统值括在引号 (例如，改用500、$true、$false或$null) 。 - 不能使用通配符作为第一个字符。 例如，
'Sales*'允许，但'*Sales'不允许。
有关详细信息，请参阅选择创建Microsoft 365 组时要使用的域。
有关 Exchange 中的 OPATH 筛选器的详细信息，请参阅 其他 OPATH 语法信息。
只能在具有 IncludeUnifiedGroupRecipients 开关Exchange Online PowerShell 中使用此参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Name
Name 参数指定电子邮件地址策略的唯一名称。 最大长度为 64 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Priority
Priority 参数指定评估电子邮件地址策略的顺序。 默认情况下，每次添加新电子邮件地址策略时，都会为策略分配 N+1 优先级，其中 N 是已创建的电子邮件地址策略的数目。
Priority 参数指定评估电子邮件地址策略的顺序。默认情况下，每当添加新的电子邮件地址策略，就会为该策略分配 N+1 的优先级，其中 N 是已创建的电子邮件地址策略的数量。
注意：标识收件人的第一个电子邮件地址策略配置收件人的电子邮件地址。 将忽略所有其他策略，即使第一个策略未应用且不能配置收件人的电子邮件地址。
| Type: | EmailAddressPolicyPriority |
| 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 |
-RecipientContainer
此参数只在本地 Exchange 中可用。
RecipientContainer 参数指定基于收件人在 Active Directory 中的位置的筛选器。 此参数的有效输入是由 Get-OrganizationalUnit cmdlet 返回的组织单位 (OU) 或域。 可以使用任何能够唯一标识此 OU 或域的值。 例如：
- 名称
- 名称
- 可分辨名称 (DN)
- GUID
GUID
| Type: | OrganizationalUnitIdParameter |
| 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 |
-RecipientFilter
此参数只在本地 Exchange 中可用。
RecipientFilter 参数指定基于任何可用收件人属性的值的自定义 OPATH 筛选器。 可以使用任何可用的 Windows PowerShell 运算符，并且支持通配符和部分匹配项。 搜索条件使用 语法 "Property -ComparisonOperator 'Value'"。
- 将整个 OPATH 筛选器括在双引号“”中。 如果筛选器包含系统值 (，例如
$true、$false或$null) ，请改用单引号 ' 。 虽然此参数是一个字符串 (不是) 的系统块，但也可以使用大括号 { }，但前提是筛选器不包含变量。 - 属性是可筛选的属性。 有关可筛选属性，请参阅 RecipientFilter 参数的可筛选属性。
- ComparisonOperator 是一个 OPATH 比较运算符， (例如
-eq用于等于和-like字符串比较) 。 有关比较运算符的详细信息，请参阅 about_Comparison_Operators。 - 值是要筛选的属性值。 将文本值和变量括在单引号 (
'Value'或'$Variable') 。 如果变量值包含单引号，则需要识别 (转义) 单引号才能正确展开变量。 例如，使用'$($User -Replace "'","''")'而不是'$User'。 不要将整数或系统值括在引号 (例如，改用500、$true、$false或$null) 。 - 在基于云的环境中，不能使用通配符作为第一个字符。 例如，
'Sales*'允许，但'*Sales'不允许。 - 在本地 Exchange 中，通配符仅作为第一个字符或最后一个字符有效。 例如，
'Sales*'允许 或'*Sales'，但'Sa*les'不允许。
有关 Exchange 中的 OPATH 筛选器的详细信息，请参阅 其他 OPATH 语法信息。
不能将此参数与 IncludedRecipients 参数或任何用于) 创建固有筛选器的条件参数 (结合使用。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
| Type: | SwitchParameter |
| Aliases: | wi |
| 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 |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。