Get-History
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.
Típus: | Int32 |
Position: | 1 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | Int64[] |
Position: | 0 |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
Ehhez a parancsmaghoz csövezhet előzményazonosítót.
Kimenetek
Ez a parancsmag egy előzményobjektumot ad vissza minden egyes lekért előzményelemhez.
Jegyzetek
A Windows PowerShell a következő aliasokat Get-History
tartalmazza:
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 $MaximumHistoryCount
4096
. 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.