Get-SPLogEvent
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
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 |