Get-History
Hiermee haalt u een lijst op met de opdrachten die tijdens de huidige sessie zijn ingevoerd.
Syntax
Default (Standaard)
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. 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 tijdens sessies waarin PSReadLine geladen is. Deze cmdlet werkt alleen met de sessiegeschiedenis. Zie about_PSReadLinevoor meer informatie.
Voorbeelden
Voorbeeld 1: De sessiegeschiedenis ophalen
In dit voorbeeld 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.
Get-History
Voorbeeld 2: Vermeldingen ophalen die een tekenreeks bevatten
In dit voorbeeld worden vermeldingen opgeslagen in de opdrachtgeschiedenis met de tekenreeksservice. 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.
Get-History | Where-Object {$_.CommandLine -like "*Service*"}
Voorbeeld 3: Geschiedenisvermeldingen exporteren tot een specifieke id
In dit voorbeeld worden de vijf meest recente geschiedenisvermeldingen weergegeven die eindigen op item 7. De pijplijnoperator geeft het resultaat door aan de Export-Csv cmdlet, 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.
Get-History -Id 7 -Count 5 | Export-Csv -Path History.csv
Voorbeeld 4: De meest recente opdracht weergeven
In dit voorbeeld 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. Haalt standaard Get-History de meest recente opdrachten op. Deze opdracht kan worden afgekort tot 'h -c 1' en is gelijk aan het drukken op de toets 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, waarin alle eigenschappen van elke geschiedenisvermelding worden weergegeven. Dit omvat de id, status en begin- en eindtijd van de opdracht.
Get-History | Format-List -Property *
Parameters
-Count
Hiermee geeft u het nummer op van de meest recente geschiedenisvermeldingen die door deze cmdlet worden ophaalt.
Get-History Standaard worden 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 krijgt Get-History standaard de 32 meest recente vermeldingen.
Parametereigenschappen
| Type: | Int32 |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 1 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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 Count in een opdracht gebruikt, Get-History worden de meest recente vermeldingen weergegeven die eindigen op de vermelding die is opgegeven door de parameter Id .
Parametereigenschappen
| Type: | Int64[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | False |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
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
PowerShell bevat de volgende aliassen voor Get-History:
- Alle platforms:
hhistoryghy
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_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 de standaardwaarde 64. Zie $MaximumHistoryCountvoor meer informatie over de variabele .