Anzeigen von Diagnoseprotokollen in SharePoint Server

GILT FÜR:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

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.

Anzeigen und Filtern von Protokollereignissen mithilfe von 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 zeigen Sie Protokollereignisse mithilfe von PowerShell an und filtern sie

  1. Vergewissern Sie sich, dass Sie über die folgenden Mitgliedschaften verfügen:
  • 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

    [!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.

  1. Wechseln Sie zur SharePoint-Verwaltungsshell.

  2. Geben Sie an der Microsoft 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>"}

Wobei <string> die Zeichenfolge ist, die in der Ereignismeldung gefunden wurde.

  • 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 PowerShell Out-GridView-Cmdlets

PowerShell bietet ein leistungsstarkes und benutzerfreundliches Feature, das tabellarische Daten, die sich aus PowerShell-Befehlen ergeben, in einem filterbaren, durchsuchbaren Datenraster in einem separaten Fenster anzeigt. 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

[!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 anzeigen, indem Sie das Cmdlet Where-Object verwenden, das die Ergebnisse filtert und an das Out-GridView-Cmdlet übergibt. Beispiel: Get-SPLogEvent | Where-Object {$_.Area -eq "SharePoint Foundation"} | Out-GridView. > Wenn das Raster mehr als mehrere hundert Zeilen anzeigt, kann es langsam ausgeführt werden, insbesondere wenn komplexe Filtervorgänge ausgeführt werden. 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 über die folgenden Mitgliedschaften verfügen:
  • 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

    [!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.

  1. Wechseln Sie zur SharePoint-Verwaltungsshell.

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

Get-SPLogEvent | Out-GridView
  1. Klicken Sie auf die Spaltenüberschrift, um Spalten zu sortieren.

  2. 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.

  3. 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.

  4. 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:

  5. Klicken Sie auf Kriterien hinzufügen.

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

  7. 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.

  8. Geben Sie im Textfeld einen Wert ein.

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

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

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

  12. 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 und Out-GridView Revisited.