Verwenden der Inhaltssuche in Office 365 für gezielte Sammlungen

Das Feature "Inhaltssuche" im Office 365 Security & Compliance Center bietet in der Benutzeroberfläche keine direkte Möglichkeit zum Durchsuchen bestimmter Ordner in Exchange-Postfächern oder SharePoint- und OneDrive for Business-Websites. Sie können jedoch bestimmte Ordner (als gezielte Sammlung bezeichnet) durchsuchen, indem Sie die Ordner-ID oder den Pfad in der eigentlichen Suchabfragesyntax angeben. Die Inhaltssuche zum Ausführen einer gezielten Sammlung zu verwenden, ist nützlich, wenn Sie sicher sind, dass für einen Fall erforderliche Elemente oder privilegierte Elemente in einem bestimmten Postfach- oder Websiteordner gespeichert sind. Sie können das Skript in diesem Artikel verwenden, um die Ordner-ID für Postfachordner oder den Pfad zu Ordnern auf einer SharePoint- oder OneDrive for Business-Website abzurufen. Anschließend können Sie die Ordner-ID oder den Pfad in einer Suchabfrage verwenden, um Elemente aus diesem Ordner zurückzugeben.

Dies bewerkstelligen Sie mit folgenden Schritten:

Schritt 1: Führen Sie das Skript aus, um eine Liste von Ordnern für ein Postfach oder eine Website zu erhalten.

Schritt 2: Verwenden Sie eine Ordner-ID oder einen Pfad, um eine gezielte Sammlung auszuführen.

Weitere Informationen

Erste Schritte

  • Sie müssen Mitglied der Rollengruppe "eDiscovery-Manager" im Security & Compliance Center sein, um das Skript in Schritt 1 auszuführen. Weitere Informationen finden Sie unter Zuweisen von eDiscovery-Berechtigungen im Office 365 Security & Compliance Center.

    Darüber hinaus muss Ihnen die Rolle des E-Mail-Empfängers in Ihrer Exchange Online Organisation zugewiesen sein. Dies ist zum Ausführen des in Schritt 1 des Skripts enthaltenen Cmdlets Get-MailboxFolderStatistics erforderlich. Standardmäßig wird die Rolle des E-Mail-Empfängers den Rollengruppen "Organisationsverwaltung" und "Empfängerverwaltung" in Exchange Online zugewiesen. Weitere Informationen zum Zuweisen von Berechtigungen in Exchange Online finden Sie unter Verwalten von Rollengruppenmitgliedern. Sie könnten auch eine benutzerdefinierte Rollengruppe erstellen, dieser die Rolle des E-Mail-Empfängers zuweisen und anschließendes die Mitglieder hinzufügen, die das Skript in Schritt 1 ausführen müssen. Weitere Informationen finden Sie unter Verwalten von Rollengruppen.

  • Jedes Mal, wenn Sie das Skript in Schritt 1 ausführen, wird eine neue Remote-PowerShell-Sitzung erstellt. Damit könnten möglicherweise alle für Sie verfügbaren Remote-PowerShell-Sitzungen aufgebraucht werden. Um dies zu verhindern, können Sie den folgenden Befehl ausführen, um die aktiven Remote-PowerShell-Sitzungen zu trennen.

    Get-PSSession | Remove-PSSession

    Weitere Informationen finden Sie unter Herstellen einer Verbindung mit Exchange Online mithilfe der Remote-PowerShell.

  • Das Skript enthält minimale Fehlerbehandlung. Der Hauptzweck des Skripts besteht darin, schnell eine Liste mit Postfachordner-IDs oder Websitepfaden anzuzeigen, die in der Suchabfragesyntax einer Inhaltssuche verwendet werden können, um eine gezielte Sammlung auszuführen.

  • Das in diesem Thema bereitgestellte Beispielskript wird unter keinem Standardsupportprogramm oder -dienst von Microsoft unterstützt. Das Beispielskript wird WIE BESEHEN ohne jegliche Gewährleistung bereitgestellt. Microsoft schließt ferner alle konkludenten Gewährleistungen, einschließlich, aber nicht beschränkt auf konkludente Gewährleistungen der Handelsüblichkeit 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 haften Microsoft, seine Autoren oder eine andere Person, die an der Erstellung, Herstellung oder Zustellung/Verteilung der Skripts beteiligt ist, für Schäden jeglicher Art (einschließlich, aber nicht beschränkt auf Schäden durch verlorene Geschäftsgewinne, Geschäftsunterbrechung, Verlust von Geschäftsdaten oder andere finanzielle Verluste), die aus der Verwendung oder der Unfähigkeit der Verwendung der Beispielskripts oder der Dokumentation entstehen, selbst wenn Microsoft auf die Möglichkeit solcher Schäden hingewiesen wurde.

Seitenanfang

Schritt 1: Führen Sie das Skript aus, um eine Liste von Ordnern für ein Postfach oder eine Website zu erhalten.

Das Skript, das Sie in diesem ersten Schritt ausführen, gibt eine Liste der Postfachordner bzw. SharePoint- oder OneDrive for Business-Ordner sowie die zugehörigen Ordner-IDs oder Pfade für jeden Ordner zurück. Wenn Sie dieses Skript ausführen, fragt es folgende Informationen von Ihnen ab:

  • E-Mail-Adresse oder Website-URL    Geben Sie eine E-Mail-Adresse des Verwalters ein, um eine Liste der Exchange-Postfachordner und Ordner-IDs zurückzugeben. Oder geben Sie die URL für eine SharePoint- oder OneDrive for Business-Website ein, um eine Liste der Pfade für die entsprechende Website zurückzugeben. Hier sind einige Beispiele:

    • Exchange   stacig@contoso.onmicrosoft.com

    • SharePoint   https://contoso.sharepoint.com/sites/marketing

    • OneDrive for Business   https://contoso-my.sharepoint.com/personal/stacig_contoso_onmicrosoft_com

  • Ihre Benutzeranmeldeinformationen   Das Skript verwendet Ihre Anmeldeinformationen zum Herstellen einer Verbindung mit Exchange Online und dem Security & Compliance Center mithilfe von Remote-PowerShell. Wie zuvor beschrieben, müssen Sie über die geeigneten Berechtigungen verfügen, um dieses Skript erfolgreich auszuführen.

So zeigen Sie eine Liste von Postfachordnern oder Websitepfadnamen an

  1. Speichern Sie den folgenden Text in einer Windows PowerShell-Skriptdatei, und verwenden Sie dafür das Dateinamensuffix ".ps1", z. B. "GetFolderSearchParameters.ps1".

    #########################################################################################################
    # This PowerShell script will prompt you for:								#
    #    * Admin credentials for a user who can run the Get-MailboxFolderStatistics cmdlet in Exchange	#
    #      Online and who is an eDiscovery Manager in the Security & Compliance Center.			#
    # The script will then:											#
    #    * If an email address is supplied: list the folders for the target mailbox.			#
    #    * If a SharePoint or OneDrive for Business site is supplied: list the folder paths for the site.	#
    #    * In both cases, the script supplies the correct search properties (folderid: or path:)		#
    #      appeneded to the folder ID or path ID to use in a Content Search.				#
    # Notes:												#
    #    * For SharePoint and OneDrive for Business, the paths are searched recursively; this means the 	#
    #      the current folder and all sub-folders are searched.						#
    #    * For Exchange, only the specified folder will be searched; this means sub-folders in the folder	#
    #      will not be searched.  To search sub-folders, you need to use the specify the folder ID for	#
    #      each sub-folder that you want to search.								#
    #    * For Exchange, only folders in the user's primary mailbox will be returned by the script.		#
    #########################################################################################################
    
    # Collect the target email address or SharePoint Url
    $addressOrSite = Read-Host "Enter an email address or a URL for a SharePoint or OneDrive for Business site"
    
    # Authenticate with Exchange Online and the Security & Complaince Center (Exchange Online Protection - EOP)
    if (!$credentials)
    {
        $credentials = Get-Credential
    }
    
    if ($addressOrSite.IndexOf("@") -ige 0)
    {
        # List the folder Ids for the target mailbox
        $emailAddress = $addressOrSite
    
        # Authenticate with Exchange Online
        if (!$ExoSession)
        {
            $ExoSession = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.outlook.com/powershell-liveid/ -Credential $credentials -Authentication Basic -AllowRedirection
            Import-PSSession $ExoSession -AllowClobber -DisableNameChecking
        }
    
        $folderQueries = @()
        $folderStatistics = Get-MailboxFolderStatistics $emailAddress
        foreach ($folderStatistic in $folderStatistics)
        {
            $folderId = $folderStatistic.FolderId;
            $folderPath = $folderStatistic.FolderPath;
    
            $encoding= [System.Text.Encoding]::GetEncoding("us-ascii")
            $nibbler= $encoding.GetBytes("0123456789ABCDEF");
            $folderIdBytes = [Convert]::FromBase64String($folderId);
            $indexIdBytes = New-Object byte[] 48;
            $indexIdIdx=0;
            $folderIdBytes | select -skip 23 -First 24 | %{$indexIdBytes[$indexIdIdx++]=$nibbler[$_ -shr 4];$indexIdBytes[$indexIdIdx++]=$nibbler[$_ -band 0xF]}
            $folderQuery = "folderid:$($encoding.GetString($indexIdBytes))";
    
            $folderStat = New-Object PSObject
            Add-Member -InputObject $folderStat -MemberType NoteProperty -Name FolderPath -Value $folderPath
            Add-Member -InputObject $folderStat -MemberType NoteProperty -Name FolderQuery -Value $folderQuery
    
            $folderQueries += $folderStat
        }
        Write-Host "-----Exchange Folders-----"
        $folderQueries |ft
    }
    elseif ($addressOrSite.IndexOf("http") -ige 0)
    {
        $searchName = "SPFoldersSearch"
        $searchActionName = "SPFoldersSearch_Preview"
    
        # List the folders for the SharePoint or OneDrive for Business Site
        $siteUrl = $addressOrSite
    
        # Authenticate with the Security & Complaince Center
        if (!$SccSession)
        {
            $SccSession = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri https://ps.compliance.protection.outlook.com/powershell-liveid -Credential $credentials -Authentication Basic -AllowRedirection
            Import-PSSession $SccSession -AllowClobber -DisableNameChecking
        }
    
        # Clean-up, if the the script was aborted, the search we created might not have been deleted.  Try to do so now.
        Remove-ComplianceSearch $searchName -Confirm:$false -ErrorAction 'SilentlyContinue'
    
        # Create a Content Search against the SharePoint Site or OneDrive for Business site and only search for folders; wait for the search to complete
        $complianceSearch = New-ComplianceSearch -Name $searchName -ContentMatchQuery "contenttype:folder" -SharePointLocation $siteUrl
        Start-ComplianceSearch $searchName
        do{
            Write-host "Waiting for search to complete..."
            Start-Sleep -s 5
            $complianceSearch = Get-ComplianceSearch $searchName
        }while ($complianceSearch.Status -ne 'Completed')
    
    
        if ($complianceSearch.Items -gt 0)
        {
            # Create a Complinace Search Action and wait for it to complete. The folders will be listed in the .Results parameter
            $complianceSearchAction = New-ComplianceSearchAction -SearchName $searchName -Preview
            do
            {
                Write-host "Waiting for search action to complete..."
                Start-Sleep -s 5
                $complianceSearchAction = Get-ComplianceSearchAction $searchActionName
            }while ($complianceSearchAction.Status -ne 'Completed')
    
            # Get the results and print out the folders
            $results = $complianceSearchAction.Results
            $matches = Select-String "Data Link:.+[,}]" -Input $results -AllMatches
            foreach ($match in $matches.Matches)
            {
                $rawUrl = $match.Value
                $rawUrl = $rawUrl -replace "Data Link: " -replace "," -replace "}"
                Write-Host "path:""$rawUrl"""
            }
        }
        else
        {
            Write-Host "No folders were found for $siteUrl"
        }
    
        Remove-ComplianceSearch $searchName -Confirm:$false -ErrorAction 'SilentlyContinue'
    }
    else
    {
        Write-Error "Couldn't recognize $addressOrSite as an email address or a site URL"
    }
  2. Öffnen Sie auf dem lokalen Computer Windows PowerShell, und wechseln Sie zu dem Ordner, in dem Sie das Skript gespeichert haben.

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

    .\GetFolderSearchParameters.ps1
  4. Geben Sie die Informationen ein, nach denen das Skript Sie fragt.

    Das Skript zeigt eine Liste der Postfach- oder Websiteordner für den angegebenen Benutzer an. Wenn sich dieses Fenster öffnet, können Sie eine Ordner-ID oder einen Pfadnamen kopieren und in eine Suchabfrage in Schritt 2 einfügen.

    Tipp : Anstatt eine Liste von Ordnern auf dem Computerbildschirm anzuzeigen, können Sie die Ausgabe des Skripts auch in eine Textdatei umleiten. Diese Datei wird in dem Ordner gespeichert, in dem sich das Skript befindet. Führen Sie z. B. den folgenden Befehl in Schritt 3 aus, um die Ausgabe des Skripts in eine Textdatei umzuleiten: .\GetFolderSearchParameters.ps1 > StacigFolderIds.txt Anschließend können Sie eine Ordner-ID oder einen Pfad aus der Datei kopieren und in einer Suchabfrage verwenden.

Seitenanfang

Skriptausgabe für Postfachordner

Wenn Sie Postfachordner-IDs erhalten, stellt das Skript mithilfe von Remote-PowerShell eine Verbindung zu Exchange Online her, führt das Cmdlet Get-MailboxFolderStatisics aus, und zeigt dann die Liste der Ordner aus dem entsprechenden Postfach an. Für jeden Ordner im Postfach zeigt das Skript den Namen des Ordners in der Spalte FolderPath und die Ordner-ID in der Spalte FolderQuery an. Darüber hinaus fügt das Skript das Präfix folderId (dies ist der Name der Postfacheigenschaft) zur Ordner-ID hinzu. Da die Eigenschaft folderid eine durchsucht werden kann, verwenden Sie folderid:<folderid> in einer Suchabfrage in Schritt 2, um diesen Ordner zu durchsuchen.

Hier ist ein Beispiel für die vom Skript zurückgegebene Ausgabe für Postfachordner.

Beispiel für die vom Skript zurückgegebene Liste der Postfachordner und Ordner-IDs

Das Beispiel in Schritt 2 zeigt die Abfrage, mit der der Unterordner mit den Löschvorgängen im Ordner "Wiederherstellbare Elemente" des Benutzers durchsucht wird.

Skriptausgabe für Websiteordner

Wenn Sie Pfade von SharePoint- oder OneDrive for Business-Websites erhalten, stellt das Skript mithilfe von Remote-PowerShell eine Verbindung zu Security & Compliance Center her, erstellt eine neue Inhaltssuche, um die Website nach Ordnern zu durchsuchen, und zeigt dann eine Liste der in der entsprechenden Website befindlichen Ordner an. Das Skript zeigt den Namen der einzelnen Ordner an und fügt das Präfix path (dies ist der Name der Websiteeigenschaft) zur Ordner URL hinzu. Da die Eigenschaft path eine durchsucht werden kann, verwenden Sie path:<path> in einer Suchabfrage in Schritt 2, um diesen Ordner zu durchsuchen.

Hier ist ein Beispiel für die vom Skript zurückgegebene Ausgabe für Websiteordner.

Beispiel für die vom Skript zurückgegebene Liste der Pfadnamen für Websiteordner

Seitenanfang

Schritt 2: Verwenden Sie eine Ordner-ID oder einen Pfad, um eine gezielte Sammlung auszuführen.

Nachdem Sie das Skript ausgeführt haben, um eine Liste der Ordner-IDs oder Pfade für einen bestimmten Benutzer zu sammeln, navigieren Sie im nächsten Schritt in das Security & Compliance Center und erstellen eine neue Inhaltssuche, um einen bestimmten Ordner zu durchsuchen. Sie verwenden die Eigenschaft folderid:<folderid> oder path:<path> in der im Stichwortfeld der Inhaltssuche konfigurierten Suchabfrage (oder, bei Verwendung des Cmdlets New-ComplianceSearch, als Wert für den Parameter ContentMatchQuery) Sie können die Eigenschaft folderid oder path mit anderen Suchparametern oder Suchbedingungen kombinieren. Wenn Sie in der Abfrage nur die Eigenschaft folderid oder path verwenden, gibt die Suche alle im angegebenen Ordner befindlichen Elemente zurück.

  1. Wechseln Sie zu https://protection.office.com.

  2. Melden Sie sich bei Office 365 mit dem Konto und den Anmeldeinformationen an, die Sie zum Ausführen des Skripts in Schritt 1 verwendet haben.

  3. Klicken Sie im linken Bereich des Security & Compliance Center auf Suche und Untersuchung > Inhaltssuche, und klicken Sie dann auf Neu  Symbol "Hinzufügen" ..

  4. Geben Sie auf der Seite Neue Suche einen Namen für die Inhaltssuche ein. Dieser Name muss in Ihrer Organisation eindeutig sein.

  5. Führen Sie unter Wo sollen wir suchen? einen der folgenden Schritte aus, je nachdem, ob Sie einen Postfachordner oder einen Websiteordner durchsuchen:

    • Klicken Sie auf Bestimmte zu durchsuchende Postfächer auswählen, und fügen Sie dann das gleiche Postfach hinzu, das Sie beim Ausführen des Skripts in Schritt 1 angegeben haben.

      Oder

    • Klicken Sie auf Bestimmte zu durchsuchende Websites auswählen, und fügen Sie dann die gleiche Website-URL hinzu, die Sie beim Ausführen des Skripts in Schritt 1 angegeben haben.

  6. Klicken Sie auf Weiter.

  7. Fügen Sie in das Stichwortfeld auf der Seite Wonach sollen wir für Sie suchen? den folderid:<folderid>- oder path:<path>-Wert ein, der vom Skript in Schritt 1 zurückgegeben wurde.

    Die Abfrage im folgenden Screenshot sucht z. B. nach allen Elementen im Unterordner mit den Löschvorgängen im Ordner "Wiederherstellbare Elemente" des Benutzers aus dem Postfachordner-Screenshot in Schritt 1.

    Fügen Sie die Ordner-ID oder den Pfad in das Stichwortfeld der Suchabfrage ein.
  8. Klicken Sie auf Suchen, um die gezielte Sammlungssuche zu starten.

Seitenanfang

Beispiele für Suchabfragen für gezielte Sammlungen

Hier sind einige Beispiele für die Verwendung der Eigenschaften folderid und path in einer Abfrage zum Ausführen einer gezielten Sammlung. Beachten Sie, dass aus Platzgründen für folderid:<folderid> und path:<path> Platzhalter verwendet werden.

  • In diesem Beispiel werden drei verschiedene Postfachordner durchsucht. Sie können eine ähnliche Abfragesyntax verwenden, um die versteckten Ordner im Ordner "Wiederherstellbare Elemente" eines Benutzers zu durchsuchen.

    folderid:<folderid> OR folderid:<folderid> OR folderid:<folderid>
  • In diesem Beispiel wird ein Postfachordner nach Elementen durchsucht, die eine genaue Wortgruppe enthalten.

    folderid:<folderid> AND "Contoso financial results"
  • In diesem Beispiel wird ein Websiteordner (mit all seinen Unterordnern) nach Dokumenten durchsucht, die die Buchstaben "NDA" im Titel enthalten.

    path:<path> AND filename:nda
  • In diesem Beispiel wird ein Websiteordner (mit all seinen Unterordnern) nach Dokumenten durchsucht, die innerhalb eines bestimmten Zeitraums geändert wurden.

    path:<path> AND (lastmodifiedtime>=01/01/2017 AND lastmodifiedtime<=01/21/2017)

Seitenanfang

Weitere Informationen

Beachten Sie folgende Punkte, wenn Sie das Skript in diesem Artikel verwenden und gezielte Sammlungen ausführen:

  • Das Skript entfernt keine Ordner aus den Suchergebnissen. Einige im Ergebnis aufgeführten Ordner können daher möglicherweise nicht durchsucht werden (oder geben Null-Elemente zurück), da sie vom System generierten Inhalt enthalten.

  • Dieses Skript gibt nur Ordnerinformationen für das primäre Postfach des Benutzers zurück. Er werden keine Informationen zu Ordnern i, Archivpostfach des Benutzers zurückgegeben.

  • Beim Durchsuchen von Postfachordnern wird nur der angegebene (durch seine folderid-Eigenschaft identifizierte) Ordner durchsucht. Unterordner werden nicht durchsucht. Zum Durchsuchen von Unterordnern müssen Sie folderid für den gewünschten Unterordner verwenden.

  • Beim Durchsuchen von Websiteordnern werden der durch seine path-Eigenschaft identifizierte Ordner und alle Unterordner durchsucht.

Seitenanfang

Ihre Fähigkeiten erweitern
Schulung erkunden
Neue Funktionen als Erster erhalten
An Office Insider teilnehmen

War diese Information hilfreich?

Vielen Dank für Ihr Feedback!

Vielen Dank für Ihr Feedback. Es klingt, als ob es hilfreich sein könnte, Sie mit einem unserer Office-Supportmitarbeiter zu verbinden.

×