Set-EmailAddressPolicy
适用于: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题: 2009-05-12
使用 Set-EmailAddressPolicy cmdlet 可以设置电子邮件地址策略的 Active Directory 目录服务属性。
语法
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 [<SwitchParameter>]] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
Set-EmailAddressPolicy [-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 [<SwitchParameter>]] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-EnabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-EnabledPrimarySMTPAddressTemplate <String>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <EmailAddressPolicy>] [-Name <String>] [-Priority <EmailAddressPolicyPriority>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]
详细说明
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。
参数
参数 | 必需 | 类型 | 说明 | ||
---|---|---|---|---|---|
Identity |
必需 |
Microsoft.Exchange.Configuration.Tasks.EmailAddressPolicyIdParameter |
使用 Identity 参数指定代表特定电子邮件地址策略的 GUID、可分辨名称或电子邮件地址策略名称。还可以包含采用 Path\EmailAddressPolicy 格式的路径。 可以省略参数标签 Identity,以便只提供电子邮件地址策略名称或 GUID。 |
||
ConditionalCompany |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCompany 参数设置电子邮件地址策略的公司。该参数采用逗号分隔列表形式的多个值。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute1 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute1 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute10 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute10 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute11 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute11 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute12 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute12 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute13 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute13 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute14 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute14 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute15 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute15 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute2 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute2 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute3 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute3 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute4 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute4 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute5 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute5 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute6 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute6 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute7 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute7 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute8 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute8 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalCustomAttribute9 |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCustomAttribute9 参数指定自定义属性。可以使用这些属性存储其他信息。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalDepartment |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalDepartment 参数指定电子邮件地址策略的部门。该参数采用逗号分隔列表形式的多个值。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
ConditionalStateOrProvince |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalStateOrProvince 参数设置电子邮件地址策略的省/市/自治区。该参数采用逗号分隔列表形式的多个值。如果使用 Conditional 参数,则必须使用 IncludedRecipients 参数。如果使用 RecipientFilter 参数,则不能使用此参数。 |
||
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
Confirm 参数将导致命令暂停处理,并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。 |
||
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 参数:
有关可筛选属性的详细信息,请参阅 -RecipientFilter 参数的可筛选属性。 |
||
UseRusServer |
可选 |
System.String |
UseRusServer 参数指示该命令使用运行地址列表服务的邮箱服务器获取并设置邮箱和 Active Directory 用户属性。 地址列表服务是 Exchange 系统助理服务的一个组件。地址列表服务创建和维护 Active Directory 中 Exchange 特定的属性值。通过使用特定信息(如地址列表成员身份和电子邮件地址),您可以使用地址列表服务来更新域中的收件人对象。 |
||
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数,可以查看要发生的更改,而不必应用任何这些更改。不必为 WhatIf 参数指定值。 |
输入类型
返回类型
错误
错误 | 说明 |
---|---|
异常
异常 | 说明 |
---|---|
示例
以下代码是 Set-EmailAddressPolicy 命令的一个示例,该命令可以将电子邮件地址策略名称从 EMAIL_ADDRESS_POLICY01 更改为 EMAILADDRESSPOLICY02。
Set-EmailAddressPolicy -Identity EMAIL_ADDRESS_POLICY01 -Name EMAIL_ADDRESS_POLICY02