Feedback

Clear-History

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee verwijdert u vermeldingen uit de opdrachtgeschiedenis van de PowerShell-sessie.

Syntax

Clear-History
     [[-Id] <int[]>]
     [[-Count] <int>]
     [-Newest]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-History
     [[-Count] <int>]
     [-CommandLine <string[]>]
     [-Newest]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Clear-History hiermee verwijdert u de opdrachtgeschiedenis uit een PowerShell-sessie. Elke PowerShell-sessie heeft een eigen opdrachtgeschiedenis. Gebruik de cmdlet om de Get-History opdrachtgeschiedenis weer te geven.

Hiermee verwijdert u standaard Clear-History de volledige opdrachtgeschiedenis uit een PowerShell-sessie. U kunt parameters gebruiken om Clear-History geselecteerde opdrachten te verwijderen.

Clear-History wist het PSReadLine opdrachtgeschiedenisbestand niet. In de PSReadLine module wordt een geschiedenisbestand opgeslagen met elke PowerShell-opdracht uit elke PowerShell-sessie. Gebruik vanuit een PowerShell-prompt de pijl-omhoog en pijl-omlaag op het toetsenbord om door de opdrachtgeschiedenis te bladeren. Als u de PSReadLine configuratie voor opdrachtgeschiedenis wilt weergeven, gebruikt u Get-PSReadLineOption. PSReadLine geleverd met PowerShell 5.0 en hoger. Zie about_PSReadLine voor meer informatie.

Voorbeelden

Voorbeeld 1: De opdrachtgeschiedenis verwijderen uit een PowerShell-sessie

Met deze opdracht worden alle opdrachten verwijderd uit de geschiedenis van een PowerShell-sessie.

Get-History

Id CommandLine
  -- -----------
   1 Set-Location .\Test
   2 Update-Help
   3 Set-Location C:\Test\Logs
   4 Get-Location

Clear-History
Get-History

Id CommandLine
  -- -----------
   5 Clear-History

De Get-History cmdlet geeft de geschiedenis van de PowerShell-sessie weer. Clear-History verwijdert de volledige opdrachtgeschiedenis. Get-History geeft de bijgewerkte opdrachtgeschiedenis weer en bevestigt dat de vorige geschiedenis is verwijderd.

Voorbeeld 2: De nieuwste opdrachten verwijderen

Met deze opdracht worden de parameters Aantal en Nieuwste gebruikt om de nieuwste opdrachten te verwijderen uit de geschiedenis van een PowerShell-sessie.

Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   3 Get-Command Clear-History -Syntax
   4 Get-Command Clear-History -ShowCommandInfo
   5 Get-Help Get-Alias
   6 Get-Command Get-ChildItem -Syntax
   7 Get-Help Clear-History
   8 Set-Location C:\Test\Logs
   9 Get-Help Get-Variable
  10 Get-Help Get-ChildItem

Clear-History -Count 5 -Newest
Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   3 Get-Command Clear-History -Syntax
   4 Get-Command Clear-History -ShowCommandInfo
   5 Get-Help Get-Alias
  11 Clear-History -Count 5 -Newest

De Get-History cmdlet geeft de geschiedenis van de PowerShell-sessie weer. Clear-History wordt gebruikt om de opdrachtgeschiedenis te verwijderen. De parameter Aantal geeft het aantal opdrachten op dat moet worden verwijderd, inclusief de opgegeven id. De parameter Nieuwste geeft aan dat de nieuwste opdrachten uit de geschiedenis worden gewist. Get-History geeft de bijgewerkte opdrachtgeschiedenis weer en bevestigt dat de vijf nieuwste opdrachten zijn verwijderd, id 6 - id 10.

Voorbeeld 3: Opdrachten verwijderen die voldoen aan specifieke criteria

Met deze opdracht worden opdrachten verwijderd die voldoen aan specifieke criteria die zijn gedefinieerd door de parameter CommandLine .

Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   3 Get-Command Clear-History -Syntax
   4 Get-Command Clear-History -ShowCommandInfo
   5 Get-Help Get-Alias
   6 Get-Command Get-ChildItem -Syntax
   7 Get-Help Clear-History

Clear-History -CommandLine *Help*, *Syntax
Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   4 Get-Command Clear-History -ShowCommandInfo
   8 Clear-History -CommandLine *Help*, *Syntax

De Get-History cmdlet geeft de geschiedenis van de PowerShell-sessie weer. Clear-History verwijdert de opdrachtgeschiedenis. Met de parameter CommandLine geeft u opdrachten op die Help bevatten of eindigen met syntaxis. Get-History geeft de bijgewerkte opdrachtgeschiedenis weer en bevestigt dat opdrachten id 3, id 5, id 6 en id 7 zijn verwijderd.

Voorbeeld 4: Opdrachten verwijderen op id-nummer

Met deze opdracht verwijdert u specifieke geschiedenisitems met behulp van de id. Als u meerdere opdrachten wilt verwijderen, dient u een door komma's gescheiden lijst met id-nummers in.

Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-History
   3 Get-Help Get-Alias
   4 Get-Command Clear-History
   5 Get-Command Clear-History -Syntax
   6 Get-Command Clear-History -ShowCommandInfo

Clear-History -Id 3, 5
Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-History
   4 Get-Command Clear-History
   6 Get-Command Clear-History -ShowCommandInfo
   7 Get-History
   8 Clear-History -Id 3, 5

De Get-History cmdlet geeft de geschiedenis van de PowerShell-sessie weer. Clear-History verwijdert de opdrachtgeschiedenis. De id-parameter geeft aan welke opdrachten moeten worden verwijderd. Get-History geeft de bijgewerkte opdrachtgeschiedenis weer en bevestigt dat id 3 en id 5 zijn verwijderd.

Voorbeeld 5: Opdrachten verwijderen op id-nummer en aantal

Met deze opdracht worden de parameters Id en Count gebruikt om de opdrachtgeschiedenis te verwijderen. Opdrachten worden verwijderd uit de opgegeven id in omgekeerde volgorde, nieuwste naar oudste.

Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   3 Get-Command Clear-History -Syntax
   4 Get-Command Clear-History -ShowCommandInfo
   5 Get-Help Get-Alias
   6 Get-Command Get-ChildItem -Syntax
   7 Get-Help Clear-History
   8 Set-Location C:\Test\Logs
   9 Get-Help Get-Variable
  10 Get-Help Get-ChildItem

Clear-History -Id 7 -Count 5
Get-History

Id CommandLine
  -- -----------
   1 Set-Location C:\Test\
   2 Get-Command Clear-History
   8 Set-Location C:\Test\Logs
   9 Get-Help Get-Variable
  10 Get-Help Get-ChildItem
  11 Clear-History -Id 7 -Count 5

De Get-History cmdlet geeft de geschiedenis van de PowerShell-sessie weer. Clear-History verwijdert de opdrachtgeschiedenis. De parameter Id geeft aan te beginnen met id 7. De parameter Aantal geeft aan vijf opdrachten te verwijderen, inclusief de opgegeven id. Get-History geeft de bijgewerkte opdrachtgeschiedenis weer en bevestigt dat vijf opdrachten zijn verwijderd, id 3 - Id 7.

Parameters

-CommandLine

Hiermee verwijdert u de opdrachtgeschiedenis uit een PowerShell-sessie. De tekenreeks moet een exacte overeenkomst zijn of jokertekens gebruiken om opdrachten in de PowerShell-sessiegeschiedenis weer te geven door Get-History. Als u meer dan één tekenreeks invoert, Clear-History verwijdert u opdrachten die overeenkomen met een van de tekenreeksen. De parameter CommandLine kan worden gebruikt met Count.

Gebruik voor tekenreeksen met een spatie enkele aanhalingstekens. Zie about_Quoting_Rules voor meer informatie.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True
-Confirm

Vraagt u om bevestiging voordat u de Clear-History cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Count

Hiermee geeft u het aantal geschiedenisvermeldingen op dat Clear-History wordt verwijderd. Opdrachten worden in volgorde verwijderd, te beginnen met de oudste vermelding in de geschiedenis.

De parameters Aantal en Id kunnen samen worden gebruikt. De parameter Aantal geeft het aantal opdrachten op dat moet worden verwijderd, inclusief de opgegeven id. Vanaf de opgegeven id worden opdrachten verwijderd in omgekeerde volgorde. Als de id bijvoorbeeld 30 is en het aantal 10 is, Clear-History verwijdert u items 21 tot en met 30.

De parameters Count en CommandLine kunnen samen worden gebruikt. Aantal geeft het aantal opdrachten op dat moet worden verwijderd die overeenkomen met de parameterwaarde CommandLine . De opdrachten worden in opeenvolgende volgorde verwijderd.

Type:Int32
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Id

Hiermee geeft u de opdrachtgeschiedenis-id die Clear-History wordt verwijderd. Gebruik de Get-History cmdlet om id-nummers weer te geven. De id-nummers zijn opeenvolgend en opdrachten behouden hun id-nummer gedurende een PowerShell-sessie. De id-parameter kan worden gebruikt met Aantal en Nieuwste.

Type:Int32[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Newest

Wanneer de parameter Nieuwste wordt gebruikt, Clear-History verwijdert u de nieuwste vermeldingen in de geschiedenis. Hiermee verwijdert u standaard Clear-History de oudste vermeldingen in de geschiedenis.

De nieuwste parameter kan worden gebruikt met id en aantal. De parameter Aantal geeft het aantal opdrachten op dat moet worden verwijderd, inclusief de opgegeven id. Vanaf de opgegeven id worden opdrachten in opeenvolgende volgorde verwijderd. Als de id bijvoorbeeld 30 is en het aantal 10 is, Clear-History verwijdert u items 30 tot en met 39.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Laat zien wat er zou gebeuren als de Clear-History cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

None

U kunt objecten niet doorsluisen naar Clear-History.

Uitvoerwaarden

None

Clear-History genereert geen uitvoer.

Notities

De PowerShell-sessiegeschiedenis is een lijst met de opdrachten die tijdens een PowerShell-sessie zijn ingevoerd. U kunt de geschiedenis bekijken, opdrachten toevoegen en verwijderen en opdrachten uitvoeren vanuit de geschiedenis. Zie about_History voor meer informatie.

De sessiegeschiedenis wordt afzonderlijk beheerd van de geschiedenis die wordt onderhouden door de PSReadLine-module . Beide geschiedenissen zijn beschikbaar in sessies waarin PSReadLine wordt geladen. Deze cmdlet werkt alleen met de sessiegeschiedenis. Zie about_PSReadLine voor meer informatie.