Get-SPLogEvent

Referenz

Modul:: sharepoint-server

Gilt für::: SharePoint Server Subscription Edition

Gibt Ergebnisse aus einem ULS-Ablaufverfolgungsprotokoll zurück.

Syntax

Get-SPLogEvent
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AsString]
   [-ContextKey <String[]>]
   [-Directory <String>]
   [-MinimumLevel <String>]
   [-EndTime <DateTime>]
   [-StartTime <DateTime>]
   [<CommonParameters>]

Get-SPLogEvent
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AsString]
   [-ContextKey <String[]>]
   [-MinimumLevel <String>]
   [-EndTime <DateTime>]
   [-File <String>]
   [-StartTime <DateTime>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet umfasst mehrere Parametersätze. Sie können nur Parameter aus einem der Parametersätze verwenden und können Parameter aus unterschiedlichen Parametersätzen nicht miteinander kombinieren. Weitere Informationen zur Verwendung von Parametersätzen finden Sie unter Parametersätze für Cmdlets.

Mit dem Cmdlet Get-SPLogEvent werden Datensätze aus einer ULS-Ablaufverfolgungsprotokolldatei (Unified Logging Service, Vereinheitlichter Protokollierungsdienst) zurückgegeben, die mit den Kriterien übereinstimmen. Wenn keine Parameter angegeben werden, werden alle Datensätze aus allen Protokolldateien zurückgegeben. Verwenden Sie die Parameter StartTime und EndTime, um einen Zeitbereich zu filtern. Die Verwendung dieser Parameter wird empfohlen, um die Leistung dieses Cmdlets zu optimieren.

Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.

Beispiele

--------------BEISPIEL 1-----------------

Get-SPLogEvent -MinimumLevel "Warning"

Dieses Beispiel gibt alle Protokolleinträge aus dem Standardprotokollverzeichnis zurück, die einen höheren Schweregrad als Warning aufweisen.

--------------BEISPIEL 2-----------------

Get-SPLogEvent -Directory "C:\Logs" | Where-Object {$_.Level -eq "Warning"}

In diesem Beispiel werden alle Warneinträge aus Protokolldateien im Verzeichnis C:\Logs zurückgegeben.

--------------BEISPIEL 3-----------------

Get-SPLogEvent -StartTime "12/04/2007 17:00" -EndTime "12/04/2007 18:00"

In diesem Beispiel werden Fehlereinträge zurückgegeben, die in einem bestimmten Zeitbereich aufgetreten sind, der kulturspezifisch für USA ist.

--------------BEISPIEL 4-----------------

Get-SPLogEvent -ContextKey @("UserName" ,"SiteName")

In diesem Beispiel wird der Inhalt der aktuellen Protokolldatei zurückgegeben, und die angegebenen Kontextschlüsseldaten werden hinzugefügt.

--------------BEISPIEL 5-----------------

Get-SPLogEvent | Where-Object {$_.Level -eq "Error" -and {$_.Area -eq "SharePoint Foundation "}

In diesem Beispiel werden alle Fehlereinträge in Bezug auf SharePoint Foundation zurückgegeben.

--------------BEISPIEL 6-----------------

Get-SPLogEvent -ContextKey @("Name") | %{$_.ToString() + "'t" + $_.Context["Name"]}

In diesem Beispiel werden die Inhalte der Protokolldatei zurückgegeben und Kontextdaten hinzugefügt.

Parameter

-AssignmentCollection

Verwaltet Objekte zum Zweck der ordnungsgemäßen Beseitigung. Die Verwendung von Objekten wie beispielsweise SPWeb oder SPSite kann sehr viel Arbeitsspeicher erfordern, und für die Verwendung dieser Objekte in Windows PowerShell-Skripts muss der Arbeitsspeicher entsprechend verwaltet werden. Mit dem SPAssignment-Objekt können Sie einer Variablen Objekte zuweisen und die Objekte beseitigen, wenn sie nicht mehr benötigt werden, um Arbeitsspeicher freizugeben. Wenn die Objekte SPWeb, SPSite oder SPSiteAdministration verwendet werden, werden diese automatisch beseitigt, falls keine Zuweisungsauflistung oder kein Global-Parameter verwendet wird.

Wenn der Global-Parameter verwendet wird, sind alle Objekte im globalen Speicher enthalten. Es kann vorkommen, dass nicht genügend Arbeitsspeicher vorhanden ist, falls Objekte nicht sofort verwendet werden oder mit dem Befehl Stop-SPAssignment beseitigt werden.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-AsString

Gibt die Datensätze als separate Zeichenfolgen zurück.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-ContextKey

Gibt an, dass den Ergebnissen für die angegebenen Kontextschlüssel Kontextdaten hinzugefügt werden sollen, z. B. -ContextKey @("UserName", "SiteName").

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Directory

Listet Protokolldateien aus einem alternativen Verzeichnis auf, bei dem es sich nicht um das konfigurierte Verzeichnis LogLocation handelt.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-EndTime

Bei dem Typ muss es sich um ein gültiges Format für Datum/Uhrzeit handeln, das für die Verwaltungssprache kulturspezifisch ist, z. B. 2/16/2007 12:15:12 für Englisch (USA).

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-File

Gibt eine bestimmte Datei an, aus der Datensätze abgefragt werden.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-MinimumLevel

Gibt Datensätze zurück, die sich auf oder über der angegebenen Ebene befinden. Die gültigen Werte sind Fehler oder Warnung.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-StartTime