Freigeben über

Get-History

Modul:
Microsoft.PowerShell.Core Module

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

Syntax

Default (Standard) 

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

Beschreibung

Das Cmdlet Get-History 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 ist der Standardwert 4096.

Sie können den Sitzungsverlauf im XML- oder CSV-Format speichern. Standardmäßig werden Verlaufsdateien im Startverzeichnis gespeichert, aber Sie können die Datei an jedem beliebigen Speicherort speichern.

Weitere Informationen zu den Verlaufsfeatures in PowerShell finden Sie unter about_History in der Microsoft-Dokumentation .

Beispiele

Beispiel 1: Abrufen des Sitzungsverlaufs

Get-History

Mit diesem Befehl 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.

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

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

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

Beispiel 3: Exportieren von maximal sieben Einträgen

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

Mit diesem Befehl werden die fünf neuesten Verlaufseinträge abgerufen, die mit Eintrag 7 enden. Der Pipelineoperator übergibt das Ergebnis an das Cmdlet Export-Csv, 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 den Status und die Start- und Endzeiten des Befehls ein.

Beispiel 4: Anzeigen des letzten Befehls

Get-History -Count 1

Mit diesem Befehl wird der letzte Befehl im Befehlsverlauf abgerufen. Der letzte Befehl ist der zuletzt eingegebene Befehl. Dieser Befehl verwendet den Parameter Count, um nur einen Befehl anzuzeigen. Standardmäßig ruft 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.

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

Get-History | Format-List -Property *

Mit diesem Befehl werden alle Eigenschaften von Einträgen im Sitzungsverlauf angezeigt. Der Pipelineoperator übergibt die Ergebnisse eines Get-History-Befehls an das Cmdlet Format-List, das alle Eigenschaften der einzelnen Verlaufseinträge anzeigt. Dazu gehören die ID, der Status und die Start- und Endzeiten des Befehls.

Parameter

-Count

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

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

Parametereigenschaften

Typ:Int32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

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

Parametereigenschaften

Typ:

Int64[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

Int64

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

Ausgaben

HistoryInfo

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

Hinweise

  • Der Sitzungsverlauf ist eine Liste der Befehle, die während der Sitzung eingegeben wurden. Der Sitzungsverlauf stellt die Ausführungsreihenfolge, den Status und die Start- und Endzeiten des Befehls dar. Während Sie jeden Befehl eingeben, fügt PowerShell ihn dem Verlauf hinzu, damit Sie ihn wiederverwenden können. Weitere Informationen zum Befehlsverlauf finden Sie unter about_History.
  • Ab Windows PowerShell 3.0 ist der Standardwert der $MaximumHistoryCount Einstellungsvariablen 4096. In Windows PowerShell 2.0 ist der Standardwert 64. Weitere Informationen zur Variable $MaximumHistoryCount finden Sie unter about_Preference_Variables.