Get-TransportRule

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

使用 Get-TransportRule Cmdlet 來檢視組織中) 的傳輸規則 (郵件流程規則。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Get-TransportRule
   [[-Identity] <RuleIdParameter>]
   [-DomainController <Fqdn>]
   [-State <RuleState>]
   [-DlpPolicy <String>]
   [-ExcludeConditionActionDetails <Boolean>]
   [-Filter <String>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Description

在信箱伺服器上，此 Cmdlet 會傳回儲存在 Active Directory 中的 Exchange 組織中的所有規則。 在 Edge Transport Server 上，此 Cmdlet 只會傳回在本機伺服器上設定的規則。

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-TransportRule

此範例會傳回組織中所有規則的摘要清單。

範例 2

Get-TransportRule "Ethical Wall - Sales and Brokerage Departments" | Format-List

此範例會傳回名為「道德牆 - 銷售部門和政治部門」規則的詳細資訊。

如需管線的詳細資訊，請參閱 關於管線。 如需如何使用命令輸出的詳細資訊，請參閱 使用命令輸出。

範例 3

Get-TransportRule -DlpPolicy "PII (U.S.)"

此範例會傳回規則的摘要清單，這些規則會強制執行組織中名為 PII (美國) 的 DLP 原則。

範例 4

Get-TransportRule | Where {$_.DlpPolicy -ne $null}

此範例會傳回組織中強制執行 DLP 原則之所有規則的摘要清單。

參數

-DlpPolicy

DlpPolicy 參數會依指定之資料外泄防護 (DLP) 原則的名稱來篩選結果。 如果值包含空格，請使用引號 (") 括住值。

組織的 DLP 原則可避免您的敏感資料在無意間洩漏。 每個 DLP 原則皆強制使用一組傳輸規則。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

此參數僅適用於內部部署 Exchange。

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。

Edge Transport Server 不支援 DomainController 參數。 Edge Transport Server 會使用 Active Directory 輕量型目錄服務 (AD LDS) 的本機執行個體來讀寫資料。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExcludeConditionActionDetails

此參數只能在雲端式服務中使用。

ExcludeConditionActionDetails 參數會指定是否要隱藏結果的特定詳細資料。 有效值為：

  • $true：[描述]、[條件] 和 [動作] 屬性，以及任何已設定的條件、例外狀況和動作屬性值都是空白的。
  • $false：不會隱藏任何屬性或屬性值。 這是預設值。
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Filter

Filter 參數會使用 OPATH 來篩選結果。 此參數會搜尋 Description 內容，該內容包含傳輸規則的條件、例外狀況、動作和相關值。

這個參數會使用 語 "Description -like 'Text*'" 法 。 例如，"Description -like '192.168.1.1*'"。

如需 Exchange 中 OPATH 篩選的詳細資訊，請參閱 其他 OPATH 語法資訊。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-Identity

Identity 參數會指定您想要檢視的規則。 您可以使用唯一識別規則的任何值。 例如：

  • 名稱
  • 辨別名稱 (DN)
  • GUID
Type:RuleIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-ResultSize

ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。 預設值為 1000。

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-State

State 參數會指定依啟用或停用的規則來篩選結果。 有效值為：

  • 已啟用：結果中只會傳回已啟用的規則。
  • 已停用：結果中只會傳回已停用的規則。

如果您未使用此參數，該命令會傳回包含已啟用及停用的所有規則。

Type:RuleState
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

輸入

Input types

若要查看此指令程式可接受的輸入類型，請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的，表示指令程式不接受輸入資料。

輸出

Output types

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型)，請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的，表示指令程式不會傳回資料。