Delen via

Clear-History

  • Referentie
Module:
Microsoft.PowerShell.Core

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

Syntaxis

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 Get-History om de opdrachtgeschiedenis weer te geven.

Standaard verwijdert Clear-History de volledige opdrachtgeschiedenis uit een PowerShell-sessie. U kunt parameters gebruiken met Clear-History om 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_PSReadLinevoor 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 Count 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 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 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. De parameter CommandLine geeft 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 6en -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 getallen 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 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

Deze opdracht maakt gebruik van de parameters Id en Count 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 parameter -id geeft aan te beginnen met id 7. De parameter Count 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 voor overeenkomsten met opdrachten in de geschiedenis van de PowerShell-sessie die wordt weergegeven door Get-History. Als u meer dan één tekenreeks invoert, verwijdert Clear-History 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_Rulesvoor meer informatie.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:True

-Confirm

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

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Count

Hiermee geeft u het aantal geschiedenisvermeldingen op dat Clear-History verwijdert. Opdrachten worden op volgorde verwijderd, beginnend 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 idworden opdrachten verwijderd in omgekeerde volgorde. Als de -id bijvoorbeeld 30 is en de Count 10 is, verwijdert Clear-History de elementen 21 tot en met 30.

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

Type:Int32
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

Hiermee specificeert u de opdrachtgeschiedenis Id die Clear-History wordt verwijderd. Als u id getallen wilt weergeven, gebruikt u de cmdlet Get-History. De id- getallen zijn opeenvolgend en opdrachten behouden hun id nummer gedurende een PowerShell-sessie. De parameter Id kan worden gebruikt met Count en Nieuwste.

Type:Int32[]
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Newest

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

De parameter Nieuwste kan samen met Id en Countworden gebruikt. De parameter Count geeft het aantal opdrachten op dat moet worden verwijderd, inclusief de opgegeven -id. Vanaf de opgegeven idworden opdrachten in volgorde verwijderd. Als de -id bijvoorbeeld 30 is en het aantal 10 is, verwijdert Clear-History items 30 tot en met 39.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

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

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

PowerShell bevat de volgende aliassen voor Clear-History:

  • Alle platforms:
    • 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_Historyvoor 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_PSReadLinevoor meer informatie.