Set-TransportRule
適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上次修改主題的時間： 2007-07-27
使用 Set-TransportRule 指令程式，可修改傳輸規則代理程式在處理通過電腦 (此電腦已安裝 Hub Transport server role 或 Edge Transport server role ) 的電子郵件時，所使用的現有傳輸規則。
語法
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 指令程式，可讓您修改傳輸規則代理程式在處理通過 Hub Transport Server 或 Edge Transport Server 的電子郵件時，所使用的現有傳輸規則。
每個條件與例外狀況均須使用受支援的傳輸規則述詞。每個述詞包含至少一個條件，以及用以測試條件的值。
如需所支援之傳輸規則述詞的清單，請參閱傳輸規則述詞。
每個動作都必須使用受支援的傳輸規則動作。每個動作包含至少一個動作，以及該動作用以執行工作的值。
如需所支援之規則動作的清單，請參閱傳輸規則動作。
如需如何修改現有傳輸規則的詳細資訊，請參閱如何修改傳輸規則。
如需傳輸規則代理程式的相關資訊，請參閱傳輸規則的概觀。
若要執行 Set-TransportRule 指令程式，您使用的帳戶必須已委派下列資格：
- Exchange 組織系統管理員角色
若要在已安裝 Edge Transport server role 的電腦上執行 Set-TransportRule 指令程式，則必須使用屬於該電腦之本機 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 參數。執行 Edge Transport server role 的電腦不支援 DomainController 參數。Edge Transport server role 只會寫入至本機 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 參數指定任何值。 |
輸入類型
傳回類型
錯誤
| 錯誤 | 描述 |
|---|---|
|
|
例外狀況
| 例外狀況 | 描述 |
|---|---|
|
|
範例
以下範例將完整說明如何修改 Hub Transport Server 上的現有傳輸規則。本範例顯示如何修改傳輸規則中的條件，而不影響相同規則中的例外狀況或動作。
此規則將修改為套用下列條件：
- 來自通訊群組清單成員 此條件的值為通訊群組 "Sales Group"。
$Condition = Get-TransportRulePredicate FromMemberOf
$Condition.Addresses = @((Get-DistributionGroup "Sales Group"))
Set-TransportRule "Sales-Brokerage Wall" -Condition @($condition)