Merge-SPUsageLog
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 SPSERVER1Fü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