複製內容搜尋

在 Microsoft 365 的 Microsoft Purview 入口網站中建立內容搜尋，以搜尋許多信箱或 SharePoint 和商務商務用 OneDrive 網站可能需要一段時間。 如果您輸入錯誤的 URL，指定要搜尋的網站也容易出錯。 若要避免這些問題，您可以使用本文中的 Windows PowerShell 腳本來快速複製現有的內容搜尋。 當您複製搜尋時，會建立具有不同名稱) 的新搜尋 (，其中包含與原始搜尋相同的屬性 (，例如內容位置和搜尋查詢) 。 然後，您可以透過變更關鍵字查詢或日期範圍來編輯新搜尋，然後執行它。

為什麼要複製內容搜尋？

• 若要比較不同關鍵字的結果，請在相同的內容位置執行查詢。

• 省去您在建立新搜尋時必須重新輸入大量內容位置。

• 減小搜尋結果的大小。 例如，如果您的搜尋傳回太多要匯出的結果，您可以複製搜尋，然後根據日期範圍新增搜尋條件，以減少搜尋結果的數目。

指令碼資訊

• 您必須安裝 Exchange Online PowerShell 模組。 如需指示，請參閱 安裝和維護 Exchange Online PowerShell 模組。

• 您必須是 Microsoft Purview 入口網站中電子檔探索管理員角色群組的成員，才能執行本主題中所述的腳本。

• 該腳本包含最少的錯誤處理。 指令碼的主要目的是快速複製內容搜尋。

• 指令碼會建立新的內容搜尋，但不會啟動它。

• 此腳本會考慮您要複製的內容搜尋是否與電子檔探索案例相關聯。 如果搜尋與案例相關聯，則新搜尋也會與相同的案例相關聯。 如果現有的搜尋未與案例相關聯，新的搜尋將會列在 Microsoft Purview 入口網站的 [ 內容搜尋 ] 頁面上。

• 本主題中提供的範例腳本不受任何 Microsoft 標準支援計劃或服務支援。 範例指令碼係依「現狀」提供，不含任何種類的擔保方式。 Microsoft 另外不承擔任何明示或默示的擔保，包括但不限於適售性或適合某特定用途的默示擔保。 使用或操作範例指令碼和文件發生的所有風險，皆屬於您的責任。 Microsoft、其作者以及其他與建置、生產或交付程式碼相關的任何人在任何情況下皆完全不需對任何損失負責任，包括但不限於商業利潤損失、業務中斷、業務資訊損失、或其他錢財損失等因使用或無法使用範例指令碼或文件所發生的損失，即使 Microsoft 曾建議這些損失發生的可能性。

步驟 1：執行指令碼以複製搜尋

此步驟中的指令碼將透過複製現有的內容搜尋來建立新的內容搜尋。 當您執行此指令碼時，系統會提示您輸入下列資訊：

• 您的使用者認證 - 腳本會使用您的認證來連線到安全性 & 合規性 PowerShell。 如先前所述，您必須是 Microsoft Purview 入口網站中電子檔探索管理員角色群組的成員，才能執行腳本。

• 現有搜尋的名稱 — 這是您要複製的內容搜尋。

• 將建立之新搜尋的名稱 - 如果您將此值保留空白，指令碼將根據您要複製的搜尋名稱，為新搜尋建立名稱。

若要複製搜尋：

1. 使用檔案名稱尾碼 .ps1 將下列文字儲存至 Windows PowerShell 指令碼檔案，例如 CloneSearch.ps1。

   # This PowerShell script clones an existing content search in Microsoft Purview compliance.
   
   # Ask for the name of the search you want to clone
   $searchName = Read-Host 'Enter the name of the search that you want to clone'
   # Ask for the name of the new search
   $newSearchName = Read-Host 'Enter a name for the new search [leave blank to automatically generate a name]'
   $originalSearch = Get-ComplianceSearch $searchName -EA SilentlyContinue
   # Make sure we have a valid search before continuing
   if(!$originalSearch)
   {
       Write-Error "Couldn't find search: $searchName"
       return
   }
   $searchNameCounter = 1
   # Find a suitable name for the new search
   while(!$newSearchName)
   {
       $newSearchName = $originalSearch.Name + "_" + $searchNameCounter
       $tempSearch = Get-ComplianceSearch $newSearchName -EA SilentlyContinue
       if ($tempSearch)
       {
           $newSearchName = $null
           $searchNameCounter++
       }
   }
   $caseName
   # Determine if the search is part of a case; if so get the case name
   if ($originalSearch.CaseId)
   {
       $searchCase = Get-ComplianceCase $originalSearch.CaseId
       $caseName = $searchCase.Name
   }
   # Need to cast this value as a Boolean the old fashion way
   $allowNotFoundExchangeLocationsEnabled = $false
   if ($originalSearch.AllowNotFoundExchangeLocationsEnabled)
   {
       $allowNotFoundExchangeLocationsEnabled = $true
   }
   $newSearch = New-ComplianceSearch -Name $newSearchName -AllowNotFoundExchangeLocationsEnabled $allowNotFoundExchangeLocationsEnabled -Case $caseName -ContentMatchQuery $originalSearch.ContentMatchQuery -Description $originalSearch.Description -ExchangeLocation $originalSearch.ExchangeLocation -ExchangeLocationExclusion $originalSearch.ExchangeLocationExclusion -Language $originalSearch.Language -SharePointLocation $originalSearch.SharePointLocation -SharePointLocationExclusion $originalSearch.SharePointLocationExclusion -PublicFolderLocation $originalSearch.PublicFolderLocation
   if ($newSearch)
   {
       Write-Host $newSearch.Name "was successfully created" -ForegroundColor Yellow
   }
   

2. 連線至安全性與合規性 PowerShell。 在相同的 PowerShell 視窗中，移至您儲存腳本的資料夾。

3. 執行指令碼;比如：

   .\CloneSearch.ps1
   

4. 指令碼提示時輸入下列資訊。 輸入每項資訊，然後按 Enter。

   • 現有搜尋的名稱。
   • 新搜尋的名稱。

   指令碼會建立新的內容搜尋，但不會啟動它。 這讓您有機會在下一步中編輯和執行搜尋。 您可以執行 Get-ComplianceSearch Cmdlet 或移至 Microsoft Purview 入口網站中的 [內容搜尋 或 電子檔探索 ] 頁面，以檢視新搜尋的屬性，視新搜尋是否與案例相關聯而定。

步驟 2：在 Microsoft Purview 入口網站中編輯並執行複製的搜尋

執行腳本以複製現有的內容搜尋之後，下一個步驟是移至 Microsoft Purview 入口網站來編輯並執行新的搜尋。 如前所述，您可以透過變更關鍵字搜尋查詢以及新增或移除搜尋條件來編輯搜尋。 如需詳細資訊，請參閱：

• Office 365 中的內容搜尋

• 內容搜尋的關鍵字查詢與搜尋條件

• 電子文件探索案例