Sdílet prostřednictvím

Get-History

  • Reference
Modul:
Microsoft.PowerShell.Core

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

Syntax

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.

Type:Int32
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:Int64[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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

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

  • 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.