Get-History

  • Referencia
Modul:
Microsoft.PowerShell.Core

Lekéri az aktuális munkamenet során megadott parancsok listáját.

Syntax

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

Description

A Get-History parancsmag lekéri a munkamenet előzményeit, vagyis az aktuális munkamenet során megadott parancsok listáját.

A PowerShell automatikusan megőrzi az egyes munkamenetek előzményeit. A munkamenet-előzmények bejegyzéseinek számát a beállítási változó értéke $MaximumHistoryCount határozza meg. A Windows PowerShell 3.0-tól kezdődően az alapértelmezett érték a .4096 Alapértelmezés szerint az előzményfájlok a kezdőkönyvtárba vannak mentve, de a fájlt bármilyen helyre mentheti. További információ a PowerShell előzményfunkcióiról: about_History.

A munkamenet-előzményeket a PSReadLine modul által fenntartott előzményektől elkülönítve kezeli a rendszer. Mindkét előzmények olyan munkamenetekben érhetők el, ahol a PSReadLine betöltődik. Ez a parancsmag csak a munkamenet-előzményekkel működik. További információ: about_PSReadLine.

Példák

1. példa: A munkamenet előzményeinek lekérése

Ez a példa beolvasja a munkamenet-előzmények bejegyzéseit. Az alapértelmezett megjelenítés megjeleníti az egyes parancsokat és annak azonosítóját, amely jelzi a futtatás sorrendjét.

Get-History

2. példa: Sztringet tartalmazó bejegyzések lekérése

Ez a példa a sztringszolgáltatást tartalmazó parancselőzmények bejegyzéseit tartalmazza. Az első parancs lekéri a munkamenet-előzmények összes bejegyzését. A folyamatkezelő (|) átadja az eredményeket a Where-Object parancsmagnak, amely csak a szolgáltatást tartalmazó parancsokat választja ki.

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

3. példa: Előzménybejegyzések exportálása egy adott azonosítóig

Ez a példa az öt legutóbbi, 7. bejegyzéssel végződő előzménybejegyzést kapja. A folyamatkezelő átadja az eredményt a Export-Csv parancsmagnak, amely vesszővel tagolt szövegként formázza az előzményeket, és menti azt a History.csv fájlba. A fájl tartalmazza azokat az adatokat, amelyek akkor jelennek meg, amikor listaként formázza az előzményeket. Ez magában foglalja a parancs állapotát, valamint a parancs kezdési és befejezési idejét.

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

4. példa: A legutóbbi parancs megjelenítése

Ez a példa lekéri a parancselőzmények utolsó parancsát. Az utolsó parancs a legutóbb beírt parancs. Ez a parancs a Count paraméter használatával csak egy parancsot jelenít meg. Alapértelmezés szerint Get-History lekéri a legújabb parancsokat. Ez a parancs rövidítése "h -c 1", és egyenértékű a felfelé mutató nyílbillentyű lenyomásával.

Get-History -Count 1

5. példa: Az előzmények bejegyzéseinek összes tulajdonságának megjelenítése

Ez a példa a munkamenet-előzmények bejegyzéseinek összes tulajdonságát jeleníti meg. A folyamatkezelő átadja egy Get-History parancs eredményét a Format-List parancsmagnak, amely megjeleníti az egyes előzménybejegyzések összes tulajdonságát. Ez magában foglalja a parancs azonosítóját, állapotát, valamint a parancs kezdési és befejezési idejét.

Get-History | Format-List -Property *

Paraméterek

-Count

Megadja a parancsmag által lekért legutóbbi előzménybejegyzések számát. Alapértelmezés szerint Get-History a munkamenet-előzmények összes bejegyzését lekéri. Ha egy parancsban a Darabszám és az Azonosító paramétereket is használja, a megjelenítés az Azonosító paraméter által megadott paranccsal fejeződik be.

A Windows PowerShell 2.0-ban alapértelmezés szerint Get-History a 32 legutóbbi bejegyzést kapja meg.

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

-Id

A munkamenet-előzmények bejegyzéseinek azonosítóinak tömbje. Get-History csak a megadott bejegyzéseket kapja meg. Ha az Azonosító és a Darab paramétert is használja egy parancsban, Get-History a legutóbbi bejegyzések az Id paraméter által megadott bejegyzéssel végződnek.

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

Bevitelek

Int64

Ehhez a parancsmaghoz csövezhet előzményazonosítót.

Kimenetek

HistoryInfo

Ez a parancsmag egy előzményobjektumot ad vissza minden egyes lekért előzményelemhez.

Jegyzetek

A PowerShell a következő aliasokat Get-Historytartalmazza:

  • Minden platform:
    • h
    • history
    • ghy

A munkamenet előzményei a munkamenet során megadott parancsok listája. A munkamenet előzményei a parancs futtatási sorrendjét, állapotát, valamint kezdési és befejezési idejét jelölik. Az egyes parancsok megadásakor a PowerShell hozzáadja az előzményekhez, hogy újra felhasználhassa. További információ a parancselőzményekről: about_History.

A Windows PowerShell 3.0-tól kezdődően a beállításváltozó alapértelmezett értéke a $MaximumHistoryCount4096. A Windows PowerShell 2.0-ban az alapértelmezett érték a .64 A változóval kapcsolatos további információkért lásd: $MaximumHistoryCount about_Preference_Variables.