共用方式為

Set-ComplianceSearch

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Server 2016, Exchange Server 2019, Security & Compliance

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

使用 Set-ComplianceSearch Cmdlet 來修改 Exchange Server 2016 或更新版本和 Microsoft Purview 合規性入口網站 中的非執行合規性搜尋。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Set-ComplianceSearch
   [-Identity] <ComplianceSearchIdParameter>
   [-AddExchangeLocation <String[]>]
   [-AddExchangeLocationExclusion <String[]>]
   [-AddSharePointLocation <String[]>]
   [-AddSharePointLocationExclusion <String[]>]
   [-AllowNotFoundExchangeLocationsEnabled <Boolean>]
   [-Confirm]
   [-ContentMatchQuery <String>]
   [-Description <String>]
   [-ExchangeLocation <String[]>]
   [-ExchangeLocationExclusion <String[]>]
   [-Force]
   [-HoldNames <String[]>]
   [-IncludeOrgContent <Boolean>]
   [-IncludeUserAppContent <Boolean>]
   [-Language <CultureInfo>]
   [-Name <String>]
   [-PublicFolderLocation <String[]>]
   [-RefinerNames <String[]>]
   [-RemoveExchangeLocation <String[]>]
   [-RemoveExchangeLocationExclusion <String[]>]
   [-RemovePublicFolderLocation <String[]>]
   [-RemoveSharePointLocation <String[]>]
   [-RemoveSharePointLocationExclusion <String[]>]
   [-SharePointLocation <String[]>]
   [-SharePointLocationExclusion <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

您必須已獲指派權限，才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限，請參閱 Find the permissions required to run any Exchange cmdlet。

在內部部署 Exchange 中，此 Cmdlet 可在信箱搜尋角色中使用。 根據預設，此角色只會指派給探索管理角色群組。

若要在安全 & 性合規性 PowerShell 中使用此 Cmdlet，您必須獲指派許可權。 如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。

範例

範例 1

Set-ComplianceSearch -Identity "Project X" -ExchangeLocation All

此範例會變更名為 Project X 的現有合規性搜尋。Exchange 搜尋的範圍會變更為所有信箱。

範例 2

Set-ComplianceSearch -Identity "Contoso Case Search 1" -HoldNames All -ExchangeLocation $null -SharePointLocation $null

此範例會變更與Microsoft Purview 合規性入口網站中電子檔探索案例相關聯的現有合規性搜尋。 搜尋範圍從搜尋選取的信箱和 SharePoint 網站變更為搜尋電子檔探索案例中已保留的所有內容位置。

範例 3

Set-ComplianceSearch -Identity "China Subsidiary Search" -Language zh-CN

本範例會將現有合規性搜尋的語言設定變更為中文。

如果您在搜尋查詢中使用非英文關鍵字， (在 ContentMatchQuery 參數中指定) ，您可能必須變更語言設定。

參數

-AddExchangeLocation

當您未針對 ExchangeLocation 參數使用 All 值時，AddExchangeLocation 參數會指定要新增至內含信箱清單的信箱。 有效值為：

  • 一般使用者信箱。 包括其他類型的信箱 (例如，非作用中信箱或Microsoft 365 來賓使用者) 是由 AllowNotFoundExchangeLocationsEnabled 參數所控制。
  • 信箱

若要指定信箱或通訊群組，請使用電子郵件地址。 您可以指定多個以逗號分隔的值。

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

-AddExchangeLocationExclusion

此參數只能在內部部署 Exchange 中運作。

當您使用 ExchangeLocation 參數的 All 值時，此參數會指定要新增至排除信箱清單的信箱。 有效值為：

  • 一般使用者信箱。 包括其他類型的信箱 (例如，非作用中信箱或Microsoft 365 來賓使用者) 是由 AllowNotFoundExchangeLocationsEnabled 參數所控制。
  • 信箱

若要指定信箱或通訊群組，請使用電子郵件地址。 您可以指定多個以逗號分隔的值。

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

-AddSharePointLocation

此參數只能在雲端式服務中使用。

當您未針對 SharePointLocation 參數使用 All 值時，AddSharePointLocation 參數會指定要新增至包含網站清單的 SharePoint Online 網站。 您可以依據其 URL 值識別網站。

您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddSharePointLocationExclusion

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AllowNotFoundExchangeLocationsEnabled

AllowNotFoundExchangeLocationsEnabled 參數會指定是否要在合規性搜尋中包含一般使用者信箱以外的信箱。 有效值為：

  • $true：搜尋不會先嘗試驗證信箱是否存在，再繼續進行。 如果您想要搜尋未解析為一般信箱的信箱，則需要此值。
  • $false：搜尋會先嘗試驗證信箱是否存在，再繼續進行。 如果您指定的信箱不是一般使用者信箱，搜尋將會失敗。 這是預設值。

受此參數值影響的信箱類型包括：

  • 非使用中的信箱
  • 沒有Exchange Online授權的使用者使用 Office 應用程式
  • 來賓使用者
  • 身分識別已與您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

-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 值。 您只能單獨使用此值。

若要指定信箱或通訊群組，請使用電子郵件地址。 您可以指定多個以逗號分隔的值。

您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。

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

-ExchangeLocationExclusion

此參數只能在內部部署 Exchange 中運作。

當您使用 ExchangeLocation 參數的 All 值時，這個參數會指定要排除的信箱。 有效值為：

  • 一般使用者信箱。 包括其他類型的信箱 (例如，非作用中信箱或Microsoft 365 來賓使用者) 是由 AllowNotFoundExchangeLocationsEnabled 參數所控制。
  • 信箱

若要指定信箱或通訊群組，請使用電子郵件地址。 您可以指定多個以逗號分隔的值。

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 參數會指定搜尋已在電子檔探索案例中保留的內容位置。 您對這個參數使用值 All。 您可以只對與 eDiscovery 案例相關聯的符合性搜尋使用這個參數。

如果合規性搜尋中的內容位置包含信箱，您也需要使用 ExchangeLocation 參數搭配值 $null。 同樣地，如果合規性搜尋包含 SharePoint 網站，您也需要使用 SharePointLocation 參數搭配值 $null。

此外，如果內容位置是放在查詢式案例保留，當您重新啟動此符合性搜尋時只會搜尋保留的項目。 例如，如果使用者放在查詢式案例保留，保留特定日期之前已傳送或已建立的項目，則只有這些項目會藉由使用這個符合性搜尋指定的搜尋準則進行搜尋。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Identity

Identity 參數會指定要修改的符合性搜尋。

當您使用這個參數時，必須使用 Identity 參數，但會忽略其值。 例如，針對 Identity 參數使用 000 這個值。

  • 名稱
  • JOBRunId (GUID)

JobRunId (GUID)

Type:ComplianceSearchIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, 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：搜尋中會包含任何 Exchange 位置參數中指定之使用者的雲端式儲存位置。 如果您針對 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

-Name

將保留此參數供 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, 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

-RemoveExchangeLocation

RemoveExchangeLocation 參數會指定當您未針對 ExchangeLocation 參數使用 All 值時，要從內含信箱清單中移除的信箱。 有效值為：

  • 當您針對 ExchangeLocation 參數使用 All 值時，此參數會指定要從排除信箱清單中移除的信箱。有效值為：
  • 信箱

若要指定信箱或通訊群組，請使用電子郵件地址。 您可以指定多個以逗號分隔的值。

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

-RemoveExchangeLocationExclusion

此參數只能在內部部署 Exchange 中運作。

當您使用 ExchangeLocation 參數的 All 值時，此參數會指定要從排除信箱清單中移除的信箱。 有效值為：

  • 當您針對 ExchangeLocation 參數使用 All 值時，此參數會指定要從排除信箱清單中移除的信箱。有效值為：
  • 信箱

若要指定信箱或通訊群組，請使用電子郵件地址。 您可以指定多個以逗號分隔的值。

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

-RemovePublicFolderLocation

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocation

此參數只能在雲端式服務中使用。

RemoveSharePointLocation 參數會指定當您未針對 SharePointLocation 參數使用 All 值時，要從包含的網站清單中移除的 SharePoint Online 網站。 您可以依據其 URL 值識別網站。

您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocationExclusion

此參數只能在雲端式服務中使用。

將保留此參數供 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

-WhatIf

WhatIf 參數無法在安全 & 性合規性 PowerShell 中運作。

WhatIf 參數會模擬命令的動作。 使用此參數時，您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。

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