Get-ComplianceSearchAction
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能只限於某一環境。
使用 Get-ComplianceSearchAction 指令小程式查看有關合規搜尋行動的資訊。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Identity
Get-ComplianceSearchAction
[[-Identity] <ComplianceSearchActionIdParameter>]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Preview
Get-ComplianceSearchAction
[-Preview]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Purge
Get-ComplianceSearchAction
[-Purge]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Export
Get-ComplianceSearchAction
[-Export]
[-Case <String>]
[-Details]
[-DomainController <Fqdn>]
[-IncludeCredential]
[-Organization <OrganizationIdParameter>]
[-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 中，此指令小子可於郵件匣搜尋角色中使用。 預設情況下，此角色僅指派給發現管理角色群組。
若要在安全性與合規性 PowerShell 中使用此 Cmdlet，您必須獲得指派權限。 如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
Get-ComplianceSearchAction
此範例展示了所有合規搜尋行動的摘要清單。
範例 2
Get-ComplianceSearchAction -Identity "Case 1234_Preview" | Format-List
此範例展示了名為「案例1234_Preview」的合規搜尋動作的詳細資訊
參數
-Case
適用：安全性 & 合規
此參數只能在雲端式服務中使用。
案例參數會依指定案例名稱過濾結果。 如果值包含空格，請使用引號括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Details
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
細節切換則指定是否在結果中包含詳細資訊。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DomainController
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
此參數只能在內部部署 Exchange 中運作。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如，dc01.contoso.com。
參數屬性
| 類型: | Fqdn |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Export
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
注意：自2025年5月26日起，此參數不再運作。 欲了解更多資訊，請參閱 Microsoft Purview 電子文件探索即將變更。
匯出開關會依照匯出合規搜尋動作篩選結果。 您不需要使用此參數指定值。
你不能用這個開關搭配身份、預覽或清除參數。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Export
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
Identity 參數指定你想查看的合規搜尋動作。 您可以使用任何可唯一識別規範搜尋動作的值。 例如：
- 名稱：合規性搜尋動作名稱使用語法
"Compliance Search Name_Action"。 例如，"Case 1234_Preview"。 - JobRunId (GUID)
你不能用這個參數搭配匯出、預覽或清除參數。
使用身份參數時，結果會回傳更多細節。 例如：
- 在結果欄位，會填入項目數量、總大小和細節屬性的數值。
- 結果中會加入位置線。
- NumBindings 屬性值已被填入。 此屬性包含主要信箱、主檔案庫，以及搜尋中使用者的其他檔案。 NumBindings 並非搜尋中包含的使用者數量，因為每個包含的使用者可能擁有或沒有主要信箱、主封存檔及額外封存檔的組合。
- 受影響的地點屬性 (例如 ExchangeLocation) 會被填入。
- CaseName 屬性值已被填入。
注意：Identity 參數的值$null或不存在的值，會回傳 所有 物件，就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確，且不包含不存在的 $null 值。
參數屬性
| 類型: | ComplianceSearchActionIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Identity
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-IncludeCredential
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
IncludeCredential 開關則指定是否將該憑證納入結果。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Organization
適用：安全性 & 合規
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | OrganizationIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Preview
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
預覽開關會依照預覽合規的搜尋動作來篩選結果。 您不需要使用此參數指定值。
你不能用這個開關搭配 Export、Identity 或 Purge 參數。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Preview
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Purge
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
注意：在安全 & 合規 PowerShell 中，此參數僅在搜尋與清除角色中提供。 預設情況下，此角色僅指派給組織管理與資料調查員角色群組。
清除開關會依照清除合規性搜尋動作來過濾結果。 您不需要使用此參數指定值。
你無法用這個開關搭配匯出、身份或預覽參數。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Purge
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResultSize
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。 預設值為 1000。
參數屬性
| 類型: | Unlimited |
| 預設值: | 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。