Clear-History

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

Syntax

IDParameter (Standaard)

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

CommandLineParameter

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_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 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-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 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 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_Rulesvoor meer informatie.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

CommandLineParameter
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

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

Parametereigenschappen

Type:

Int32[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

IDParameter
Position:0
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

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

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
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

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_History voor meer informatie.

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_PSReadLine voor meer informatie.