Klonen einer Inhaltssuche

Das Erstellen einer Inhaltssuche im Microsoft Purview-Complianceportal in Microsoft 365, die viele Postfächer oder SharePoint- und OneDrive for Business-Websites durchsucht, kann eine Weile dauern. Die Angabe der zu durchsuchenden Websites kann auch fehleranfällig sein, wenn Sie eine URL falsch eingeben. Um diese Probleme zu vermeiden, können Sie das Windows PowerShell-Skript in diesem Artikel verwenden, um schnell eine vorhandene Inhaltssuche zu klonen. Wenn Sie eine Suche klonen, wird eine neue Suche (mit einem anderen Namen) erstellt, die dieselben Eigenschaften (z. B. die Inhaltsspeicherorte und die Suchabfrage) wie die ursprüngliche Suche enthält. Anschließend können Sie die neue Suche bearbeiten, indem Sie die Schlüsselwortabfrage oder den Datumsbereich ändern und ausführen.

Gründe für das Klonen von Inhaltssuchen

• Zum Vergleichen der Ergebnisse verschiedener Schlüsselwortsuchabfragen werden an den gleichen Inhaltsspeicherorten ausgeführt.

• Damit Sie nicht eine große Anzahl von Inhaltsspeicherorten erneut eingeben müssen, wenn Sie eine neue Suche erstellen.

• So verkleinern Sie die Größe der Suchergebnisse. Wenn Sie beispielsweise eine Suche haben, die zu viele zu exportierende Ergebnisse zurückgibt, können Sie die Suche klonen und dann eine Suchbedingung anhand eines Datumsbereichs hinzufügen, um die Anzahl von Suchergebnissen zu verringern.

Skriptinformationen

• Sie müssen das Exchange Online PowerShell-Modul installieren. Anweisungen finden Sie unter Installieren und Verwalten des Exchange Online PowerShell-Moduls.

• Sie müssen Mitglied der Rollengruppe eDiscovery-Manager im Microsoft Purview-Complianceportal sein, um das in diesem Thema beschriebene Skript ausführen zu können.

• Das Skript umfasst eine minimale Fehlerbehandlung. Der Hauptzweck des Skripts besteht darin, schnell eine Inhaltssuche zu klonen.

• Das Skript erstellt eine neue Inhaltssuche, startet sie jedoch nicht.

• Dieses Skript berücksichtigt, ob die Inhaltssuche, die Sie klonen, einem eDiscovery-Fall zugeordnet ist. Wenn die Suche einem Fall zugeordnet ist, wird die neue Suche ebenfalls demselben Fall zugeordnet. Wenn die vorhandene Suche keinem Fall zugeordnet ist, wird die neue Suche im Microsoft Purview-Complianceportal auf der Seite Inhaltssuche aufgeführt.

• Das in diesem Thema bereitgestellte Beispielskript wird von keinem Microsoft-Standardsupportprogramm oder -Dienst unterstützt. Das Beispielskript wird wie besehen ohne jegliche Gewährleistung zur Verfügung gestellt. Microsoft schließt ferner alle konkludenten Gewährleistungen, einschließlich, aber nicht beschränkt auf konkludente Gewährleistungen der Marktgängigkeit oder Eignung für einen bestimmten Zweck aus. Das gesamte Risiko, das mit der Verwendung oder Leistung des Beispielskripts und der Dokumentation einhergeht, liegt bei Ihnen. In keinem Fall sind Microsoft, seine Autoren oder an der Erstellung, Produktion oder Übermittlung der Skripts beteiligte Personen für Schäden jeglicher Art (einschließlich und ohne Einschränkung Schäden durch Verlust entgangener Gewinne, Geschäftsunterbrechungen, Verlust von Geschäftsinformationen oder andere geldliche Verluste) haftbar, die aus der Nutzung bzw. Unfähigkeit zur Nutzung der Beispielskripts oder Dokumentation entstehen, auch wenn Microsoft auf die Möglichkeit solcher Schäden hingewiesen wurde.

Schritt 1: Ausführen des Skripts zum Klonen einer Suche

Das Skript in diesem Schritt erstellt eine neue Inhaltssuche durch Klonen einer vorhandenen Inhaltssuche. Wenn Sie dieses Skript ausführen, werden Sie zur Eingabe der folgenden Informationen aufgefordert:

• Ihre Benutzeranmeldeinformationen : Das Skript verwendet Ihre Anmeldeinformationen, um eine Verbindung mit Security & Compliance PowerShell herzustellen. Wie bereits erwähnt, müssen Sie Mitglied der Rollengruppe eDiscovery-Manager im Microsoft Purview-Complianceportal sein, um das Skript ausführen zu können.

• Der Name der vorhandenen Suche : Dies ist die Inhaltssuche, die Sie klonen möchten.

• Der Name der neuen Suche, die erstellt wird : Wenn Sie diesen Wert leer lassen, erstellt das Skript einen Namen für die neue Suche, der auf dem Namen der Suche basiert, die Sie klonen.

So klonen Sie eine Suche:

1. Speichern Sie den folgenden Text in einer Windows PowerShell-Skriptdatei, indem Sie das Dateinamensuffix .ps1 verwenden. Beispiel: 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. Herstellen einer Verbindung zur Security & Compliance Center-PowerShell. Navigieren Sie im selben PowerShell-Fenster zu dem Ordner, in dem Sie das Skript gespeichert haben.

3. Führen Sie das Skript aus. Zum Beispiel:

   .\CloneSearch.ps1
   

4. Geben Sie die folgenden Informationen ein, wenn Sie vom Skript dazu aufgefordert werden. Geben Sie die einzelnen Informationen ein, und drücken Sie dann die EINGABETASTE.

   • Der Name der vorhandenen Suche.
   • Der Name der neuen Suche.

   Das Skript erstellt die neue Inhaltssuche, startet sie jedoch nicht. Dadurch haben Sie die Möglichkeit, die Suche im nächsten Schritt zu bearbeiten und auszuführen. Sie können die Eigenschaften der neuen Suche anzeigen, indem Sie das Cmdlet Get-ComplianceSearch ausführen oder im Microsoft Purview-Complianceportal zur Seite Inhaltssuche oder eDiscovery wechseln, je nachdem, ob die neue Suche einem Fall zugeordnet ist.

Schritt 2: Bearbeiten und Ausführen der geklonten Suche im Microsoft Purview-Complianceportal

Nachdem Sie das Skript zum Klonen einer vorhandenen Inhaltssuche ausgeführt haben, wechseln Sie im nächsten Schritt zum Microsoft Purview-Complianceportal, um die neue Suche zu bearbeiten und auszuführen. Wie bereits erwähnt, können Sie eine Suche bearbeiten, indem Sie die Schlüsselwortsuchabfrage ändern und Suchbedingungen hinzufügen oder entfernen. Weitere Informationen finden Sie unter:

• Inhaltssuche in Office 365

• Stichwortabfragen und Suchbedingungen für die Inhaltssuche

• eDiscovery-Fälle