New-TransportRule
適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上次修改主題的時間： 2007-08-13
New-TransportRule 指令程式可用來建立傳輸規則代理程式在處理通過已安裝 Microsoft Exchange Server 2007 Hub Transport server role 或 Edge Transport server role 之電腦的電子郵件時，所使用的新傳輸規則。
語法
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 指令程式可讓您建立傳輸規則代理程式在處理通過 Exchange 2007 組織中之 Hub Transport Server 或 Edge Transport Server 的電子郵件時，所使用的新傳輸規則。
每個條件及例外狀況都必須使用支援的規則述詞。每個述詞都由述詞本身與您想測試的值所組成。
如需所支援之傳輸規則述詞的清單，請參閱傳輸規則述詞。
每個動作都必須使用支援的規則動作。每個動作都由是動作本身與動作用來執行其工作的值所組成。
如需可支援之傳輸規則動作的清單，請參閱傳輸規則動作。
如需如何建立新傳輸規則的詳細資訊，請參閱如何建立新的傳輸規則。
如需傳輸規則代理程式的相關資訊，請參閱傳輸規則的概觀。
若要執行 New-TransportRule 指令程式，必須對您使用的帳戶委派下列項目：
- Exchange 組織系統管理員角色
若要在已安裝 Edge Transport server role 的電腦上執行 New-TransportRule 指令程式，則必須使用該電腦之本機 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 參數。執行 Edge Transport server role 的電腦不支援 DomainController 參數。Edge Transport server role 只會寫入至本機 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 參數指定任何值。 |
輸入類型
傳回類型
錯誤
| 錯誤 | 描述 |
|---|---|
|
|
例外狀況
| 例外狀況 | 描述 |
|---|---|
|
|
範例
下列範例顯示如何在 Hub Transport Server 上建立新的傳輸規則。
此規則會套用下列條件：
- 通訊群組清單與通訊群組清單之間 此條件的第一個述詞內容值是 "Sales Group" 通訊群組。此條件的第二個述詞內容值是 "Brokerage Group" 通訊群組。
會套用下列例外狀況：
- 主旨中具有文字模式 此例外狀況的值是 "Press Release" 或 "Corporate Communication"。
- 來自人員 此例外狀況的值是使用者 Ted Bremer 與 Pilar Ackerman。
下列動作會套用到符合先前所述條件，但不符合「主旨中含有文字模式」或「來自人員」例外狀況的任何郵件：
- 傳送來回傳送的郵件給寄件者 此動作的這個值是「禁止在業務部門與經紀部門間傳送的電子郵件」。
- 使用郵件記錄事件 此動作的值為「已拒絕禁止的電子郵件」。
$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)
若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.