Anzeigen von Diagnoseprotokollen in SharePoint Server

  • Artikel

 

**Gilt für:**SharePoint Server 2016

**Letztes Änderungsdatum des Themas:**2018-03-12

Zusammenfassung: Informationen zum Anzeigen und Filtern von Protokollereignissen mithilfe von Windows PowerShell sowie zum Anzeigen und Exportieren von Diagnoseprotokollen mithilfe des Cmdlets Out-GridView .

Mit den Daten aus den Protokollen des vereinheitlichten Protokollierungsdiensts (Unified Logging Service, ULS) in SharePoint Server können Sie Probleme in der Farm behandeln. In den ULS-Protokollen können Daten in Abhängigkeit von den Protokollierungseinstellungen auf verschiedenen Ebenen gesammelt werden. MitPowerShell können Sie die Daten filtern, auf unterschiedliche Weise anzeigen und in ein Datenraster ausgeben, mit dem Sie Daten filtern, sortieren, gruppieren und nach Excel 2016 exportieren können.

Inhalt dieses Artikels:

Anzeigen und Filtern von Protokollereignissen mithilfe von Windows PowerShell

Mit PowerShell können Protokollereignisse angezeigt und gefiltert werden. Mit der die Website für die SharePoint-Zentraladministration ist dies nicht möglich.

So können Sie Protokollereignisse mithilfe von Windows PowerShell anzeigen und filtern

  1. Vergewissern Sie sich, dass Sie die folgenden Mitgliedschaften besitzen:

    • Feste Serverrolle securityadmin auf der SQL Server-Instanz.

    • Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.

    • Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.

    Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator Berechtigungen gewähren.

    Hinweis

    Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

  2. Wechseln Sie zur SharePoint-Verwaltungsshell.

  3. Geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:

    • Alle Ablaufverfolgungsereignisse:

      Get-SPLogEvent

    • Nach Ebene:

      Get-SPLogEvent | Where-Object {$_.Level -eq "Information" }

    • Nach Bereich:

      Get-SPLogEvent | Where-Object {$_.Area -eq <Area>}

      Dabei ist <Area> der Wert der Area-Eigenschaft.

    • Nach Kategorie:

      Get-SPLogEvent | Where-Object {$_.Category -eq <Category>

      Dabei ist <Category> der Wert der Category-Eigenschaft.

    • Nach Ereignis-ID:

      Get-SPLogEvent | Where-Object {$_.EventID -eq <EventID>}

      Dabei ist <EventID> der Wert der EventID-Eigenschaft.

    • Nach Meldungstext:

      Get-SPLogEvent | Where-Object {$_.Message -like "<string>"}

      Dabei ist <string> die Zeichenfolge in der Ereignismeldung.

    • Nach Prozess:

      Get-SPLogEvent | Where-Object {$_.Process -like "<Process>"}

      Dabei ist <Process> der Wert der Process-Eigenschaft.

    Standardmäßig werden mit dem Befehl Daten aus dem ULS-Standardprotokollordner abgerufen. Verwenden Sie den Directory-Parameter des Get-SPLogEvent-Cmdlets, um Ablaufverfolgungsereignisse, die sich in einem freigegebenen Ordner in einem Netzwerk befinden, anzuzeigen und zu filtern.

    Verwenden Sie das Format-List-Cmdlet am Ende des Befehls, um weitere Details zu den Ablaufverfolgungsereignissen anzuzeigen. Beispiel:

    Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Format-List

Weitere Informationen finden Sie unter Get-SPLogEvent.

Anzeigen und Exportieren von Diagnoseprotokollen mithilfe des Out-GridView-Cmdlets von Windows PowerShell

In PowerShell gibt es ein leistungsfähiges und einfach zu handhabendes Feature, mit dem aus Microsoft PowerShell-Befehlen resultierende Tabellendaten in einem filterbaren und durchsuchbaren Datenraster in einem separaten Fenster angezeigt werden. Mithilfe dieses Datenrasters können Sie Protokollereignisse anzeigen und die folgenden Vorgänge für die Daten ausführen:

  • Sortieren der Daten nach einer beliebigen Spalte

  • Anzeigen der Daten in Gruppen

  • Filtern der Daten nach Ebene, Bereich, Kategorie, Meldung, Ereignis-ID oder Zeitstempel

  • Durchsuchen der Daten nach einer Zeichenfolge

  • Exportieren von Rohdaten oder sortierten bzw. gefilterten Daten in eine Kalkulationstabelle

Hinweis

Das Out-GridView-Cmdlet ist nicht kompatibel mit Cmdlets, die das Verb Format verwenden. Das Out-GridView-Cmdlet empfängt Objekte, während Cmdlets, die das Verb Format verwenden, nur formatierten Text zurückgeben.
Sie können eine Teilmenge der Daten mithilfe des Cmdlets Where-Object anzeigen, das die Ergebnisse filtert und die Ergebnisse an das Out-GridView-Cmdlet übergibt. Beispiel: Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Out-GridView.
Wenn in dem Raster mehr als hunderte von Zeilen angezeigt werden, wird möglicherweise die Leistung beeinträchtigt, insbesondere bei komplexen Filtervorgängen. Exportieren Sie die Daten nach Excel 2016, um die Leistung zu optimieren.

So können Sie Diagnoseprotokolle mithilfe von Windows PowerShell anzeigen und filtern

  1. Vergewissern Sie sich, dass Sie die folgenden Mitgliedschaften besitzen:

    • Feste Serverrolle securityadmin auf der SQL Server-Instanz.

    • Feste Datenbankrolle db_owner auf allen Datenbanken, die aktualisiert werden sollen.

    • Administratorgruppe auf dem Server, auf dem die PowerShell-Cmdlets ausgeführt werden.

    Mit dem Cmdlet Add-SPShellAdmin kann ein Administrator Berechtigungen gewähren.

    Hinweis

    Wenn Sie über keine Berechtigungen verfügen, kontaktieren Sie Ihren Setup-Administrator oder SQL Server-Administrator, um die Berechtigungen anzufordern. Weitere Informationen zu PowerShell-Berechtigungen finden Sie unter Add-SPShellAdmin.

  2. Wechseln Sie zur SharePoint-Verwaltungsshell.

  3. Geben Sie an der PowerShell-Eingabeaufforderung den folgenden Befehl ein:

    Get-SPLogEvent | Out-GridView

  4. Klicken Sie auf die Spaltenüberschrift, um Spalten zu sortieren.

  5. Geben Sie im Feld Filter die Zeichenfolge ein, nach der gesucht werden soll. Es wird in allen Spalten und Zeilen gesucht. Klicken Sie auf X, um die Suche zu entfernen.

  6. Geben Sie im Feld Suchen Folgendes ein, um Daten nur nach einem einzigen Kriterium zu filtern: <Eigenschaftenname>:<Wert>. Geben Sie beispielsweise Folgendes ein, um nach allen von SharePoint Foundation 2013 generierten Protokolleinträgen zu suchen: Area:SharePoint Foundation. Klicken Sie auf X, um den Filter zu entfernen.

  7. Führen Sie die folgenden Aktionen aus, um Daten mithilfe mehrerer Kriterien oder mithilfe von Kriterien mit den Methoden "enthält", "beginnt mit", "endet mit" oder anderen Methoden zu filtern:

    1. Klicken Sie auf Kriterien hinzufügen.

    2. Aktivieren Sie das Kontrollkästchen für die Eigenschaften, nach denen Sie filtern möchten, und klicken Sie dann auf Hinzufügen.

    3. Klicken Sie auf enthält, um eine andere Filtermethode zu verwenden. Die folgenden Methoden sind verfügbar: enthält, enthält nicht, beginnt mit, entspricht, entspricht nicht, endet mit, ist leer und ist nicht leer.

    4. Geben Sie im Textfeld einen Wert ein.

    5. Wiederholen Sie die Schritte "c" und "d" für jede in Schritt "b" ausgewählte Eigenschaft.

    6. Wenn Sie alle Filterkriterien angegeben haben, werden die den Kriterien entsprechenden Daten angezeigt.

    7. Klicken Sie auf die Schaltfläche X, um einen bestimmten Filter zu entfernen.

    8. Reduzieren Sie die Abfrageansicht, und klicken Sie dann auf die Schaltfläche Alle löschen, um alle Filter zu entfernen.

So exportieren Sie Rasterdaten in eine Kalkulationstabelle

  1. Wählen Sie die zu exportierenden Zeilen aus. Um mehrere Zeilen auszuwählen, können Sie mit UMSCHALT+ZIEHEN einen Zeilenblock, mit STRG+KLICKEN bestimmte Zeilen oder mit STRG+A alle Zeilen auswählen.

    Darüber hinaus können die Ergebnisse gefiltert und sortiert werden, bevor Sie die Daten in eine Kalkulationstabelle kopieren. Beim Sortieren oder Filtern von Daten werden nur die resultierenden anzeigbaren Daten kopiert.

  2. Kopieren Sie die ausgewählten Zeilen mithilfe von STRG+C.

  3. Öffnen Sie die Seite mit der Tabellenarbeitsmappe, und fügen Sie die kopierten Zeilen mithilfe von STRG+V ein.

Weitere Informationen finden Sie unter Out-GridView (https://go.microsoft.com/fwlink/p/?LinkId=181248) und Erneute Beschäftigung mit Out-GridView (https://go.microsoft.com/fwlink/p/?LinkId=181249).