Get-History

Modul:
Microsoft.PowerShell.Core Module

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

Syntax

Default (Standard) 

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 är laddad. Den här cmdleten fungerar bara med sessionshistoriken. Mer information finns i about_PSReadLine.

Exempel

Exempel 1: Hämta sessionshistoriken

Detta exempel hämtar posterna från 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 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 standardinställning 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 de 32 senaste posterna som standard.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

Int64[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:0
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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

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.