Set-EmailAddressPolicy (RTM)

  • 项目

 

适用于： Exchange Server 2007

上一次修改主题： 2008-05-07

使用 Set-EmailAddressPolicy cmdlet 可以设置电子邮件地址策略的 Active Directory 目录服务属性。

语法

Set-EmailAddressPolicy -Identity <EmailAddressPolicyIdParameter> [-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>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>]

Set-EmailAddressPolicy [-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>] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <EmailAddressPolicy>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>]

详细说明

Set-EmailAddressPolicy cmdlet 允许管理员设置特定电子邮件地址策略的 Active Directory 属性。但是，Set-EmailAddressPolicy cmdlet 不会将更改应用于电子邮件地址策略。若要应用更改，请在 Set-EmailAddressPolicy cmdlet 之后使用 Update-EmailAddressPolicy cmdlet。

若要运行 Set-EmailAddressPolicy cmdlet，必须为您使用的帐户委派以下角色：

  • Exchange 组织管理员角色

有关管理 Microsoft Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。

有关 Update-EmailAddressPolicy cmdlet 的详细信息，请参阅 Update-EmailAddressPolicy (RTM)。

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter

使用 Identity 参数指定代表特定电子邮件地址策略的 GUID、可分辨名称或电子邮件地址策略名称。还可以包含采用 Path\EmailAddressPolicy 格式的路径。

可以省略参数标签 Identity，以便只提供电子邮件地址策略的名称或 GUID。

ConditionalCompany

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCompany 参数设置电子邮件地址策略的公司。该参数采用逗号分隔列表形式的多个值。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute1

可选

System.String

ConditionalCustomAttribute1 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute10

可选

System.String

ConditionalCustomAttribute10 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute11

可选

System.String

ConditionalCustomAttribute11 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute12

可选

System.String

ConditionalCustomAttribute12 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute13

可选

System.String

ConditionalCustomAttribute13 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute14

可选

System.String

ConditionalCustomAttribute14 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute15

可选

System.String

ConditionalCustomAttribute15 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute2

可选

System.String

ConditionalCustomAttribute2 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute3

可选

System.String

ConditionalCustomAttribute3 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute4

可选

System.String

ConditionalCustomAttribute4 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute5

可选

System.String

ConditionalCustomAttribute5 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute6

可选

System.String

ConditionalCustomAttribute6 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute7

可选

System.String

ConditionalCustomAttribute7 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute8

可选

System.String

ConditionalCustomAttribute8 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalCustomAttribute9

可选

System.String

ConditionalCustomAttribute9 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalDepartment

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalDepartment 参数指定电子邮件地址策略的部门。该参数采用逗号分隔列表形式的多个值。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

ConditionalStateOrProvince

可选

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalStateOrProvince 参数设置电子邮件地址策略的省/市/自治区。该参数采用逗号分隔列表形式的多个值。如果使用 Conditional 参数，则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数，则不能使用此参数。

DisabledEmailAddressTemplates

可选

Microsoft.Exchange.Data.ProxyAddressTemplateCollection

DisabledEmailAddressTemplates 参数定义电子邮件地址策略中包含的、已禁用的代理服务器地址。该参数采用逗号分隔列表形式的多个值。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定从 Active Directory 检索数据的域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。

EnabledEmailAddressTemplates

可选

Microsoft.Exchange.Data.ProxyAddressTemplateCollection

EnabledEmailAddressTemplates 参数定义包括在电子邮件地址策略中并被启用的代理地址。该参数采用逗号分隔列表形式的多个值。

EnabledPrimarySMTPAddressTemplate

可选

System.String

EnabledPrimarySMTPAddressTemplate 参数定义包括在电子邮件地址策略中并被启用的代理地址。该参数采用逗号分隔列表形式的多个值。

ForceUpgrade

可选

System.Management.Automation.SwitchParameter

ForceUpgrade 参数禁用以下确认：“若要保存对对象的更改，必须将该对象升级到当前的 Exchange 版本。完成升级后，无法通过早期版本的 Exchange 系统管理器管理来此对象。要继续升级并保存该对象吗？”在升级 Microsoft Exchange Server 2003 或 Exchange 2000 Server 中创建的电子邮件地址策略时会出现此确认消息。在更新对象版本并使用 RecipientFilter 或 IncludedRecipients 参数更改收件人筛选器之前，无法使用 Exchange 管理控制台管理 Exchange 2003 或 Exchange 2000 电子邮件地址策略。

IncludedRecipients

可选

System.Nullable

IncludedRecipients 参数可筛选用于构建全局地址列表 (GAL) 的收件人类型。IncludedRecipients 参数的可用值为 AllRecipients、MailboxUsers、Resources、Contacts 和 MailGroups。

AllRecipients 值只能单独使用。当 IncludedRecipients 参数的多个值使用逗号分隔时，将应用 OR 布尔运算符。

如果使用任何 Conditional 参数，则必须使用此参数。如果使用 RecipientFilter 参数，则不能使用此参数。

Instance

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicy

使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。

Name

可选

System.String

Name 参数指定电子邮件地址策略的新名称。

Priority

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority

Priority 参数使当前优先级高于作为此参数的变量指定的优先级。

RecipientFilter

可选

System.String

RecipientFilter 参数筛选包含在特殊电子邮件地址策略中的收件人。如果指定了下列任何一个参数，则不能使用 RecipientFilter 参数：

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

有关可筛选属性的详细信息，请参阅 -RecipientFilter 参数的可筛选属性。

输入类型

返回类型

错误

错误 说明

异常

异常 说明

示例

以下代码是 Set-EmailAddressPolicy 命令的一个示例，该命令可以将电子邮件地址策略名称从 EMAIL_ADDRESS_POLICY01 更改为 EMAILADDRESSPOLICY02。

Set-EmailAddressPolicy -Identity EMAIL_ADDRESS_POLICY01 -Name EMAIL_ADDRESS_POLICY02