New-ComplianceSearch
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能只限於某一環境。
使用 New-ComplianceSearch 指令碼在 2016 Exchange Server 或之後及 Microsoft Purview 合規性入口網站 建立合規搜尋。 您可以使用此 Cmdlet 來定義搜尋準則。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
注意事項
在雲端，此指令小程式有以下需求：
- Exchange Online PowerShell 模組版本 3.9.0 或更新版本 (2025 年 8 月) 。
- 執行 Connect-IPPSSession 指令連接 Security & Compliance PowerShell 時，請使用 EnableSearchOnlySession 參數。
語法
Default (預設值)
New-ComplianceSearch
[-Name] <String>
[-AllowNotFoundExchangeLocationsEnabled <Boolean>]
[-Case <String>]
[-Confirm]
[-ContentMatchQuery <String>]
[-Description <String>]
[-ExchangeLocation <String[]>]
[-ExchangeLocationExclusion <String[]>]
[-Force]
[-HoldNames <String[]>]
[-IncludeOrgContent <Boolean>]
[-IncludeUserAppContent <Boolean>]
[-Language <CultureInfo>]
[-LogLevel <ComplianceJobLogLevel>]
[-PublicFolderLocation <String[]>]
[-RefinerNames <String[]>]
[-SharePointLocation <String[]>]
[-SharePointLocationExclusion <String[]>]
[-StatusMailRecipients <String[]>]
[-WhatIf]
[<CommonParameters>]
Description
符合性搜尋至少需要一個位置。 例如，使用 ExchangeLocation 參數的信箱，或使用 SharePointLocation 參數的 SharePoint 網站。
使用 New-ComplianceSearch Cmdlet 建立符合性搜尋之後，您可使用 Start-ComplianceSearch Cmdlet 執行搜尋。
您必須已獲指派權限，才能執行此指令程式。 雖然這篇文章列出了 cmdlet 的所有參數，但如果某些參數未包含在你分配的權限中，你可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
在本地 Exchange 中，此指令小子可於郵件匣搜尋角色中使用。 預設情況下，此角色僅指派給發現管理角色群組。
若要在安全性與合規性 PowerShell 中使用此 Cmdlet，您必須獲得指派權限。 如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。
範例
範例 1
New-ComplianceSearch -Name "Hold Project X" -ExchangeLocation "Finance Department"
此範例會建立名為 Hold-Project X 的新符合性搜尋，以搜尋名為 Finance Department 之通訊群組的所有成員。 因為此搜尋不會使用 ContentMatchQuery 參數，所以會搜尋信箱中的所有項目。
範例 2
New-ComplianceSearch -Name "Hold-Tailspin Toys" -ExchangeLocation "Research Department" -ContentMatchQuery "'Patent' AND 'Project Tailspin Toys'"
此範例會建立名為 Hold-Tailspin Toys 的新符合性搜尋，以搜尋名為 Research Department 之通訊群組的所有成員。 因為此搜尋會使用 ContentMatchQuery 參數，所以只會搜尋符合查詢的郵件。
範例 3
New-ComplianceSearch -Name "AnnBeebe-InactiveMailbox" -ExchangeLocation .annb@contoso.onmicrosoft.com -AllowNotFoundExchangeLocationsEnabled $true
此範例會建立一個名為 AnnBeebe-InactiveMailbox 的新合規搜尋，搜尋非活躍信箱並回傳信箱內所有項目。 要搜尋非活躍信箱，你需要使用該非活躍信箱的主要 SMTP 地址，並在前加上句號 (」。) 。 你還需要加入 AllowNotFoundExchangeLocationsEnabled 參數，這樣搜尋才不會嘗試驗證非活躍信箱的存在。
參數
-AllowNotFoundExchangeLocationsEnabled
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
AllowNotFoundExchangeLocationsEnabled 參數指定是否在合規搜尋中包含除一般使用者信箱以外的信箱。 有效值為：
- $true：搜尋不會在繼續前驗證信箱的存在。 如果你想搜尋那些不結算為一般信箱的信箱，這個值是必須的。
- $false：搜尋會先確認信箱的存在，然後再進行。 如果你指定一個不是一般使用者信箱的信箱，搜尋就會失敗。 這個值是預設值。
受此參數值影響的信箱類型包括：
- 非使用中的信箱
- 沒有 Exchange Online 授權但使用 Office 應用程式的使用者
- Microsoft 365 訪客用戶
- 與您的 Microsoft 365 組織同步身份的本地用戶
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Case
適用：安全性 & 合規
此參數只能在雲端式服務中使用。
Case 參數指定了 eDiscovery Standard 案件名稱，用於關聯新的合規性搜尋。 如果值包含空格，請使用引號括住值。
你無法使用此參數來建立與電子發現高級案件相關的合規性搜尋。
如果 Name 參數包含空格，當你使用 Case 參數時，ExchangeLocation 參數的值會被清除。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-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 |
-ContentMatchQuery
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
ContentMatchQuery 參數會指定內容搜尋篩選器。
此參數使用利用關鍵字查詢語言 (KQL) 格式化的文字搜尋字串或查詢。 欲了解更多資訊，請參閱 關鍵字查詢語言 (KQL) 語法參考及 eDiscovery 的關鍵字查詢與搜尋條件。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Description
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
Description 參數會指定符合性搜尋的選用描述。 如果值包含空格，請使用引號括住值。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExchangeLocation
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
ExchangeLocation 參數指定要包含的信箱。 有效值為：
- 一個普通使用者的信箱。 包括其他類型的信箱 (例如非活躍信箱或Microsoft 365 訪客用戶) 由 AllowNotFoundExchangeLocationsEnabled 參數控制。
- 信箱
- 價值：All for all for all mailboxes。 你只能單獨使用這個數值。
若要指定信箱或分發群組，請使用電子郵件地址。 您可以指定多個以逗號分隔的值。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-ExchangeLocationExclusion
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
此參數只能在內部部署 Exchange 中運作。
此參數指定在 ExchangeLocation 參數中使用 All 值時要排除的信箱。 有效值為：
- ExchangeLocation 參數會指定要包含在原則中的信箱。有效值為：
- 信箱
若要指定信箱或分發群組，請使用電子郵件地址。 您可以指定多個以逗號分隔的值。
參數屬性
| 類型: | String[] |
| 預設值: | 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 |
-HoldNames
適用：安全性 & 合規
此參數只能在雲端式服務中使用。
HoldNames 參數指定在指定電子發現案件中被保留的內容位置會被搜尋。 您可對此參數使用 All 值。 您也需要藉由使用 Case 參數來指定 eDiscovery 案例的名稱。
此外，若內容位置被置於基於查詢的案件暫停狀態，執行合規搜尋時只會搜尋暫停中的項目。 例如，如果使用者放在查詢式案例保留，保留特定日期之前已傳送或已建立的項目，則只有這些項目會藉由使用這個符合性搜尋指定的搜尋準則進行搜尋。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludeOrgContent
適用：安全性 & 合規
{{ Fill IncludeOrgContent 描述 }}
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludeUserAppContent
適用：安全性 & 合規
此參數只能在雲端式服務中使用。
IncludeUserAppContent 參數指定你想搜尋雲端儲存位置，尋找組織中沒有一般 Microsoft 365 使用者帳號的使用者。 這類使用者包括沒有 Exchange Online 授權但使用 Office 應用程式的使用者、Microsoft 365 訪客用戶，以及與你的 Microsoft 365 組織同步身份的本地用戶。 有效值為：
- $true：ExchangeLocation 參數中指定的使用者的雲端儲存位置也包含在搜尋中。 若使用 ExchangeLocation 參數的 All 值，則任何訪客或本地使用者的雲端儲存位置都會包含在搜尋中。
- $false：ExchangeLocation 參數中指定的使用者雲端儲存位置未包含在搜尋中。 這個值是預設值。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Language
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
Language 參數會指定符合性搜尋的語言。
此參數的有效輸入是來自 Microsoft .NET Framework CultureInfo 類別的支援文化程式碼值。 例如，丹麥文為 da-DK 或日文為 ja-JP。 如需詳細資訊，請參閱 CultureInfo 類別。
參數屬性
| 類型: | CultureInfo |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-LogLevel
適用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | ComplianceJobLogLevel |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
名稱參數指定合規搜尋的名稱。 如果值包含空格，請使用引號括住值。
如果你打算使用 Case 參數，請不要在這個參數值中使用空格。 如果 Name 參數包含空格，當你使用 Case 參數時，ExchangeLocation 參數的值會被清除。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PublicFolderLocation
適用：安全性 & 合規
此參數只能在雲端式服務中使用。
PublicFolderLocation 參數指定您要在搜尋中包含所有的公用資料夾。 您可對此參數使用 All 值。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RefinerNames
適用：安全性 & 合規
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SharePointLocation
適用：安全性 & 合規
此參數只能在雲端式服務中使用。
SharePointLocation 參數指定要包含的 SharePoint 網站。 您依據其 URL 值識別網站，或者您可以使用 All 值以包含所有網站。
您可以輸入多個以逗號分隔的值。 如果這些值包含空格或需要引號，請使用下列語法: "Value1","Value2",..."ValueN"。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SharePointLocationExclusion
適用：安全性 & 合規
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-StatusMailRecipients
適用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此參數僅適用於內部部署 Exchange。
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
適用：2016 Exchange Server、2019 Exchange Server、Exchange Server SE、安全 & 合規
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | 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。