共用方式為

Get-HostedContentFilterRule

模組:
Exchange PowerShell

此指令小程式僅能在雲端服務中運作。

使用 Get-HostedContentFilterRule 指令碼，查看雲端組織中垃圾郵件過濾規則 (內容過濾規則) 。

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

語法

Default (預設值) 

Get-HostedContentFilterRule
    [[-Identity] <RuleIdParameter>]
    [-DomainController <Fqdn>]
    [-State <RuleState>]
    [<CommonParameters>]

Description

您必須已獲指派權限，才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

範例

範例 1

Get-HostedContentFilterRule

這個範例展示了你雲端組織中所有垃圾郵件過濾規則的摘要清單。

範例 2

Get-HostedContentFilterRule "Contoso Recipients" | Format-List

本範例取得關於名為 Contoso Recipients 的垃圾郵件過濾規則的詳細資訊。

參數

-DomainController

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

將保留此參數供 Microsoft 內部使用。

參數屬性

類型:Fqdn
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地信箱內建安全外掛

Identity 參數指定你想查看的垃圾郵件過濾規則。 您可以使用唯一識別規則的任何值。 例如：

  • 名稱
  • 辨別名稱 (DN)
  • GUID

注意：Identity 參數的值$null或不存在的值，會回傳 所有 物件，就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確，且不包含不存在的 $null 值。

參數屬性

類型:RuleIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:1
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-State

適用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online、本地信箱內建安全外掛

State 參數會依規則狀態來篩選結果。 有效值為：

  • 啟用：指令只會回傳已啟用的規則。
  • 停用：指令只會回傳已停用的規則。

參數屬性

類型:RuleState
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

Input types

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

輸出

Output types

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