複製內容搜尋

在 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 中的內容搜尋

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

• 電子文件探索案例