Get-ComplianceSecurityFilter
此 Cmdlet 只能在安全性 & 合規性 PowerShell 中運作。 如需詳細資訊，請參閱 安全性與合規性 PowerShell。
使用 Get-ComplianceSecurityFilter Cmdlet 來檢視 Microsoft Purview 合規性入口網站 中的合規性安全性篩選。 這些篩選條件可讓指定的使用者只搜尋Microsoft 365 組織中的信箱和 SharePoint 或 OneDrive 網站子集。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Get-ComplianceSecurityFilter
[-Action <ComplianceSecurityFilterActionType>]
[-Confirm]
[-FilterName <String>]
[-User <String>]
[-WhatIf]
[<CommonParameters>] Description
合規性安全性篩選器可在 Microsoft Purview 合規性入口網站 (*-ComplianceSearch Cmdlet) 中使用合規性搜尋，而不是在 Exchange Online (*-MailboxSearch Cmdlet) 中 In-Place 電子檔探索搜尋。
若要在安全性與合規性 PowerShell 中使用此 Cmdlet，您必須獲得指派權限。 如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
Get-ComplianceSecurityFilter | Format-Table -Auto FilterName,Action此範例會傳回所有法規安全性篩選器的摘要清單。
範例 2
Get-ComplianceSecurityFilter -FilterName "HR Filter"此範例會傳回名為 HR Filter 之法規安全性篩選器的詳細資訊。
參數
-Action
Action 參數會依套用篩選條件的搜尋動作類型來篩選結果。 有效值為：
- 匯出：導出搜尋結果或準備在 eDiscovery Premium 中進行分析時，會套用篩選條件。
- 預覽：預覽搜尋結果時會套用篩選。
- 清除：清除搜尋結果時會套用篩選。 項目刪除方式是由 New-ComplianceSearchAction Cmdlet 上的 PurgeType 參數值所控制。 默認值為 SoftDelete，這表示用戶可復原已清除的專案，直到刪除的專案保留期間到期為止。
- 搜尋：執行搜尋時會套用篩選。
- Search：執行搜尋時才會套用篩選器。
| 類型: | ComplianceSecurityFilterActionType |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
| 適用於: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
| 適用於: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-FilterName
FilterName 參數會指定您要檢視的法規安全性篩選器名稱。 如果值包含空格，請使用引號 (") 括住值。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
| 適用於: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-User
User 參數會依取得套用至其搜尋之篩選條件的使用者篩選結果。 有效值為：
- 使用者的別名或電子郵件地址。
- 值 All。
- 角色群組的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
| 適用於: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-WhatIf
WhatIf 開關無法在安全性與合規性 PowerShell 中使用。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
| 適用於: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |