Get-History
Hiermee haalt u een lijst op van de opdrachten die tijdens de huidige sessie zijn ingevoerd.
Syntax
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 houdt automatisch een geschiedenis bij van elke sessie. Het aantal vermeldingen in de sessiegeschiedenis wordt bepaald door de waarde van de $MaximumHistoryCount
voorkeursvariabele. Vanaf Windows PowerShell 3.0 is 4096
de standaardwaarde . Geschiedenisbestanden worden standaard opgeslagen in de basismap, maar u kunt het bestand op elke locatie opslaan. Zie about_History voor meer informatie over de geschiedenisfuncties in PowerShell.
De sessiegeschiedenis wordt afzonderlijk beheerd van de geschiedenis die wordt onderhouden door de PSReadLine-module . Beide geschiedenissen zijn beschikbaar in sessies waarin PSReadLine is geladen. Deze cmdlet werkt alleen met de sessiegeschiedenis. Zie about_PSReadLine voor meer informatie.
Voorbeelden
Voorbeeld 1: De sessiegeschiedenis ophalen
In dit voorbeeld worden de vermeldingen in de sessiegeschiedenis opgeslagen. De standaardweergave toont elke opdracht en de bijbehorende id, die de volgorde aangeeft waarin ze zijn uitgevoerd.
Get-History
Voorbeeld 2: Vermeldingen ophalen die een tekenreeks bevatten
In dit voorbeeld 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 de service bevatten.
Get-History | Where-Object {$_.CommandLine -like "*Service*"}
Voorbeeld 3: geschiedenisvermeldingen exporteren tot een specifieke id
In dit voorbeeld worden de vijf meest recente geschiedenisvermeldingen ophaalt die eindigen op vermelding 7. De pijplijnoperator geeft het resultaat door aan de Export-Csv
cmdlet, waarmee de geschiedenis wordt opgemaakt als door komma's gescheiden tekst en opslaat 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 eindtijd van de opdracht.
Get-History -ID 7 -Count 5 | Export-Csv History.csv
Voorbeeld 4: de meest recente opdracht weergeven
In dit voorbeeld wordt de laatste opdracht in de opdrachtgeschiedenis opgeslagen. De laatste opdracht is de laatst ingevoerde opdracht. Deze opdracht gebruikt de parameter Aantal om slechts één opdracht weer te geven. Haalt standaard Get-History
de meest recente opdrachten op. Deze opdracht kan worden afgekort tot 'h -c 1' en komt overeen met het indrukken van de pijl-omhoog.
Get-History -Count 1
Voorbeeld 5: alle eigenschappen van de vermeldingen in de geschiedenis weergeven
In dit voorbeeld worden alle eigenschappen van vermeldingen in de sessiegeschiedenis weergegeven. De pijplijnoperator geeft de resultaten van een Get-History
opdracht door aan de Format-List
cmdlet, die alle eigenschappen van elke geschiedenisvermelding weergeeft. Dit omvat de id, status en begin- en eindtijd van de opdracht.
Get-History | Format-List -Property *
Parameters
-Count
Hiermee geeft u het aantal van de meest recente geschiedenisvermeldingen die deze cmdlet ophaalt. Standaard worden Get-History
alle vermeldingen in de sessiegeschiedenis opgeslagen. Als u zowel de parameters Aantal als Id in een opdracht gebruikt, eindigt de weergave met de opdracht die is opgegeven door de parameter Id .
In Windows PowerShell 2.0 standaard Get-History
de 32 meest recente vermeldingen.
Type: | Int32 |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Hiermee geeft u een matrix van de id's van vermeldingen in de sessiegeschiedenis. Get-History
krijgt alleen opgegeven vermeldingen. Als u zowel de parameters Id als Aantal in een opdracht gebruikt, Get-History
worden de meest recente vermeldingen opgehaald die eindigen met de vermelding die is opgegeven door de parameter Id .
Type: | Int64[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Invoerwaarden
U kunt een geschiedenis-id doorspezen naar deze cmdlet.
Uitvoerwaarden
Deze cmdlet retourneert een geschiedenisobject 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. Wanneer u elke opdracht invoert, voegt PowerShell deze toe aan de geschiedenis, zodat u deze opnieuw kunt gebruiken. Zie about_History voor meer informatie over de opdrachtgeschiedenis.
Vanaf Windows PowerShell 3.0 is de standaardwaarde van de $MaximumHistoryCount
voorkeursvariabele 4096
. In Windows PowerShell 2.0 is 64
de standaardwaarde . Zie about_Preference_Variables voor meer informatie over de$MaximumHistoryCount
variabele.