Ruft eine Liste der Befehle ab, die während der aktuellen Sitzung eingegeben wurden.
Syntax
Get-History [[-Id] <Int64[]>] [[-Count] <int>] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Get-History" wird der Sitzungsverlauf (die Liste der im Verlauf der aktuellen Sitzung eingegebenen Befehle) abgerufen. In Windows PowerShell wird automatisch ein Verlauf für jede Sitzung verwaltet. Sie können den Sitzungsverlauf im Format XML oder CSV speichern. Standardmäßig werden Verlaufsdateien im Stammverzeichnis gespeichert, Sie können die Datei jedoch an einem beliebigen Speicherort speichern.
Parameter
-Count <int>
Zeigt die angegebene Anzahl der aktuellen Verlaufseinträge an. Der Standardwert ist 32. Wenn Sie sowohl den Parameter "Count" als auch "Id" in einem Befehl angeben, endet die Anzeige mit dem Befehl, der durch den Id-Parameter angegeben wurde.
|
Erforderlich? |
false |
|
Position? |
2 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Id <Int64[]>
Gibt die ID eines Befehls im Sitzungsverlauf an. Get-History ruft nur den angegebenen Befehl ab. Wenn Sie "ID" und "Count" angeben, ruft Get-History die zuletzt verwendeten Befehle bis zu dem Befehl ab, der durch den ID-Parameter angegeben wurde.
|
Erforderlich? |
false |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
true (ByValue) |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
Int64 Sie können eine Verlaufs-ID über die Pipeline an Get-History übergeben. |
|
Ausgaben |
Microsoft.PowerShell.Commands.HistoryInfo Get-History gibt ein Verlaufsobjekt für jedes abgerufene Verlaufselement zurück. |
Hinweise
Der Sitzungsverlauf enthält eine Liste der Befehle, die während der aktuellen Sitzung neben der ID eingegeben wurden. Der Sitzungsverlauf stellt die Ausführungsreihenfolge, den Status sowie Start- und Endzeit des Befehls dar. Beim Eingeben der einzelnen Befehle werden diese von Windows PowerShell dem Verlauf hinzugefügt, sodass Sie diese wiederverwenden können. Weitere Informationen über den Befehlsverlauf finden Sie unter "about_History".
Sie können auch über die integrierten Aliase "h", "history" und "ghy" auf Get-History verweisen. Weitere Informationen finden Sie unter "about_Aliases".
Beispiel 1
C:\PS>get-history Beschreibung ----------- Mit diesem Befehl werden die 32 zuletzt gesendeten Befehle abgerufen. In der Standardanzeige werden die einzelnen Befehle und ihre ID aufgeführt, wodurch die Reihenfolge ihrer Ausführung angegeben wird.
Beispiel 2
C:\PS>get-history | where-object {$_.commandLine -like "*service*"}
Beschreibung
-----------
Mit diesem Befehl werden die Einträge aus dem Befehlsverlauf abgerufen, die das Wort "service" enthalten. Im ersten Befehl werden die 32 letzten Einträge im Sitzungsverlauf abgerufen. Mit dem Pipelineoperator (|) werden die Ergebnisse an das Cmdlet "Where-Object" übergeben, das nur die Befehle auswählt, die das Wort "service" enthalten.
Beispiel 3
C:\PS>get-history -id 7 -count 5 | export-csv history.csv Beschreibung ----------- Mit diesem Befehl werden die letzten fünf Einträge bis zum Eintrag 7 abgerufen. Mit dem Pipelineoperator (|) werden die Ergebnisse an das Cmdlet "Export-Csv" übergeben, das den Verlauf als durch Kommas getrennten Text formatiert und in der Datei "History.csv" speichert. Die Datei enthält die Daten, die angezeigt werden, wenn der Verlauf als Liste formatiert wird, einschließlich Status und Start- und Endzeit des Befehls.
Beispiel 4
C:\PS>get-history -count 1 Beschreibung ----------- Mit diesem Befehl wird der letzte (zuletzt eingegebene) Befehl im Sitzungsverlauf abgerufen. Mit dem Count-Parameter wird lediglich ein Befehl angezeigt. Standardmäßig werden von Get-History die letzten Befehle angezeigt. Dieser Befehl kann mit "h -c 1" abgekürzt werden, und er entspricht dem Drücken der NACH-OBEN-TASTE.
Beispiel 5
C:\PS>get-history -count $MaximumHistoryCount Beschreibung ----------- Mit diesem Befehl werden alle im Sitzungsverlauf gespeicherten Befehle angezeigt. Standardmäßig weist "$MaximumHistoryCount" den Wert 64 auf, daher kann dieser Befehl mit "h -c 64" abgekürzt werden.
Beispiel 6
C:\PS>get-history | format-list Beschreibung ----------- Mit diesem Befehl werden alle Eigenschaften der Einträge im Sitzungsverlauf angezeigt. Mit dem Pipelineoperator (|) werden die Ergebnisse an das Cmdlet "Format-List" übergeben, der alle Eigenschaften der einzelnen Verlaufseinträge anzeigt, einschließlich ID, Status sowie Start- und Endzeit des Befehls.
Siehe auch