Клонирование поиска контента

Создание поиска контента на портале соответствия требованиям Microsoft Purview в Microsoft 365, который выполняет поиск по многим почтовым ящикам или сайтам SharePoint и OneDrive для бизнеса, может занять некоторое время. Указание сайтов для поиска также может привести к ошибкам при неправильном вводе URL-адреса. Чтобы избежать этих проблем, можно использовать скрипт Windows PowerShell, приведенный в этой статье, чтобы быстро клонировать существующий поиск контента. При клонировании поиска создается новый поиск (с другим именем), который содержит те же свойства (например, расположения контента и поисковый запрос), что и исходный поиск. Затем можно изменить новый поиск, изменив запрос по ключевому слову или диапазон дат, и запустить его.

Зачем клонировать поиск контента?

• Для сравнения результатов различных поисковых запросов по ключевым словам, выполняемых в одном расположении содержимого.

• Чтобы избавить вас от необходимости повторно входить большое количество расположений содержимого при создании нового поиска.

• Уменьшение размера результатов поиска. Например, если поиск возвращает слишком много результатов, вы можете клонировать его, а затем добавить условие на основе диапазона дат, чтобы сократить количество результатов.

Сведения о скрипте

• Необходимо установить модуль Exchange Online PowerShell. Инструкции см. в статье Установка и обслуживание модуля Exchange Online PowerShell.

• Чтобы запустить скрипт, описанный в этом разделе, необходимо быть членом группы ролей eDiscovery Manager на портале соответствия требованиям Microsoft Purview.

• Скрипт включает минимальную обработку ошибок. Основная цель скрипта — быстро клонировать поиск контента.

• Скрипт создает новый поиск контента, но не запускает его.

• Этот скрипт учитывает, связан ли клонируемый поиск контента с делом обнаружения электронных данных. Если поиск связан с делом, новый поиск также будет связан с тем же делом. Если существующий поиск не связан с делом, новый поиск будет указан на странице Поиск контента на портале соответствия требованиям Microsoft Purview.

• Пример скрипта, приведенный в этом разделе, не поддерживается ни в одной стандартной программе или службе поддержки Майкрософт. Пример сценария приводится в виде "как есть", без каких-либо гарантий. Кроме того, корпорация Microsoft отказывается от всех подразумеваемых гарантий, включая в том числе все подразумеваемые гарантии пригодности для продажи или определенной цели. Все риски, возникающие в результате использования примера сценария и документации, берет на себя пользователь. Корпорация Майкрософт, ее штатные авторы и другие лица, принимающие участие в создании, подготовке и выпуске сценариев, ни при каких обстоятельствах не несут ответственность за какой-либо ущерб (в том числе, ущерб, вызванный потерей доходов предприятия, остановкой его работы, потерей бизнес-данных и другими материальными потерями), вызванный использованием или неспособностью использовать примеры сценариев и документацию, даже если корпорации Майкрософт известно о возможности нанесения такого ущерба.

Шаг 1. Запуск скрипта для клонирования поиска

Скрипт на этом шаге создаст новый поиск контента путем клонирования существующего. При выполнении этого скрипта вам будет предложено ввести следующие сведения:

• Учетные данные пользователя . Сценарий будет использовать ваши учетные данные для подключения к PowerShell для обеспечения безопасности & соответствия требованиям. Как упоминалось ранее, для запуска сценария необходимо быть членом группы ролей диспетчера обнаружения электронных данных на портале соответствия требованиям Microsoft Purview.

• Имя существующего поиска . Это поиск контента, который требуется клонировать.

• Имя нового поиска, который будет создан . Если оставить это значение пустым, скрипт создаст имя для нового поиска, основанное на имени клонирования поиска.

Чтобы клонировать поиск:

1. Сохраните следующий текст в файл скрипта Windows PowerShell с помощью суффикса имени файла .ps1; например, 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. При появлении запроса скрипта введите следующие сведения. Введите каждый фрагмент данных и нажмите клавишу ВВОД.

   • Имя существующего поиска.
   • Имя нового поиска.

   Скрипт создает новый поиск контента, но не запускает его. Это дает возможность изменить и запустить поиск на следующем шаге. Свойства нового поиска можно просмотреть, выполнив командлет Get-ComplianceSearch или перейдя на страницу Поиск контента или обнаружение электронных данных на портале соответствия требованиям Microsoft Purview в зависимости от того, связан ли новый поиск с делом.

Шаг 2. Изменение и запуск клонированного поиска на портале соответствия требованиям Microsoft Purview

После запуска скрипта для клонирования существующего поиска контента перейдите на портал соответствия требованиям Microsoft Purview, чтобы изменить и запустить новый поиск. Как упоминалось ранее, вы можете изменить поиск, изменив запрос поиска по ключевому слову и добавив или удалив условия поиска. Дополнительные сведения см. в разделе:

• Поиск контента в Office 365

• Запросы ключевых слов и условия поиска контента

• Случаи обнаружения электронных данных