Clonare una ricerca contenuto

La creazione di una ricerca contenuto nel Portale di conformità di Microsoft Purview in Microsoft 365 che esegue ricerche in molte cassette postali o in SharePoint e OneDrive for Business siti può richiedere del tempo. Se si digita un URL in modo errato, è anche possibile che la specifica dei siti da cercare sia soggetta a errori. Per evitare questi problemi, è possibile usare lo script Windows PowerShell in questo articolo per clonare rapidamente una ricerca contenuto esistente. Quando si clona una ricerca, viene creata una nuova ricerca (con un nome diverso) che contiene le stesse proprietà (ad esempio i percorsi del contenuto e la query di ricerca) della ricerca originale. È quindi possibile modificare la nuova ricerca modificando la query della parola chiave o l'intervallo di date ed eseguirla.

Perché clonare ricerche di contenuto?

• Per confrontare i risultati delle diverse query di ricerca di parole chiave eseguite negli stessi percorsi di contenuto.

• Per evitare di dover immettere di nuovo un numero elevato di posizioni di contenuto quando si crea una nuova ricerca.

• Per ridurre le dimensioni dei risultati della ricerca. Ad esempio, se si dispone di una ricerca che restituisce troppi risultati da esportare, è possibile clonare la ricerca e quindi aggiungere una condizione di ricerca basata su un intervallo di date per ridurre il numero di risultati della ricerca.

Informazioni sullo script

• È necessario installare il modulo Exchange Online PowerShell. Per istruzioni, vedere Installare e gestire il modulo Exchange Online PowerShell.

• È necessario essere un membro del gruppo di ruoli di eDiscovery Manager nel Portale di conformità di Microsoft Purview per eseguire lo script descritto in questo argomento.

• Lo script include la gestione minima degli errori. Lo scopo principale dello script è clonare rapidamente una ricerca di contenuto.

• Lo script crea una nuova ricerca contenuto, ma non la avvia.

• Questo script tiene conto del fatto che ricerca contenuto che si sta clonando sia associata a un caso di eDiscovery. Se la ricerca è associata a un caso, anche la nuova ricerca verrà associata allo stesso caso. Se la ricerca esistente non è associata a un caso, la nuova ricerca verrà elencata nella pagina Ricerca contenuto nel Portale di conformità di Microsoft Purview.

• Lo script di esempio fornito in questo argomento non è supportato in alcun programma o servizio di supporto standard Microsoft. Lo script di esempio è fornito così come è senza alcun tipo di garanzia. Microsoft esclude inoltre qualsiasi garanzia implicita, tra cui, senza limitazioni, tutte le garanzie implicite di commerciabilità o idoneità per uno scopo specifico. L'utente assume tutti i rischi associati all'uso o alle prestazioni dello script di esempio e della documentazione. In nessun caso Microsoft, i suoi autori o chiunque altro coinvolto nella creazione, produzione o consegna degli script è da ritenersi responsabile per qualsiasi danno eventuale (inclusi, senza limitazione alcuna, danni riguardanti profitti aziendali, interruzione di attività, perdita di informazioni aziendali o altra perdita pecuniaria) derivanti dall'utilizzo o dall'incapacità di utilizzo degli script di esempio e della documentazione, anche nel caso in cui Microsoft sia stata avvisata della possibilità di tali danni.

Passaggio 1: Eseguire lo script per clonare una ricerca

Lo script in questo passaggio creerà una nuova ricerca contenuto clonando una ricerca esistente. Quando si esegue questo script, verranno richieste le informazioni seguenti:

• Credenziali utente : lo script userà le credenziali per connettersi a PowerShell security & Compliance. Come indicato in precedenza, è necessario essere un membro del gruppo di ruoli di eDiscovery Manager nel Portale di conformità di Microsoft Purview per eseguire lo script.

• Nome della ricerca esistente : si tratta della ricerca contenuto che si vuole clonare.

• Nome della nuova ricerca che verrà creata : se si lascia vuoto questo valore, lo script creerà un nome per la nuova ricerca basato sul nome della ricerca che si sta clonando.

Per clonare una ricerca:

1. Salvare il testo seguente in un file di script Windows PowerShell usando un suffisso di nome file di .ps1, CloneSearch.ps1ad esempio .

   # 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. Connettersi a PowerShell per Sicurezza e conformità. Nella stessa finestra di PowerShell passare alla cartella in cui è stato salvato lo script.

3. Eseguire lo script; Per esempio:

   .\CloneSearch.ps1
   

4. Immettere le informazioni seguenti quando richiesto dallo script. Digitare ogni informazione e quindi premere INVIO.

   • Nome della ricerca esistente.
   • Nome della nuova ricerca.

   Lo script crea la nuova ricerca contenuto, ma non la avvia. In questo modo è possibile modificare ed eseguire la ricerca nel passaggio successivo. È possibile visualizzare le proprietà della nuova ricerca eseguendo il cmdlet Get-ComplianceSearch o passando alla pagina Ricerca contenuto o eDiscovery nel Portale di conformità di Microsoft Purview, a seconda che la nuova ricerca sia associata a un caso.

Passaggio 2: Modificare ed eseguire la ricerca clonata nel Portale di conformità di Microsoft Purview

Dopo aver eseguito lo script per clonare una ricerca contenuto esistente, il passaggio successivo consiste nel passare alla Portale di conformità di Microsoft Purview per modificare ed eseguire la nuova ricerca. Come indicato in precedenza, è possibile modificare una ricerca modificando la query di ricerca con parole chiave e aggiungendo o rimuovendo le condizioni di ricerca. Per altre informazioni, vedere:

• Ricerca contenuto in Office 365

• Query con parole chiave e condizioni di ricerca per la Ricerca contenuto

• Casi di eDiscovery