New-ComplianceSearch
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。
使用 New-ComplianceSearch Cmdlet 在 Exchange Server 2016 或更新版本和 Microsoft Purview 合規性入口網站 中建立合規性搜尋。 您可以使用此 Cmdlet 來定義搜尋準則。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
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 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。
在內部部署 Exchange 中，此 Cmdlet 可在信箱搜尋角色中使用。 根據預設，此角色只會指派給探索管理角色群組。
若要在安全 & 性合規性 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
AllowNotFoundExchangeLocationsEnabled 參數會指定是否要在合規性搜尋中包含一般使用者信箱以外的信箱。 有效值為：
- $true：搜尋不會先嘗試驗證信箱是否存在，再繼續進行。 如果您想要搜尋未解析為一般信箱的信箱，則需要此值。
- $false：搜尋會先嘗試驗證信箱是否存在，再繼續進行。 如果您指定的信箱不是一般使用者信箱，搜尋將會失敗。 這是預設值。
受此參數值影響的信箱類型包括：
- 非使用中的信箱
- 沒有Exchange Online授權的使用者使用 Office 應用程式
- Microsoft 365 位來賓使用者
- 身分識別已與您Microsoft 365 組織同步的內部部署使用者
| Type: | Boolean |
| 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 |
-Case
此參數只能在雲端式服務中使用。
Case 參數會指定要與新合規性搜尋建立關聯之電子檔探索標準案例的名稱。 如果值包含空格，請使用引號括住值。
您無法使用此參數來建立與 eDiscovery Premium 案例相關聯的合規性搜尋。
如果 Name 參數包含空格，當您使用 Case 參數時，會清除 ExchangeLocation 參數的值。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
| Type: | SwitchParameter |
| Aliases: | cf |
| 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 |
-ContentMatchQuery
ContentMatchQuery 參數會指定內容搜尋篩選器。
此參數使用利用關鍵字查詢語言 (KQL) 格式化的文字搜尋字串或查詢。 如需詳細資訊，請 參閱關鍵字查詢語言 (KQL) 語法參考 和 eDiscovery 的關鍵字查詢和搜尋條件。
| Type: | String |
| 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 |
-Description
Description 參數會指定符合性搜尋的選用描述。 如果值包含空格，請使用引號括住值。
| Type: | String |
| 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 |
-ExchangeLocation
ExchangeLocation 參數會指定要包含的信箱。 有效值為：
- 一般使用者信箱。 包括其他類型的信箱 (例如，非作用中信箱或Microsoft 365 來賓使用者) 是由 AllowNotFoundExchangeLocationsEnabled 參數所控制。
- 信箱
- 所有信箱的 All 值。 您只能單獨使用此值。
若要指定信箱或通訊群組，請使用電子郵件地址。 您可以指定多個以逗號分隔的值。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-ExchangeLocationExclusion
此參數只能在內部部署 Exchange 中運作。
當您使用 ExchangeLocation 參數的 All 值時，這個參數會指定要排除的信箱。 有效值為：
- ExchangeLocation 參數會指定要包含在原則中的信箱。有效值為：
- 信箱
若要指定信箱或通訊群組，請使用電子郵件地址。 您可以指定多個以逗號分隔的值。
| Type: | String[] |
| 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 |
-Force
Force 參數會隱藏警告或確認訊息。 您不需要使用此參數指定值。
在不適合提示系統管理員輸入的場合中，您可以使用此參數來利用程式設計方式執行工作。
| 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 |
-HoldNames
此參數只能在雲端式服務中使用。
HoldNames 參數會指定將會搜尋在指定 eDiscovery 案例中保留的內容位置。 您可對此參數使用 All 值。 您也需要藉由使用 Case 參數來指定 eDiscovery 案例的名稱。
此外，如果內容位置是放在查詢式案例保留，當您執行此符合性搜尋時只會搜尋保留的項目。 例如，如果使用者放在查詢式案例保留，保留特定日期之前已傳送或已建立的項目，則只有這些項目會藉由使用這個符合性搜尋指定的搜尋準則進行搜尋。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IncludeOrgContent
{{ Fill IncludeOrgContent Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-IncludeUserAppContent
此參數只能在雲端式服務中使用。
IncludeUserAppContent 參數會指定您想要針對組織中沒有一般Microsoft 365 使用者帳戶的使用者，搜尋雲端式儲存位置。 這些類型的使用者包括沒有Exchange Online授權的使用者，他們使用 Office 應用程式、Microsoft 365 個來賓使用者，以及身分識別與您Microsoft 365 組織同步的內部部署使用者。 有效值為：
- $true：ExchangeLocation 參數中指定之使用者的雲端式儲存位置將會包含在搜尋中。 如果您針對 ExchangeLocation 參數使用 All 值，則任何來賓或內部部署使用者的雲端式儲存位置都會包含在搜尋中。
- $false：ExchangeLocation 參數中指定之使用者的雲端式儲存位置不會包含在搜尋中。 這是預設值。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Language
Language 參數會指定符合性搜尋的語言。
此參數的有效輸入是Microsoft .NET Framework CultureInfo 類別支援的文化特性程式碼值。 例如，丹麥文為 da-DK 或日文為 ja-JP。 如需詳細資訊，請參閱 CultureInfo 類別。
| Type: | CultureInfo |
| 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 |
-LogLevel
此參數僅適用於內部部署 Exchange。
將保留此參數供 Microsoft 內部使用。
| Type: | ComplianceJobLogLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-Name
Name 參數會指定合規性搜尋的名稱。 如果值包含空格，請使用引號括住值。
如果您打算使用 Case 參數，請勿在此參數的值中使用空格。 如果 Name 參數包含空格，當您使用 Case 參數時，會清除 ExchangeLocation 參數的值。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Security & Compliance |
-PublicFolderLocation
此參數只能在雲端式服務中使用。
PublicFolderLocation 參數指定您要在搜尋中包含所有的公用資料夾。 您可對此參數使用 All 值。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RefinerNames
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocation
此參數只能在雲端式服務中使用。
SharePointLocation 參數會指定要包含的 SharePoint Online 網站。 您依據其 URL 值識別網站，或者您可以使用 All 值以包含所有網站。
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-SharePointLocationExclusion
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-StatusMailRecipients
此參數僅適用於內部部署 Exchange。
將保留此參數供 Microsoft 內部使用。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-WhatIf
將保留此參數供 Microsoft 內部使用。
| Type: | SwitchParameter |
| Aliases: | wi |
| 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 |