Merge-SPLogFile
Führt die Einträge in den Ablaufverfolgungsprotokollen von allen Computern in der Farm in einer Protokolldatei auf dem lokalen Computer zusammen.
Syntax
Merge-SPLogFile
-Path <String>
[-Area <String[]>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Category <String[]>]
[-ContextFilter <String[]>]
[-Correlation <Guid[]>]
[-EndTime <DateTime>]
[-EventID <String[]>]
[-ExcludeNestedCorrelation]
[-Level <String>]
[-Message <String[]>]
[-Overwrite]
[-Process <String[]>]
[-StartTime <DateTime>]
[-ThreadID <UInt32[]>]
[<CommonParameters>] Beschreibung
Mit dem Cmdlet Merge-SPLogFile werden Einträge aus ULS-Ablaufverfolgungsprotokolldateien (Unified Logging Service, Vereinheitlichter Protokollierungsdienst) auf den einzelnen Servern in einer Farm, die mit den Kriterien übereinstimmen, zurückgegeben, und die Ergebnisse werden in eine neue Protokolldatei auf dem lokalen Computer geschrieben. Wenn keine Ergebnisse zurückgegeben werden, wird eine Warnung in das Windows PowerShell Konsolenfenster geschrieben.
Es wird empfohlen, mithilfe der Parameter StartTime und EndTime zu filtern, um die Leistung des Cmdlets zu optimieren. Manche Filterparameter wie Process, Area, Category, EventID und Message unterstützen Platzhalter.
Informationen zu Berechtigungen sowie Aktuelles zu Windows PowerShell für SharePoint-Produkte finden Sie in der Onlinedokumentation unter SharePoint Server-Cmdlets.
Beispiele
--------------BEISPIEL 1-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -OverwriteIn diesem Beispiel werden die Protokolldaten der letzten Stunde von allen Computern in der Farm ohne Filterung zusammengeführt.
--------------BEISPIEL 2-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Area SearchIn diesem Beispiel werden die Protokolldaten der letzten Stunde aus dem Bereich Search zusammengeführt.
--------------BEISPIEL 3-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Area "SharePoint Foundation","Web Analytics Services"In diesem Beispiel werden die Protokolldaten der letzten Stunde aus den Bereichen SharePoint Foundation und Web Analytics Services zusammengeführt.
--------------BEISPIEL 4-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Level HighIn diesem Beispiel werden die Protokolldaten der Stufe High oder höher zusammengeführt.
--------------BEISPIEL 5-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -StartTime "06/09/2008 16:00" -EndTime "06/09/2008 16:15"In diesem Beispiel werden die Protokolldaten für Ereignisse in einem bestimmten Zeitbereich zusammengeführt, der kulturspezifisch für die USA ist.
--------------BEISPIEL 6-----------------
Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Message "*permission changed*"In diesem Beispiel werden die Protokolldaten für Ereignisse zusammengeführt, bei denen im Nachrichtentext permission changed enthalten ist.
--------------BEISPIEL 7-----------------
Merge-SPLogFile -Overwrite -Path d:\1.log -ContextFilter "name=timer job*" -Area "*search*"In diesem Beispiel werden die Protokolldaten für alle Suchzeitgeberaufträge zusammengeführt.
--------------BEISPIEL 8-----------------
Merge-SPLogFile -Overwrite -Path d:\2.log -ContextFilter "user=contoso?joeuser"In diesem Beispiel wird dargestellt, wie die Protokolldaten für alle Benutzernamen, die das Format contoso\joeuser oder Contoso/joeuser aufweisen, zusammengeführt werden.
Parameter
-Area
Gibt den Bereichsnamen an, nach dem gefiltert werden soll.
Bei dem Typ muss es sich um einen gültigen Namen handeln, z. B. SharePoint Foundation.
Die Verwendung von Platzhalterzeichen wird unterstützt.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-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 |
-Category
Gibt die Kategorie-ID an, nach der gefiltert werden soll.
Bei dem Typ muss es sich um einen gültigen Kategoriennamen handeln, z. B. Kategorie1.
Die Verwendung von Platzhalterzeichen wird unterstützt.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ContextFilter
Gibt einen Filter für Ablaufverfolgungsprotokolleinträge in einem bestimmten Kontext im Format Schlüssel=Wert an, z. B. user=contoso\joeuser an.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Correlation
Gibt die Korrelations-ID an, nach der gefiltert werden soll. Bei dem Typ muss es sich um eine gültige GUID im Format F0BB0790-4323-A153-096F-ABCDC80E24D4 handeln.
| Type: | Guid[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-EndTime
Gibt die Endzeit der zurückgegebenen Protokolleinträge zurück.
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 |
-EventID
Gibt die Ereigniskennung an, nach der gefiltert werden soll. Die Verwendung von Platzhalterzeichen wird unterstützt.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ExcludeNestedCorrelation
Schließt in den Ergebnissen geschachtelte Korrelationswerte aus. Dieser Parameter wird nur verwendet, wenn Ergebnisse mithilfe des ContextFilter -Parameters gefiltert werden.
Standardmäßig enthalten datensätze, die vom ContextFilter-Parameter zurückgegeben werden, zusätzlich zu den Datensätzen, die dem Filter entsprechen, alle zugehörigen Datensätze. Die Angabe dieser Option schließt nur die Datensätze ein, die dem Filter entsprechen, und schließt alle zugehörigen Datensätze aus.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Level
Gibt den Namen der Ebene an, nach der gefiltert werden soll.
Die Ergebnisse enthalten die angegebene Ebene und alle Einträge mit einem höheren Schweregrad.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Message
Gibt den Nachrichtentext an, nach dem gefiltert werden soll.
Bei dem Typ muss es sich um gültigen Text handeln. Schließen Sie Text mit Leerzeichen in Anführungszeichen ein, z. B. "Dies ist ein Test."
Die Verwendung von Platzhalterzeichen wird unterstützt.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Overwrite
Überschreibt die Protokolldatei, wenn sie bereits unter dem angegebenen Pfad vorhanden ist.
Bei dem Typ muss es sich um einen der folgenden Werte handeln:
- $True
- $False
Der Standardwert ist $False.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Path
Gibt den Pfad und den Dateinamen zum Erstellen der zusammengeführten Protokolldatei an. Relative Pfade werden unterstützt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Process
Gibt den Prozessnamen an, nach dem gefiltert werden soll.
Die Verwendung von Platzhalterzeichen wird unterstützt.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-StartTime
Gibt die Startzeit der zurückgegebenen Protokolleinträge zurück.
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).
In der Standardeinstellung ist dies eine Stunde vor der aktuellen Zeit auf dem lokalen Computer.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ThreadID
Gibt die Thread-ID an, nach der gefiltert werden soll.
Der Typ muss eine zulässige ganze Zahl zwischen 0 und 4.294.967.295 sein.
| Type: | UInt32[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |