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, d.v.s. 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 4096standardvärdet . 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 PSReadLine-modulen . 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 Get-History hämtar du 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 Get-History hämtar alla poster i sessionshistoriken. Om du använder parametrarna Antal och ID i ett kommando slutar visningen med kommandot som anges av ID-parametern .

I Windows PowerShell 2.0 hämtar som standard Get-History 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 Get-History hämtar du de senaste posterna som slutar med posten som anges av ID-parametern .

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 4096standardvärdet för inställningsvariabeln $MaximumHistoryCount . I Windows PowerShell 2.0 är 64standardvärdet . Mer information om variabeln finns i $MaximumHistoryCount about_Preference_Variables.