New-EmailAddressPolicy

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题： 2009-05-12

使用 New-EmailAddressPolicy cmdlet 新建电子邮件地址策略。

语法

New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -IncludedRecipients <Nullable> [-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>]] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -RecipientFilter <String> [-Confirm [<SwitchParameter>]] [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -RecipientFilter <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -IncludedRecipients <Nullable> [-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>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

详细说明

New-EmailAddressPolicy cmdlet 可新建电子邮件地址策略并应用该策略。新电子邮件地址策略在 Active Directory 目录服务中的 Microsoft Exchange 组织配置容器下创建。

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

• Exchange 组织管理员角色

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

参数

参数	必需	类型	说明
EnabledEmailAddressTemplates	必需	Microsoft.Exchange.Data.ProxyAddressTemplateCollection	EnabledEmailAddressesTemplates 参数指定电子邮件地址策略中包含的并已启用的代理地址。使用逗号分隔多个值。每个代理服务器地址的域部分都需要与现有的接受域相匹配。
EnabledPrimarySMTPAddressTemplate	必需	System.String	EnabledPrimarySMTPAddressTemplate 参数指定电子邮件地址策略中包含的、已启用的代理服务器地址。每个代理服务器地址的域部分都需要与现有的接受域相匹配。
IncludedRecipients	必需	System.Nullable	IncludedRecipients 参数筛选用于设置电子邮件地址策略的收件人。AllRecipients 值只能单独使用。当 IncludedRecipients 参数的多个值使用逗号分隔时，将应用 OR 布尔运算符。
Name	必需	System.String	Name 参数指定电子邮件地址策略的名称。
RecipientFilter	必需	System.String	RecipientFilter 参数指定要包含在电子邮件地址策略中的收件人的筛选器。如果使用了下列筛选器参数中的任何一个，则不能使用此参数： ConditionalCompany ConditionalDepartment IncludedRecipients ConditionalStateOrProvince 有关可筛选属性的详细信息，请参阅 -RecipientFilter 参数的可筛选属性。
ConditionalCompany	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCompany 参数按公司进行筛选。该参数采用逗号分隔列表形式的多个值。
ConditionalCustomAttribute1	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute1 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute10	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute10 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute11	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute11 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute12	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute12 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute13	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute13 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute14	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute14 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute15	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute15 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute2	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute2 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute3	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute3 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute4	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute4 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute5	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute5 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute6	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute6 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute7	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute7 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute8	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute8 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalCustomAttribute9	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalCustomAttribute9 参数指定自定义属性。可以使用这些属性存储其他信息。
ConditionalDepartment	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalDepartment 参数按部门进行筛选。该参数采用逗号分隔列表形式的多个值。
ConditionalStateOrProvince	可选	Microsoft.Exchange.Data.MultiValuedProperty	ConditionalStateOrProvince 参数按省/市/自治区进行筛选。该参数采用逗号分隔列表形式的多个值。
Confirm	可选	System.Management.Automation.SwitchParameter	Confirm 参数将导致命令暂停处理，并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。
DisabledEmailAddressTemplates	可选	Microsoft.Exchange.Data.ProxyAddressTemplateCollection	DisabledEmailAddressTemplates 参数定义电子邮件地址策略中包含的、已禁用的代理服务器地址。该参数采用逗号分隔列表形式的多个值。
DomainController	可选	Microsoft.Exchange.Data.Fqdn	若要指定用于将此配置更改写入 Active Directory 的域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。
Priority	可选	Microsoft.Exchange.Data.Directory.SystemConfiguration.EmailAddressPolicyPriority	Priority 参数使当前优先级高于作为此参数的变量指定的优先级。
TemplateInstance	可选	System.Management.Automation.PSObject	将现有对象提供给 TemplateInstance 参数时，该命令将使用该对象的配置在本地服务器或目标服务器上创建完全重复的对象。
UseRusServer	可选	System.String	注意： 此参数仅在 Exchange 2007 SP2 中可用。 UseRusServer 参数指示该命令使用运行地址列表服务的邮箱服务器获取并设置邮箱和 Active Directory 用户属性。 地址列表服务是 Exchange 系统助理服务的一个组件。地址列表服务创建和维护 Active Directory 中 Exchange 特定的属性值。通过使用特定信息（如地址列表成员身份和电子邮件地址），您可以使用地址列表服务来更新域中的收件人对象。
WhatIf	可选	System.Management.Automation.SwitchParameter	WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数，可以查看要发生的更改，而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误	说明

异常

异常	说明

示例

以下代码是 New-EmailAddressPolicy 命令的示例。

New-EmailAddressPolicy -Name "MyPolicy" -IncludedRecipients MailboxUsers -EnabledPrimarySMTPAddressTemplate SMTP:@contoso.com