Dela via


Get-History

Hämtar en lista över de kommandon som angavs under den aktuella sessionen.

Syntax

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

Description

Cmdleten Get-History hämtar sessionshistoriken, dvs. listan över kommandon som angavs under den aktuella sessionen.

PowerShell upprätthåller automatiskt en historik för varje session. Antalet poster i sessionshistoriken bestäms av värdet för $MaximumHistoryCount inställningsvariabeln. Från och med Windows PowerShell 3.0 är standardvärdet 4096. Som standard sparas historikfiler i hemkatalogen, men du kan spara filen på valfri plats. Mer information om historikfunktionerna i PowerShell finns i about_History.

Sessionshistoriken hanteras separat från historiken som underhålls av modulen PSReadLine. Båda historikerna är tillgängliga i sessioner där PSReadLine- läses in. Den här cmdleten fungerar bara med sessionshistoriken. Mer information finns i about_PSReadLine.

Exempel

Exempel 1: Hämta sessionshistoriken

Det här exemplet hämtar posterna i sessionshistoriken. Standardvisningen visar varje kommando och dess ID, vilket anger i vilken ordning de kördes.

Get-History

Exempel 2: Hämta poster som innehåller en sträng

Det här exemplet hämtar poster i kommandohistoriken som innehåller strängtjänsten. Det första kommandot hämtar alla poster i sessionshistoriken. Pipelineoperatorn (|) skickar resultatet till cmdleten Where-Object, som endast väljer de kommandon som innehåller tjänsten.

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

Exempel 3: Exportera historikposter upp till ett specifikt ID

Det här exemplet hämtar de fem senaste historikposterna som slutar med post 7. Pipelineoperatorn skickar resultatet till cmdleten Export-Csv, som formaterar historiken som kommaavgränsad text och sparar den i filen History.csv. Filen innehåller de data som visas när du formaterar historiken som en lista. Detta inkluderar status och start- och sluttider för kommandot.

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

Exempel 4: Visa det senaste kommandot

Det här exemplet hämtar det sista kommandot i kommandohistoriken. Det sista kommandot är det senast angivna kommandot. Det här kommandot använder parametern Count för att bara visa ett kommando. Som standard hämtar Get-History de senaste kommandona. Det här kommandot kan förkortas till "h -c 1" och motsvarar att trycka på uppåtpilen.

Get-History -Count 1

Exempel 5: Visa alla egenskaper för posterna i historiken

I det här exemplet visas alla egenskaper för poster i sessionshistoriken. Pipelineoperatorn skickar resultatet av ett Get-History-kommando till cmdleten Format-List, som visar alla egenskaper för varje historikpost. Detta inkluderar ID, status och start- och sluttider för kommandot.

Get-History | Format-List -Property *

Parametrar

-Count

Anger antalet av de senaste historikposterna som den här cmdleten får. Som standard hämtar Get-History alla poster i sessionshistoriken. Om du använder både parametrarna Count och ID i ett kommando, slutar displayen med kommandot som anges av parametern ID.

I Windows PowerShell 2.0 hämtar Get-History som standard de 32 senaste posterna.

Typ:Int32
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Id

Anger en matris med ID:t för poster i sessionshistoriken. Get-History hämtar endast angivna poster. Om du använder parametrarna ID och Count i ett kommando hämtar Get-History de senaste posterna som slutar med posten som anges av parametern ID.

Typ:Int64[]
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

Int64

Du kan skicka ett historik-ID till den här cmdleten.

Utdata

HistoryInfo

Den här cmdleten returnerar ett historikobjekt för varje historikobjekt som det får.

Kommentarer

PowerShell innehåller följande alias för Get-History:

  • Alla plattformar:
    • h
    • history
    • ghy

Sessionshistoriken är en lista över de kommandon som angavs under sessionen. Sessionshistoriken representerar körningsordningen, statusen och start- och sluttiderna för kommandot. När du anger varje kommando lägger PowerShell till det i historiken så att du kan återanvända det. Mer information om kommandohistoriken finns i about_History.

Från och med Windows PowerShell 3.0 är standardvärdet för $MaximumHistoryCount-inställningsvariabeln 4096. I Windows PowerShell 2.0 är standardvärdet 64. Mer information om variabeln $MaximumHistoryCount finns i about_Preference_Variables.