Set-TransportRule
适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上一次修改主题： 2007-07-27
使用 Set-TransportRule cmdlet，可以修改传输规则代理在处理通过安装了集线器传输服务器角色或边缘传输服务器角色的计算机传递的电子邮件时使用的现有传输规则。
语法
Set-TransportRule -Identity <RuleIdParameter> [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]
Set-TransportRule [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Instance <Rule>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]
详细说明
使用 Set-TransportRule cmdlet，可以修改传输规则代理在处理通过安装了集线器传输服务器或边缘传输服务器的计算机传递的电子邮件时使用的现有传输规则。
每个条件和异常都必须使用支持的传输规则谓词。每个谓词由至少一个条件，以及作为条件测试依据的值组成。
有关支持的传输规则谓词的列表，请参阅传输规则谓词。
每个操作必须使用支持的传输规则操作。每个操作至少由一个操作，以及用于执行操作任务的值组成。
有关支持的规则操作的列表，请参阅传输规则操作。
有关如何修改现有传输规则的详细信息，请参阅如何修改传输规则。
有关传输规则代理的信息，请参阅传输规则概述。
若要运行 Set-TransportRule cmdlet，必须为您使用的帐户委派下列角色：
- Exchange 组织管理员角色
若要在已安装边缘传输服务器角色的计算机上运行 Set-TransportRule cmdlet，则用于登录的帐户必须是该计算机的本地 Administrators 组成员。
有关管理 Microsoft Exchange Server 2007 所需的权限、角色委派以及权利的详细信息，请参阅权限注意事项。
参数
| 参数 | 必需 | 类型 | 说明 |
|---|---|---|---|
Identity |
必需 |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter |
使用此参数，可以指定创建规则时管理员配置的传输规则的 GUID 或规则名称。 |
Actions |
可选 |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[] |
使用此参数可以指定在满足所有条件但不满足任何例外时传输规则应用于电子邮件的操作。必须为每个规则至少指定一个操作。 |
Comments |
可选 |
System.String |
使用此参数可以将信息注释（例如，规则用于何种操作或者它如何随时间而更改）添加到传输规则。注释的长度不能超过 512 个字符。 |
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) 实例。 |
Exceptions |
可选 |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
使用此参数指定传输规则应用于电子邮件的例外。如果邮件符合任何异常，则不会将为此规则指定的操作应用于邮件。 |
Instance |
可选 |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.Rule |
使用此参数，可以将整个对象传递给此命令进行处理。此参数主要用于必须将整个对象传递给命令的脚本。 |
Name |
可选 |
System.String |
使用此参数可以指定要创建的传输规则的显示名。名称长度不能超过 64 个字符。 |
Priority |
可选 |
System.Int32 |
使用此参数指定应用传输规则的顺序。如果修改规则的优先级，则规则列表中的规则位置也会相应更改，以便与指定的优先级相匹配，传输规则代理会增加所有规则的优先级值。首先处理优先级值较低的规则。此参数的值必须大于或等于 0。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
WhatIf 参数指示命令模拟针对对象执行的操作。通过使用 WhatIf 参数，您可以查看要发生的更改，而不必应用任何这些更改。您不必使用 WhatIf 参数指定值。 |
输入类型
返回类型
错误
| 错误 | 说明 |
|---|---|
|
|
异常
| 异常 | 说明 |
|---|---|
|
|
示例
以下完整示例显示了如何在集线器传输服务器上修改现有传输规则。此示例显示了如何在不影响传输规则的异常或操作的情况下修改此规则的条件。
将对此规则进行修改以应用以下条件：
- 来自通讯组列表的成员 此条件的值是通讯组“Sales Group”。
$Condition = Get-TransportRulePredicate FromMemberOf
$Condition.Addresses = @((Get-DistributionGroup "Sales Group"))
Set-TransportRule "Sales-Brokerage Wall" -Condition @($condition)