Start-ComplianceSearch
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能只限於某一環境。
使用 Start-ComplianceSearch 指令小程式可啟動 2016 Exchange Server 或之後及 Microsoft Purview 合規性入口網站 的合規搜尋，包括停止、已完成或未開始的合規搜尋。
注意事項
在雲端，此指令小程式有以下需求：
- Exchange Online PowerShell 模組版本 3.9.0 或更新版本 (2025 年 8 月) 。
- 執行 Connect-IPPSSession 指令連接 Security & Compliance PowerShell 時，請使用 EnableSearchOnlySession 參數。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Start-ComplianceSearch
[-Identity] <ComplianceSearchIdParameter>
[-Confirm]
[-Force]
[-RetryOnError]
[-WhatIf]
[<CommonParameters>]
Description
您必須已獲指派權限，才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
在本地 Exchange 中，此指令小子可於郵件匣搜尋角色中使用。 預設情況下，此角色僅指派給發現管理角色群組。
若要在安全性與合規性 PowerShell 中使用此 Cmdlet，您必須獲得指派權限。 如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
Start-ComplianceSearch -Identity "Case 1234"
此範例會啟動名為 Case 1234 的符合性搜尋
參數
-Confirm
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 破壞性的 Cmdlet (如 Remove-* cmdlets) 有內建暫停，它會先強迫您確認命令才會繼續作業。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (如 New-* 和 Set-* cmdlets) 則沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 參見 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
力場開關會隱藏警告或確認訊息。 您不需要使用此參數指定值。
在不適合提示系統管理員輸入的場合中，您可以使用此參數來利用程式設計方式執行工作。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
Identity 參數會指定要啟動的符合性搜尋。
當您使用這個參數時，必須使用 Identity 參數，但會忽略其值。 例如，針對 Identity 參數使用 000 這個值。
- 名稱
- JobRunId (GUID)
JobRunId (GUID)
參數屬性
| 類型: | ComplianceSearchIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-RetryOnError
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
RetryOnError 參數指定是否要在任何失敗的項目上重試搜尋，而不需再度重新執行整個搜尋。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
WhatIf 參數在 Microsoft Purview 合規性入口網站中無法運作。
WhatIf 參數會模擬命令的動作。 使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | 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。