New-EmailAddressPolicy (RTM)
适用于: Exchange Server 2007
上一次修改主题: 2007-06-05
使用 New-EmailAddressPolicy cmdlet 新建电子邮件地址策略。
语法
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -IncludedRecipients <Nullable> [-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>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledPrimarySMTPAddressTemplate <String> -RecipientFilter <String> [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -RecipientFilter <String> [-DisabledEmailAddressTemplates <ProxyAddressTemplateCollection>] [-DomainController <Fqdn>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
New-EmailAddressPolicy -Name <String> -EnabledEmailAddressTemplates <ProxyAddressTemplateCollection> -IncludedRecipients <Nullable> [-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>] [-Priority <EmailAddressPolicyPriority>] [-TemplateInstance <PSObject>]
详细说明
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 参数指定要包含在电子邮件地址策略中的收件人的筛选器。如果使用了下列筛选器参数中的任何一个,则不能使用此参数:
有关可筛选属性的详细信息,请参阅 -RecipientFilter 参数的可筛选属性。 |
ConditionalCompany |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCompany 参数按公司进行筛选。该参数采用逗号分隔列表形式的多个值。 |
ConditionalCustomAttribute1 |
可选 |
System.String |
ConditionalCustomAttribute1 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute10 |
可选 |
System.String |
ConditionalCustomAttribute10 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute11 |
可选 |
System.String |
ConditionalCustomAttribute11 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute12 |
可选 |
System.String |
ConditionalCustomAttribute12 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute13 |
可选 |
System.String |
ConditionalCustomAttribute13 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute14 |
可选 |
System.String |
ConditionalCustomAttribute14 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute15 |
可选 |
System.String |
ConditionalCustomAttribute15 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute2 |
可选 |
System.String |
ConditionalCustomAttribute2 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute3 |
可选 |
System.String |
ConditionalCustomAttribute3 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute4 |
可选 |
System.String |
ConditionalCustomAttribute4 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute5 |
可选 |
System.String |
ConditionalCustomAttribute5 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute6 |
可选 |
System.String |
ConditionalCustomAttribute6 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute7 |
可选 |
System.String |
ConditionalCustomAttribute7 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute8 |
可选 |
System.String |
ConditionalCustomAttribute8 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalCustomAttribute9 |
可选 |
System.String |
ConditionalCustomAttribute9 参数指定自定义属性。可以使用这些属性存储其他信息。 |
ConditionalDepartment |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalDepartment 参数按部门进行筛选。该参数采用逗号分隔列表形式的多个值。 |
ConditionalStateOrProvince |
可选 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalStateOrProvince 参数按省/市/自治区进行筛选。该参数采用逗号分隔列表形式的多个值。 |
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 参数时,该命令将使用该对象的配置在本地服务器或目标服务器上创建完全重复的对象。 |
输入类型
返回类型
错误
错误 | 说明 |
---|---|
异常
异常 | 说明 |
---|---|
示例
以下代码是 New-EmailAddressPolicy 命令的示例。
New-EmailAddressPolicy -Name "MyPolicy" -IncludedRecipients MailboxUsers -EnabledPrimarySMTPAddressTemplate SMTP:@contoso.com