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 verwijdert de opdrachtgeschiedenis uit een PowerShell-sessie. Elke PowerShell-sessie heeft een eigen opdrachtgeschiedenis. Gebruik de Get-History cmdlet om de 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 dat elke PowerShell-opdracht uit elke PowerShell-sessie bevat. 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 de 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 uit een PowerShell-sessie verwijderen

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

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 uit de geschiedenis van een PowerShell-sessie te verwijderen.

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 worden gewist uit de geschiedenis. Get-Historygeeft 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 worden opdrachten opgegeven 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 worden specifieke geschiedenisitems verwijderd 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, van nieuw naar oud.

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 id-parameter geeft aan te beginnen met id 7. De parameter Count geeft aan om 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 te vinden in de PowerShell-sessiegeschiedenis die wordt weergegeven 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
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Confirm

U wordt gevraagd om bevestiging voordat u de Clear-History cmdlet uitvoert.

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

-Count

Hiermee geeft u het aantal geschiedenisvermeldingen op dat Clear-History wordt verwijderd. Opdrachten worden op volgorde verwijderd, beginnend 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:Int32[]
Position:0
Default value:None
Required:False
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. Clear-History Standaard worden de oudste vermeldingen in de geschiedenis verwijderd.

De parameter Nieuwste 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Toont 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

Windows PowerShell bevat de volgende aliassen voor Clear-History:

  • clhy

De geschiedenis van de PowerShell-sessie is een lijst met de opdrachten die zijn ingevoerd tijdens een PowerShell-sessie. 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.