Clonar uma Pesquisa de Conteúdo

A criação de uma Pesquisa de Conteúdos no portal de conformidade do Microsoft Purview no Microsoft 365 que pesquisa em muitas caixas de correio ou sites do SharePoint e do OneDrive para Empresas pode demorar algum tempo. Especificar os sites a pesquisar também pode ser propenso a erros se escrever um URL incorretamente. Para evitar estes problemas, pode utilizar o script do Windows PowerShell neste artigo para clonar rapidamente uma Pesquisa de Conteúdos existente. Quando clona uma pesquisa, é criada uma nova pesquisa (com um nome diferente) que contém as mesmas propriedades (como as localizações de conteúdo e a consulta de pesquisa) que a pesquisa original. Em seguida, pode editar a nova pesquisa ao alterar a consulta de palavra-chave ou o intervalo de datas e executá-la.

Porquê clonar Pesquisas de Conteúdo?

• Para comparar os resultados de diferentes consultas de pesquisa de palavras-chave, execute nas mesmas localizações de conteúdo.

• Para evitar que tenha de reintroduzir um grande número de localizações de conteúdo quando cria uma nova pesquisa.

• Para diminuir o tamanho dos resultados da pesquisa. Por exemplo, se você tiver uma pesquisa que retorne muitos resultados para exportação, poderá clonar a pesquisa e adicionar uma condição de pesquisa com base em um intervalo de datas para reduzir o número de resultados da pesquisa.

Informações do script

• Tem de instalar o módulo do PowerShell do Exchange Online. Para obter instruções, consulte Instalar e manter o módulo do PowerShell do Exchange Online.

• Tem de ser membro do grupo de funções Gestor de Deteção de Dados Eletrónicos no portal de conformidade do Microsoft Purview para executar o script descrito neste tópico.

• O script inclui um processamento de erros mínimo. O principal objetivo do script é clonar rapidamente uma pesquisa de conteúdos.

• O script cria uma nova Pesquisa de Conteúdos, mas não a inicia.

• Este script tem em conta se a Pesquisa de Conteúdos que está a clonar está associada a um caso de Deteção de Dados Eletrónicos. Se a pesquisa estiver associada a um caso, a nova pesquisa também será associada ao mesmo caso. Se a pesquisa existente não estiver associada a um caso, a nova pesquisa será listada na página Pesquisa de conteúdos no portal de conformidade do Microsoft Purview.

• O script de exemplo fornecido neste tópico não é suportado em nenhum programa ou serviço de suporte padrão da Microsoft. O script de amostra é fornecido COMO ESTÁ, sem garantia de nenhum tipo. A Microsoft também se isenta de todas as garantias implícitas, incluindo, sem limitação, quaisquer garantias implícitas de comercialização ou adequação a uma finalidade específica. Todo o risco decorrente do uso ou desempenho do script de amostra e da documentação permanece com você. De modo algum a Microsoft, seus autores ou qualquer outra pessoa envolvida na criação, produção ou veiculação dos scripts serão considerados responsáveis por quaisquer danos (incluindo sem limitações danos por perda de lucros comerciais, interrupção de negócios, perda de informações comerciais ou outras perdas pecuniárias) resultantes do uso ou da incapacidade de uso da documentação ou scripts de exemplo, mesmo que a Microsoft tenha sido alertada sobre a possibilidade de tais danos.

Passo 1: executar o script para clonar uma pesquisa

O script neste passo irá criar uma nova Pesquisa de Conteúdos ao clonar uma existente. Quando executar este script, ser-lhe-ão pedidas as seguintes informações:

• As suas credenciais de utilizador – o script utilizará as suas credenciais para ligar ao PowerShell de Conformidade do & de Segurança. Conforme indicado anteriormente, tem de ser membro do grupo de funções Gestor de Deteção de Dados Eletrónicos no portal de conformidade do Microsoft Purview para executar o script.

• O nome da pesquisa existente – esta é a Pesquisa de Conteúdo que pretende clonar.

• O nome da nova pesquisa que será criada – se deixar este valor em branco, o script criará um nome para a nova pesquisa baseada no nome da pesquisa que está a clonar.

Para clonar uma pesquisa:

1. Guarde o seguinte texto num ficheiro de script do Windows PowerShell com um sufixo de nome de ficheiro de .ps1; por exemplo, 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. Conectar-se a Segurança e Conformidade do PowerShell. Na mesma janela do PowerShell, aceda à pasta onde guardou o script.

3. Executar o script; Por exemplo:

   .\CloneSearch.ps1
   

4. Introduza as seguintes informações quando lhe for pedido pelo script. Escreva cada informação e, em seguida, prima Enter.

   • O nome da pesquisa existente.
   • O nome da nova pesquisa.

   O script cria a nova Pesquisa de Conteúdos, mas não a inicia. Isto dá-lhe a oportunidade de editar e executar a pesquisa no próximo passo. Pode ver as propriedades da nova pesquisa ao executar o cmdlet Get-ComplianceSearch ou ao aceder à página Pesquisa de conteúdos ou Deteção de Dados Eletrónicos no portal de conformidade do Microsoft Purview, consoante a nova pesquisa esteja associada a um caso.

Passo 2: Editar e executar a pesquisa clonada no portal de conformidade do Microsoft Purview

Depois de executar o script para clonar uma Pesquisa de Conteúdos existente, o passo seguinte é aceder ao portal de conformidade do Microsoft Purview para editar e executar a nova pesquisa. Conforme indicado anteriormente, pode editar uma pesquisa ao alterar a consulta de pesquisa de palavras-chave e adicionar ou remover condições de pesquisa. Para saber mais, confira:

• Pesquisa de Conteúdo no Office 365

• Consultas de palavra-chave e condições de pesquisa para Pesquisa de Conteúdo

• Casos de Descoberta Eletrônica