Delen via

Clear-History

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee verwijdert u vermeldingen uit de PowerShell-opdrachtgeschiedenis.

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 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 Clear-History met gebruiken om geselecteerde opdrachten te verwijderen.

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

Voorbeelden

Voorbeeld 1: De opdrachtgeschiedenis verwijderen uit een PowerShell-sessie

Met deze opdracht verwijdert u alle opdrachten uit de geschiedenis van een PowerShell-sessie.

PS> Get-History

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

PS> Clear-History

PS> 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

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

PS> 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

PS> Clear-History -Count 5 -Newest

PS> 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 Count 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 verwijdert u opdrachten die voldoen aan specifieke criteria die zijn gedefinieerd door de parameter CommandLine .

PS C:\Test> 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

PS> Clear-History -CommandLine *Help*, *Syntax

PS> 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 hiermee verwijdert u 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 de 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.

PS> 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

PS C:\> Clear-History -Id 3, 5

PS> 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 hiermee verwijdert u de opdrachtgeschiedenis. De parameter Id 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 Aantal gebruikt om de opdrachtgeschiedenis te verwijderen. Opdrachten worden verwijderd uit de opgegeven id in omgekeerde volgorde, van nieuw naar oud.

PS> 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

PS> Clear-History -Id 7 -Count 5

PS> 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 hiermee verwijdert u de opdrachtgeschiedenis. De parameter Id geeft aan dat moet beginnen met id 7. Met de parameter Count wordt opgegeven dat vijf opdrachten moeten worden verwijderd, 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 exact overeenkomen 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 enkele aanhalingstekens voor tekenreeksen met een spatie. 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 om bevestiging gevraagd 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, te beginnen met de oudste vermelding in de geschiedenis.

De parameters Count en Id kunnen samen worden gebruikt. De parameter Count geeft het aantal opdrachten op dat moet worden verwijderd, inclusief de opgegeven id. Vanaf de opgegeven id worden opdrachten in omgekeerde volgorde verwijderd. Als de id bijvoorbeeld 30 is en het aantal 10, 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 sequentieel volgorde verwijderd.

Type:Int
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 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 parameter Id kan worden gebruikt met Count en Newest.

Type:Int[]
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. De oudste vermeldingen in de geschiedenis worden standaard Clear-History verwijderd.

De parameter Nieuwste kan worden gebruikt met id en aantal. De parameter Count geeft het aantal opdrachten op dat moet worden verwijderd, inclusief de opgegeven id. Vanaf de opgegeven id worden opdrachten in sequentiële volgorde verwijderd. Als de id bijvoorbeeld 30 is en het aantal 10, 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

Hier ziet u wat er gebeurt 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 doorsnijden 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.