Clear-History

  • Referens
Modul:
Microsoft.PowerShell.Core

Tar bort poster från PowerShell-sessionskommandohistoriken.

Syntax

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

Description

Clear-History tar bort kommandohistoriken från en PowerShell-session. Varje PowerShell-session har sin egen kommandohistorik. Om du vill visa kommandohistoriken använder du cmdleten Get-History .

Som standard Clear-History tar bort hela kommandohistoriken från en PowerShell-session. Du kan använda parametrar med Clear-History för att ta bort valda kommandon.

Clear-History rensar PSReadLine inte kommandohistorikfilen. Modulen PSReadLine lagrar en historikfil som innehåller varje PowerShell-kommando från varje PowerShell-session. Från en PowerShell-kommandotolk använder du upp- och nedpilarna på tangentbordet för att bläddra igenom kommandohistoriken. Om du vill visa konfigurationen PSReadLine för kommandohistorik använder du Get-PSReadLineOption. PSReadLine levereras med PowerShell 5.0 och senare. Mer information finns i about_PSReadLine.

Exempel

Exempel 1: Ta bort kommandohistoriken från en PowerShell-session

Det här kommandot tar bort alla kommandon från historiken för en PowerShell-session.

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

Cmdleten Get-History visar PowerShell-sessionens historik. Clear-History tar bort hela kommandohistoriken. Get-History visar den uppdaterade kommandohistoriken och bekräftar att den tidigare historiken har tagits bort.

Exempel 2: Ta bort de senaste kommandona

Det här kommandot använder parametrarna Count och Newest för att ta bort de senaste kommandona från en PowerShell-sessionshistorik.

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

Cmdleten Get-History visar PowerShell-sessionens historik. Clear-History används för att ta bort kommandohistoriken. Parametern Count anger antalet kommandon som ska tas bort, inklusive det angivna ID:t. Parametern Newest anger att de senaste kommandona rensas från historiken. Get-History visar den uppdaterade kommandohistoriken och bekräftar att de fem senaste kommandona har tagits bort, ID 6 - ID 10.

Exempel 3: Ta bort kommandon som matchar specifika villkor

Det här kommandot tar bort kommandon som matchar specifika villkor som definieras av parametern 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

Cmdleten Get-History visar PowerShell-sessionens historik. Clear-History tar bort kommandohistoriken. Parametern CommandLine anger kommandon som innehåller Hjälp eller slutar med syntax. Get-History visar den uppdaterade kommandohistoriken och bekräftar att kommandona ID 3, ID 5, ID 6 och ID 7 har tagits bort.

Exempel 4: Ta bort kommandon efter ID-nummer

Det här kommandot tar bort specifika historikobjekt med hjälp av ID:t. Om du vill ta bort flera kommandon skickar du en kommaavgränsad lista med ID-nummer .

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

Cmdleten Get-History visar PowerShell-sessionens historik. Clear-History tar bort kommandohistoriken. Parametern Id anger vilka kommandon som ska tas bort. Get-History visar den uppdaterade kommandohistoriken och bekräftar att ID 3 och ID 5 har tagits bort.

Exempel 5: Ta bort kommandon efter ID-nummer och antal

Det här kommandot använder parametrarna ID och Count för att ta bort kommandohistoriken. Kommandon tas bort från det angivna ID :t i omvänd ordning, senaste till äldsta.

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

Cmdleten Get-History visar PowerShell-sessionens historik. Clear-History tar bort kommandohistoriken. Parametern Id anger att den ska börja med ID 7. Parametern Count anger att fem kommandon ska tas bort, inklusive det angivna ID:t. Get-History visar den uppdaterade kommandohistoriken och bekräftar att fem kommandon har tagits bort, ID 3 - ID 7.

Parametrar

-CommandLine

Tar bort kommandohistorik från en PowerShell-session. Strängen måste vara en exakt matchning eller använda jokertecken för att matcha kommandon i PowerShell-sessionshistoriken som visas av Get-History. Om du anger mer än en sträng Clear-History tar bort kommandon som matchar någon av strängarna. Parametern CommandLine kan användas med Antal.

Använd enkla citattecken för strängar med blanksteg. Mer information finns i about_Quoting_Rules.

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

-Confirm

Du uppmanas att bekräfta innan du kör cmdleten Clear-History .

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

-Count

Anger antalet historikposter som Clear-History tas bort. Kommandon tas bort i ordning, från och med den äldsta posten i historiken.

Parametrarna Antal och ID kan användas tillsammans. Parametern Count anger antalet kommandon som ska tas bort, inklusive det angivna ID:t. Från och med det angivna ID:t tas kommandon bort i omvänd sekventiell ordning. Om ID :t till exempel är 30 och Antalet är 10 tar Clear-History bort objekten 21 till och med 30.

Parametrarna Count och CommandLine kan användas tillsammans. Count anger antalet kommandon som ska tas bort som matchar parametervärdet CommandLine . Kommandona tas bort i sekventiell ordning.

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

-Id

Anger det kommandohistorik-ID som Clear-History tas bort. Om du vill visa ID-nummer använder du cmdleten Get-History . ID-numren är sekventiella och kommandona behåller sitt ID-nummer under en PowerShell-session. Parametern ID kan användas med Antal och Nyaste.

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

-Newest

När parametern Newest används Clear-History tar bort de senaste posterna i historiken. Som standard Clear-History tar bort de äldsta posterna i historiken.

Parametern Newest kan användas med ID och Antal. Parametern Count anger antalet kommandon som ska tas bort, inklusive det angivna ID:t. Från och med det angivna ID:t tas kommandon bort i sekventiell ordning. Om ID :t till exempel är 30 och Antalet är 10 tas Clear-History objekten 30 till och med 39 bort.

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

-WhatIf

Visar vad som skulle hända om cmdleten Clear-History körs. Cmdleten körs inte.

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

Indata

None

Du kan inte skicka objekt till Clear-History.

Utdata

None

Clear-History genererar inga utdata.

Kommentarer

PowerShell-sessionshistoriken är en lista över de kommandon som angavs under en PowerShell-session. Du kan visa historiken, lägga till och ta bort kommandon och köra kommandon från historiken. Mer information finns i about_History.

Sessionshistoriken hanteras separat från historiken som underhålls av PSReadLine-modulen . Båda historikerna är tillgängliga i sessioner där PSReadLine läses in. Den här cmdleten fungerar bara med sessionshistoriken. Mer information finns i about_PSReadLine.