New-TransportRule
适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题： 2007-08-13
使用 New-TransportRule cmdlet，可以创建传输规则代理在处理通过安装了 Microsoft Exchange Server 2007 中心传输服务器角色或边缘传输服务器角色的计算机传递的电子邮件时使用的新传输规则。
语法
New-TransportRule -Name <String> -Actions <TransportRuleAction[]> [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Exceptions <TransportRulePredicate[]>] [-Priority <Int32>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
详细说明
使用 New-TransportRule cmdlet，可以创建传输规则代理在处理 Exchange 2007 组织中通过安装了中心传输服务器或边缘传输服务器的计算机传递的电子邮件时使用的新传输规则。
每个条件和例外必须使用支持的规则谓词。每个谓词由谓词本身以及要进行测试的值组成。
有关支持的传输规则谓词的列表，请参阅传输规则谓词。
每个操作必须使用支持的规则操作。每个操作由操作本身以及操作执行其任务时使用的值组成。
有关支持的传输规则操作的列表，请参阅传输规则操作。
有关如何新建传输规则的详细信息，请参阅如何新建传输规则。
有关传输规则代理的信息，请参阅传输规则概述。
若要运行 New-TransportRule cmdlet，必须为您使用的帐户委派下列角色：
- Exchange 组织管理员角色
若要在安装了边缘传输服务器角色的计算机上运行 New-TransportRule cmdlet，必须使用作为该计算机的本地 Administrators 组成员的帐户登录。
有关管理 Exchange 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。
参数
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
Actions |
必需 |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[] |
使用此参数可以指定在满足所有条件但不满足任何例外时传输规则应用于电子邮件的操作。必须为每个规则至少指定一个操作。 |
Name |
必需 |
System.String |
使用此参数可以指定要创建的传输规则的显示名。名称长度不能超过 64 个字符。 |
Comments |
可选 |
System.String |
使用此参数可以将信息注释（例如，规则用于何种操作或者它如何随时间而更改）添加到规则。注释的长度不能超过 1024 个字符。 |
Conditions |
可选 |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
使用此参数可以指定传输规则应用于提交到传输规则代理的电子邮件的条件。如果未对某个规则配置条件，则在不符合任何例外时将对所有邮件应用此规则。 |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
Confirm 参数将导致命令暂停处理，并且需要您在继续处理之前确认该命令将执行的操作。您不必使用 Confirm 参数指定值。 |
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
若要指定用于从 Active Directory 目录服务检索数据的域控制器的完全限定的域名 (FQDN)，请在命令中包含 DomainController 参数。运行边缘传输服务器角色的计算机不支持 DomainController 参数。边缘传输服务器角色只会写入本地 Active Directory 应用程序模式 (ADAM) 实例。 |
Enabled |
可选 |
System.Boolean |
使用此参数指定在创建后是启用还是禁用传输规则。默认值为 |
Exceptions |
可选 |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
使用此参数指定传输规则应用于电子邮件的例外。如果邮件符合任何例外，则不会对此邮件应用为此规则指定的任何操作。 |
Priority |
可选 |
System.Int32 |
使用此参数指定应用传输规则的顺序。如果修改规则的优先级，则规则列表中的规则位置也会相应更改，以便与指定的优先级相匹配，传输规则代理会增加所有规则的优先级值。首先处理优先级值较低的规则。此参数的值必须大于或等于 0。 |
TemplateInstance |
可选 |
System.Management.Automation.PSObject |
将现有对象提供给此参数时，该命令将使用对象的配置在本地服务器或目标服务器上创建对象的相同副本。有关详细信息，请参阅模板。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
WhatIf 参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。 |
输入类型
返回类型
错误
| 错误 | 说明 |
|---|---|
|
|
异常
| 异常 | 说明 |
|---|---|
|
|
示例
以下示例显示了如何在中心传输服务器上创建新的传输规则。
此规则应用下列条件：
- 在通讯组列表和通讯组列表之间 此条件的第一个谓词属性值是通讯组对象“Sales Group”。此条件的第二个谓词属性值是通讯组“Brokerage Group”。
应用下列例外：
主题中使用文本模式 该例外的值为“Press Release”或“Corporate Communication”。
发件人 此例外的值是用户 Ted Bremer 和 Pilar Ackerman。
下列操作将应用于任何符合上述条件但是不符合“主题中使用文本模式”或“发件人”例外的邮件：
向发件人发送退回邮件 此操作的值为“E-mail messages sent between the Sales department and the Brokerage department are prohibited”。
记录邮件事件 此操作的值是“A prohibited e-mail message has been rejected”。
$Condition1 = Get-TransportRulePredicate BetweenMemberOf
$Condition1.Addresses = @((Get-DistributionGroup "Sales Group"))
$Condition1.Addresses2 = @((Get-DistributionGroup "Brokerage Group"))
$Exception1 = GetTransportRulePredicate From
$Exception1.Addresses = @((Get-MailUser "Ted Bremer"), (Get-MailUser "Pilar Ackerman"))
$Exception2 = Get-TransportRulePredicate SubjectContains
$Exception2.Words = @("Press Release", "Corporate Communication")
$Action1 = Get-TransportRuleAction RejectMessage
$Action1.RejectReason = "E-mail messages sent between the Sales department and the Brokerage department are prohibited."
$Action2 = Get-TransportRuleAction LogEvent
$Action2.EventMessage = "A prohibited e-mail message has been rejected."
New-TransportRule -name "Block e-mail messages between Sales and Brokerage groups" -Condition @($Condition1) -Exception @($Exception1, $Exception2) -Action @($Action1, $Action2)