Freigeben über

Get-History

  • Referenz
Modul:
Microsoft.PowerShell.Core

Ruft eine Liste der Befehle ab, die während der aktuellen Sitzung eingegeben wurden.

Syntax

Get-History
   [[-Id] <Int64[]>]
   [[-Count] <Int32>]
   [<CommonParameters>]

Beschreibung

Das Get-History Cmdlet ruft den Sitzungsverlauf ab, d. h. die Liste der Befehle, die während der aktuellen Sitzung eingegeben wurden.

PowerShell verwaltet automatisch einen Verlauf jeder Sitzung. Die Anzahl der Einträge im Sitzungsverlauf wird durch den Wert der $MaximumHistoryCount Einstellungsvariablen bestimmt. Ab Windows PowerShell 3.0 lautet 4096der Standardwert . Standardmäßig werden Verlaufsdateien im Basisverzeichnis gespeichert, Sie können die Datei jedoch an einem beliebigen Speicherort speichern. Weitere Informationen zu den Verlaufsfeatures in PowerShell finden Sie unter about_History.

Der Sitzungsverlauf wird getrennt vom Verlauf verwaltet, der vom PSReadLine-Modul verwaltet wird. Beide Historien sind in Sitzungen verfügbar, in denen PSReadLine geladen wird. Dieses Cmdlet funktioniert nur mit dem Sitzungsverlauf. Weitere Informationen finden Sie unter about_PSReadLine.

Beispiele

Beispiel 1: Abrufen des Sitzungsverlaufs

In diesem Beispiel werden die Einträge im Sitzungsverlauf abgerufen. Die Standardanzeige zeigt jeden Befehl und seine ID an, die die Reihenfolge angibt, in der sie ausgeführt wurden.

Get-History

Beispiel 2: Abrufen von Einträgen, die eine Zeichenfolge enthalten

In diesem Beispiel werden Einträge im Befehlsverlauf abgerufen, die den Zeichenfolgendienst enthalten. Der erste Befehl ruft alle Einträge im Sitzungsverlauf ab. Der Pipelineoperator (|) übergibt die Ergebnisse an das Where-Object Cmdlet, das nur die Befehle auswählt, die den Dienst enthalten.

Get-History | Where-Object {$_.CommandLine -like "*Service*"}

Beispiel 3: Exportieren von Verlaufseinträgen bis zu einer bestimmten ID

In diesem Beispiel werden die fünf neuesten Verlaufseinträge abgerufen, die mit Eintrag 7 enden. Der Pipelineoperator übergibt das Ergebnis an das Export-Csv Cmdlet, das den Verlauf als durch Trennzeichen getrennten Text formatiert und in der History.csv-Datei speichert. Die Datei enthält die Daten, die angezeigt werden, wenn Sie den Verlauf als Liste formatieren. Dies schließt die status und Start- und Endzeiten des Befehls ein.

Get-History -ID 7 -Count 5 | Export-Csv -Path History.csv

Beispiel 4: Anzeigen des neuesten Befehls

In diesem Beispiel wird der letzte Befehl im Befehlsverlauf abgerufen. Der letzte Befehl ist der zuletzt eingegebene Befehl. Dieser Befehl verwendet den Count-Parameter , um nur einen Befehl anzuzeigen. Ruft standardmäßig Get-History die neuesten Befehle ab. Dieser Befehl kann mit „h -c 1“ abgekürzt werden und entspricht dem Drücken der NACH-OBEN-TASTE.

Get-History -Count 1

Beispiel 5: Anzeigen aller Eigenschaften der Einträge im Verlauf

In diesem Beispiel werden alle Eigenschaften von Einträgen im Sitzungsverlauf angezeigt. Der Pipelineoperator übergibt die Ergebnisse eines Get-History Befehls an das Format-List Cmdlet, das alle Eigenschaften der einzelnen Verlaufseinträge anzeigt. Dies umfasst die ID, status sowie Start- und Endzeiten des Befehls.

Get-History | Format-List -Property *

Parameter

-Count

Gibt die Anzahl der neuesten Verlaufseinträge an, die dieses Cmdlet abruft. Ruft standardmäßig Get-History alle Einträge im Sitzungsverlauf ab. Wenn Sie sowohl den Count- als auch den Id-Parameter in einem Befehl verwenden, endet die Anzeige mit dem Befehl, der vom Id-Parameter angegeben wird.

Ruft in Windows PowerShell 2.0 standardmäßig Get-History die 32 neuesten Einträge ab.

Type:Int32
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Gibt ein Array der IDs von Einträgen im Sitzungsverlauf an. Get-History ruft nur angegebene Einträge ab. Wenn Sie sowohl die Parameter Id als auch Count in einem Befehl verwenden, ruft die neuesten Einträge ab, Get-History die mit dem durch den Id-Parameter angegebenen Eintrag enden.

Type:Int64[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

Int64

Sie können eine Verlaufs-ID an dieses Cmdlet weiterleiten.

Ausgaben

HistoryInfo

Dieses Cmdlet gibt ein Verlaufsobjekt für jedes Verlaufselement zurück, das es erhält.

Hinweise

PowerShell enthält die folgenden Aliase für Get-History:

  • Alle Plattformen:
    • h
    • history
    • ghy

Der Sitzungsverlauf ist eine Liste der Befehle, die während der Sitzung eingegeben wurden. Der Sitzungsverlauf stellt die Ausführungsreihenfolge, die status sowie die Start- und Endzeiten des Befehls dar. Wenn Sie jeden Befehl eingeben, fügt PowerShell ihn dem Verlauf hinzu, sodass Sie ihn wiederverwenden können. Weitere Informationen zum Befehlsverlauf finden Sie unter about_History.

Ab Windows PowerShell 3.0 ist 4096der Standardwert der $MaximumHistoryCount Einstellungsvariable. In Windows PowerShell 2.0 ist 64der Standardwert . Weitere Informationen zur $MaximumHistoryCount Variablen finden Sie unter about_Preference_Variables.