Freigeben über


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" -Overwrite

In 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 Search

In 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 High

In 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