Get-ComplianceSearchAction
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。
使用 Get-ComplianceSearchAction Cmdlet 來檢視合規性搜尋動作的相關資訊。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
Get-ComplianceSearchAction
[[-Identity] <ComplianceSearchActionIdParameter>]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-ComplianceSearchAction
[-Preview]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-ComplianceSearchAction
[-Purge]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-ComplianceSearchAction
[-Export]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-ResultSize <Unlimited>]
[<CommonParameters>] Description
使用 New-ComplianceSearch Cmdlet 建立並執行合規性搜尋，並使用 Start-ComplianceSearch Cmdlet 開始搜尋之後，您會使用 New-ComplianceSearchAction Cmdlet 來指派搜尋動作。 您可以使用 Get-ComplianceSearchAction Cmdlet 來追蹤合規性搜尋動作的進度。
您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
在內部部署 Exchange 中，此 Cmdlet 可在信箱搜尋角色中使用。 根據預設，此角色只會指派給探索管理角色群組。
若要在安全 & 性合規性 PowerShell 中使用此 Cmdlet，您必須獲指派許可權。 如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
Get-ComplianceSearchAction此範例顯示所有合規性搜尋動作的摘要清單。
範例 2
Get-ComplianceSearchAction -Identity "Case 1234_Preview" | Format-List此範例顯示名為 「Case 1234_Preview」 的合規性搜尋動作詳細資料
參數
-Case
此參數只能在雲端式服務中使用。
Case 參數會依指定案例的名稱來篩選結果。 如果值包含空格，請使用引號括住值。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Details
[詳細資料] 參數會指定是否要在結果中包含詳細資訊。 您不需要使用此參數指定值。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-DomainController
此參數僅適用於內部部署 Exchange。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Export
匯出參數會依匯出合規性搜尋動作來篩選結果。 您不需要使用此參數指定值。
您無法搭配身分識別、預覽或清除參數使用此參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-Identity
Identity 參數會指定您想要檢視的合規性搜尋動作。 您可以使用任何可唯一識別規範搜尋動作的值。 例如：
- 名稱：合規性搜尋動作名稱會使用 語
"Compliance Search Name_Action"法 。 例如，"Case 1234_Preview"。 - JOBRunId (GUID)
您無法搭配匯出、預覽或清除參數使用此參數。
當您使用 Identity 參數時，結果會傳回更多詳細資料。 例如：
- 在 [結果] 行中，會填入 [專案計數]、[總大小] 和 [詳細資料] 屬性的值。
- 位置線會新增至結果。
- 填入 NumBinding 屬性值。
- 受影響的位置屬性 (例如，已填入 ExchangeLocation) 。
- 已填入 CaseName 屬性值。
| Type: | ComplianceSearchActionIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-IncludeCredential
IncludeCredential 參數會指定是否要在結果中包含認證。 您不需要使用此參數指定值。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-Preview
預覽參數會依預覽合規性搜尋動作來篩選結果。 您不需要使用此參數指定值。
您無法搭配匯出、身分識別或清除參數使用此參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-Purge
注意：在安全 & 性合規性 PowerShell 中，此參數僅適用于搜尋和清除角色。 根據預設，此角色只會指派給組織管理和資料管理角色群組。
清除參數會依清除合規性搜尋動作來篩選結果。 您不需要使用此參數指定值。
您無法搭配匯出、身分識別或預覽參數使用此參數。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-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 2016, Exchange Server 2019, Security & Compliance |