Merge-SPUsageLog

  • Referenz
Modul:
SharePointServer
Gilt für::
SharePoint Server 2016, SharePoint Server 2019

Gibt Datensätze aus den Verwendungsprotokolldateien zurück.

Syntax

Merge-SPUsageLog
     [-Identity] <SPUsageDefinitionPipeBind>
     [-AssignmentCollection <SPAssignmentCollection>]
     [-DiagnosticLogPath <String>]
     [-EndTime <DateTime>]
     [-OverWrite]
     [-Partial]
     [-Servers <String[]>]
     [-StartTime <DateTime>]
     [<CommonParameters>]

Beschreibung

Das Merge-SPUsageLog Cmdlet gibt Datensätze aus den Verwendungsprotokolldateien auf jeder Serverfarm zurück, die den Kriterien entsprechen, und schreibt die Ergebnisse in die Pipeline.

Der Befehl Filter erfasst und aggregiert Protokolle basierend auf vom Benutzer angegebenen Kriterien, die Sie mit den Parametern StartTime und EndTime filtern sollten, um die Leistung dieses Cmdlet zu optimieren.

Sie sollten mindestens einen Verwendungstyp angeben. Informationen über gültige Verwendungstypen finden Sie unter Get-SPUsageDefinition.

Für dieses Cmdlet muss PowerShell-Remoting aktiviert sein.

Beispiele

Beispiel 1

Merge-SPUsageLog -Identity 'Timer Jobs' -Servers SPSERVER1

Führt das Verwendungsprotokoll für die Verwendungsdefinition "Timeraufträge" vom angegebenen Server zusammen und gibt in der PowerShell-Konsole aus.

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 2016, SharePoint Server 2019

-DiagnosticLogPath

Gibt die Datei zum Schreiben von Diagnoseinformationen an. Ein relativer Pfad wird unterstützt.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

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

Der Standardwert ist die aktuelle Uhrzeit.

Wenn Sie die UTC-Zeit angeben möchten, müssen Sie ein „Z" am Ende des Parameters hinzufügen. Beispiel: „2016-06-15 03:29:18.199 Z". Wenn das „Z" nicht angeben ist, wird statt der UTC-Zeit die lokale Uhrzeit des Computers angezeigt.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Identity

Gibt den Namen der Verwendungsprotokolldatei an.

Type:SPUsageDefinitionPipeBind
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-OverWrite

Überschreibt die Diagnoseprotokolldatei, wenn sie bereits unter dem angegebenen Pfad vorhanden ist.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Partial

Nicht verwendet.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Servers

Die Serveradressen, nach denen gefiltert wird.

Zum Abrufen einer Liste gültiger Adressen in der Farm verwenden Sie „ Get-SPServer | Select Address“.

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

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

Im Standardwert ist dies eine Stunde vor der aktuellen Zeit auf dem lokalen Computer.

Wenn Sie die UTC-Zeit angeben möchten, müssen Sie ein „Z" am Ende des Parameters hinzufügen. Beispiel: „2016-06-15 03:29:18.199 Z". Wenn das „Z" nicht angeben ist, wird statt der UTC-Zeit die lokale Uhrzeit des Computers angezeigt.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

Eingaben

Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Ausgaben

System.Object