Delen via

Get-History

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee haalt u een lijst op met de opdrachten die tijdens de huidige sessie zijn ingevoerd.

Syntaxis

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

Description

De Get-History cmdlet haalt de sessiegeschiedenis op, dat wil gezegd, de lijst met opdrachten die tijdens de huidige sessie zijn ingevoerd.

PowerShell onderhoudt automatisch een geschiedenis van elke sessie. Het aantal vermeldingen in de sessiegeschiedenis wordt bepaald door de waarde van de $MaximumHistoryCount voorkeursvariabele. Vanaf Windows PowerShell 3.0 is de standaardwaarde 4096.

U kunt de sessiegeschiedenis opslaan in XML- of CSV-indeling. Geschiedenisbestanden worden standaard opgeslagen in de basismap, maar u kunt het bestand op elke locatie opslaan.

Zie about_History in Microsoft Docs voor meer informatie over de geschiedenisfuncties in PowerShell.

Voorbeelden

Voorbeeld 1: De sessiegeschiedenis ophalen

Get-History

Met deze opdracht worden de vermeldingen in de sessiegeschiedenis opgeslagen. In de standaardweergave worden elke opdracht en de bijbehorende id weergegeven, die de volgorde aangeeft waarin ze zijn uitgevoerd.

Voorbeeld 2: Vermeldingen ophalen die een tekenreeks bevatten

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

Met deze opdracht worden vermeldingen in de opdrachtgeschiedenis opgeslagen die de tekenreeksservice bevatten. Met de eerste opdracht worden alle vermeldingen in de sessiegeschiedenis opgeslagen. De pijplijnoperator (|) geeft de resultaten door aan de Where-Object-cmdlet, die alleen de opdrachten selecteert die service bevatten.

Voorbeeld 3: Maximaal zeven vermeldingen exporteren

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

Met deze opdracht worden de vijf meest recente geschiedenisvermeldingen weergegeven die eindigen op item 7. De pijplijnoperator geeft het resultaat door aan de cmdlet Export-Csv, waarmee de geschiedenis wordt opgemaakt als door komma's gescheiden tekst en wordt opgeslagen in het History.csv bestand. Het bestand bevat de gegevens die worden weergegeven wanneer u de geschiedenis opmaken als een lijst. Dit omvat de status en begin- en eindtijden van de opdracht.

Voorbeeld 4: De meest recente opdracht weergeven

Get-History -Count 1

Met deze opdracht wordt de laatste opdracht in de opdrachtgeschiedenis weergegeven. De laatste opdracht is de laatst ingevoerde opdracht. Met deze opdracht wordt de parameter Count gebruikt om slechts één opdracht weer te geven. Get-History krijgt standaard de meest recente opdrachten. Deze opdracht kan worden afgekort tot 'h -c 1' en is gelijk aan het drukken op de toets pijl-omhoog.

Voorbeeld 5: alle eigenschappen van de vermeldingen in de geschiedenis weergeven

Get-History | Format-List -Property *

Met deze opdracht worden alle eigenschappen van vermeldingen in de sessiegeschiedenis weergegeven. De pijplijnoperator geeft de resultaten van een opdracht Get-History door aan de Format-List-cmdlet, waarin alle eigenschappen van elke geschiedenisvermelding worden weergegeven. Dit omvat de id, status en begin- en eindtijd van de opdracht.

Parameters

-Count

Hiermee geeft u het nummer op van de meest recente geschiedenisvermeldingen die door deze cmdlet worden ophaalt. Standaard worden Get-History alle vermeldingen in de sessiegeschiedenis ophaalt. Als u zowel de parameters Count als Id in een opdracht gebruikt, eindigt de weergave met de opdracht die is opgegeven door de parameter -id.

In Windows PowerShell 2.0 worden standaard Get-History de 32 meest recente vermeldingen ophaalt.

Type:Int32
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Hiermee geeft u een matrix van de id's van vermeldingen in de sessiegeschiedenis. Get-History alleen opgegeven vermeldingen krijgt. Als u zowel de parameters id als count in een opdracht gebruikt, krijgt Get-History de meest recente vermeldingen die eindigen op de vermelding die is opgegeven door de parameter Id.

Type:Int64[]
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

Int64

U kunt een geschiedenis-id doorsluisen naar deze cmdlet.

Uitvoerwaarden

HistoryInfo

Met deze cmdlet wordt een geschiedenisobject geretourneerd voor elk geschiedenisitem dat wordt opgehaald.

Notities

  • De sessiegeschiedenis is een lijst met de opdrachten die tijdens de sessie zijn ingevoerd. De sessiegeschiedenis vertegenwoordigt de uitvoeringsvolgorde, de status en de begin- en eindtijd van de opdracht. Terwijl u elke opdracht invoert, voegt PowerShell deze toe aan de geschiedenis, zodat u deze opnieuw kunt gebruiken. Zie about_Historyvoor meer informatie over de opdrachtgeschiedenis.
  • Vanaf Windows PowerShell 3.0 is de standaardwaarde van de $MaximumHistoryCount voorkeursvariabele 4096. In Windows PowerShell 2.0 is de standaardwaarde 64. Zie about_Preference_Variablesvoor meer informatie over de variabele $MaximumHistoryCount.