Set-EmailAddressPolicy
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Set-EmailAddressPolicy cmdlet 修改电子邮件地址策略。 在Exchange Online中，电子邮件地址策略仅适用于Microsoft 365 组。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Set-EmailAddressPolicy
[-Identity] <EmailAddressPolicyIdParameter>
[-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>]
[-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>]
[-EnabledPrimarySMTPAddressTemplate <String>]
[-ForceUpgrade]
[-IncludedRecipients <WellKnownRecipientType>]
[-Name <String>]
[-Priority <EmailAddressPolicyPriority>]
[-RecipientContainer <OrganizationalUnitIdParameter>]
[-RecipientFilter <String>]
[-WhatIf]
[<CommonParameters>] 说明
使用 Set-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 将预装筛选器替换为自定义 OPATH 筛选器，反之亦然。 只能修改现有筛选器。
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-EmailAddressPolicy -Identity "Southeast Executives" -ConditionalStateOrProvince @{Add="TX"}在本地 Exchange 中，本示例修改名为 Southeast Executives 的现有电子邮件地址策略，方法是将德克萨斯州 (省/市/自治区/直辖市/直辖市/自治区/直辖市) /自治区/直辖市/直辖市/自治区
示例 2
Set-EmailAddressPolicy -Identity "Contoso Corp" -DisabledEmailAddressTemplates $null在本地 Exchange 中，此示例从名为 Contoso Corp 的电子邮件地址策略中清除禁用的电子邮件地址模板。
示例 3
Set-EmailAddressPolicy -Identity "Office 365 Groups" -EnabledEmailAddressTemplates "SMTP:@contoso.com","smtp:@contoso.onmicrosoft.com","smtp:@contoso.microsoftonline.com"在Exchange Online中，此示例修改了名为“Office 365组”的现有电子邮件地址策略，并将启用的电子邮件地址模板设置为使用“@contoso.com”作为主要 SMTP 地址，使用“@contoso.onmicrosoft.com”和“@contoso.microsoftonline.com”作为代理地址。
参数
-ConditionalCompany
此参数只在本地 Exchange 中可用。
ConditionalCompany 参数指定一个基于收件人公司属性值的固有筛选器。
对此参数使用多个值时，将应用 OR 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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 布尔运算符。 有关条件参数工作原理的详细信息，请参阅本主题的详细说明部分。
若要输入覆盖任何现有条目的多个值，请使用以下语法： Value1,Value2,...ValueN。 如果值包含空格或需要引号，请使用以下语法： "Value","Value2",..."ValueN"。
若要在不影响任何现有条目的情况下添加或删除一个或多个值，请使用以下语法： @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
| 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, Exchange Online Protection |
-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"。
通常，此属性仅在从早期版本的 Exchange 迁移后由值填充。 若要清除这些值，请使用此参数的值$null。
| 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 中，如果将此参数用于 IncludeUnifiedGroupRecipients，则不能在电子邮件地址模板中使用变量。
| 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, Exchange Online, Exchange Online Protection |
-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 中，如果将此参数用于 IncludeUnifiedGroupRecipients，则不能在电子邮件地址模板中使用变量。
| 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 |
-ForceUpgrade
ForceUpgrade 开关禁止在 Exchange 的早期版本中创建对象时出现的确认消息。 不必为此开关指定值。
| Type: | SwitchParameter |
| 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 |
-Identity
Identity 参数指定要修改的电子邮件地址策略。 可以使用任何能够唯一标识该策略的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
| Type: | EmailAddressPolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IncludedRecipients
此参数只在本地 Exchange 中可用。
IncludedRecipients 参数指定基于收件人类型的预设筛选器。 有效值包含:
- AllRecipients：此值只能单独使用。
- MailboxUsers
- MailContacts
- MailGroups
- MailUsers
- MailUsers
可以指定用逗号分隔的多个值。 使用多个值时，将应用 OR 布尔运算符。
| Type: | WellKnownRecipientType |
| 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 |
-Name
Name 参数指定电子邮件地址策略的唯一名称。 最大长度为 64 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
| 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 |
-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, Exchange Online Protection |
-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'，但'Sa*les'不允许。
有关 Exchange 中的 OPATH 筛选器的详细信息，请参阅 其他 OPATH 语法信息。
| 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 |
-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, Exchange Online Protection |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。