Sdílet prostřednictvím

Get-History

  • Reference
Modul:
Microsoft.PowerShell.Core

Získá seznam příkazů zadaných během aktuální relace.

Syntaxe

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

Description

Rutina Get-History získá historii relace, tj. seznam příkazů zadaných během aktuální relace.

PowerShell automaticky udržuje historii každé relace. Počet položek v historii relace je určen hodnotou $MaximumHistoryCount proměnné předvoleb. Počínaje Windows PowerShellem 3.0 je 4096výchozí hodnota . Ve výchozím nastavení se soubory historie ukládají do domovského adresáře, ale soubor můžete uložit do libovolného umístění. Další informace o funkcích historie v PowerShellu najdete v tématu about_History.

Historie relací se spravuje odděleně od historie spravované modulem PSReadLine . Obě historie jsou k dispozici v relacích, ve kterých je načtena funkce PSReadLine . Tato rutina funguje jenom s historií relace. Další informace najdete v about_PSReadLine.

Příklady

Příklad 1: Získání historie relací

Tento příklad získá položky v historii relace. Výchozí zobrazení zobrazuje každý příkaz a jeho ID, které označuje pořadí, ve kterém byly spuštěny.

Get-History

Příklad 2: Získání položek, které obsahují řetězec

Tento příklad získá položky v historii příkazů, které zahrnují řetězcovou službu. První příkaz získá všechny položky v historii relace. Operátor kanálu (|) předá výsledky rutině Where-Object , která vybere jenom příkazy, které zahrnují službu.

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

Příklad 3: Export položek historie až do konkrétního ID

Tento příklad získá pět nejnovějších položek historie končící položkou 7. Operátor kanálu předá výsledek rutině Export-Csv , která formátuje historii jako text oddělený čárkami a uloží ho do souboru History.csv. Soubor obsahuje data, která se zobrazí při formátování historie jako seznamu. To zahrnuje stav a časy zahájení a ukončení příkazu.

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

Příklad 4: Zobrazení nejnovějšího příkazu

Tento příklad získá poslední příkaz v historii příkazů. Poslední příkaz je naposledy zadaný příkaz. Tento příkaz používá parametr Count k zobrazení pouze jednoho příkazu. Ve výchozím nastavení Get-History načte nejnovější příkazy. Tento příkaz lze zkrátit na "h -c 1" a je ekvivalentní stisknutí klávesy se šipkou nahoru.

Get-History -Count 1

Příklad 5: Zobrazení všech vlastností položek v historii

Tento příklad zobrazí všechny vlastnosti položek v historii relace. Operátor kanálu předá výsledky Get-History příkazu do Format-List rutiny, která zobrazí všechny vlastnosti každé položky historie. To zahrnuje ID, stav a časy zahájení a ukončení příkazu.

Get-History | Format-List -Property *

Parametry

-Count

Určuje počet nejnovějších položek historie, které tato rutina získá. Ve výchozím nastavení Get-History získá všechny položky v historii relace. Pokud v příkazu použijete parametry Počet i ID , skončí zobrazení příkazem určeným parametrem ID .

Ve Windows PowerShellu 2.0 ve výchozím nastavení Get-History získá 32 nejnovějších položek.

Typ:Int32
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Id

Určuje pole ID položek v historii relace. Get-History získá pouze zadané položky. Pokud v příkazu použijete parametry ID i Počet , Get-History získá nejnovější položky končící položkou určenou parametrem ID .

Typ:Int64[]
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

Int64

Id historie můžete do této rutiny převést.

Výstupy

HistoryInfo

Tato rutina vrátí objekt historie pro každou položku historie, kterou získá.

Poznámky

PowerShell obsahuje následující aliasy pro Get-History:

  • Všechny platformy:
    • h
    • history
    • ghy

Historie relací je seznam příkazů zadaných během relace. Historie relace představuje pořadí spuštění, stav a časy spuštění a ukončení příkazu. Při zadávání každého příkazu ho PowerShell přidá do historie, abyste ho mohli znovu použít. Další informace o historii příkazů najdete v tématu about_History.

Počínaje Windows PowerShellem 3.0 je 4096výchozí hodnota $MaximumHistoryCount proměnné předvoleb . Ve Windows PowerShellu 2.0 je 64výchozí hodnota . Další informace o $MaximumHistoryCount proměnné najdete v tématu about_Preference_Variables.