Sdílet prostřednictvím

Get-History

Modul:
Microsoft.PowerShell.Core Module

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

Syntax

Default (Výchozí) 

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 proměnné preferencí $MaximumHistoryCount. Počínaje Windows PowerShellem 3.0 je výchozí hodnota 4096. 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, kde je načten modul PSReadLine. Tento cmdlet funguje jenom s historií relace. Další informace naleznete v about_PSReadLine.

Příklady

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

Tento příklad získá položky v historii session. 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é zahrnují ř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 potrubí (|) 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, přičemž končí u položky 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 získá 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 zobrazuje všechny vlastnosti položek v historii relace. Operátor kanálu předá výsledky příkazu Get-History rutině Format-List, která zobrazí všechny vlastnosti jednotlivých položek 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é tento cmdlet 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 Count i id id, končí zobrazení příkazem zadaným parametrem ID.

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

Vlastnosti parametru

Typ:Int32
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:1
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Id

Určuje pole ID záznamů 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.

Vlastnosti parametru

Typ:

Int64[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

Int64

Můžete přesměrovat ID historie do tohoto cmdletu.

Výstupy

HistoryInfo

Tento příkaz cmdlet 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 čas zahájení a dokonč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ů naleznete v tématu about_History.

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