Dela via

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 en egen kommandohistorik. Om du vill visa kommandohistoriken använder du cmdleten Get-History.

Som standard tar Clear-History 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 inte kommandohistorikfilen för PSReadLine. Modulen PSReadLine lagrar en historikfil som innehåller alla PowerShell-kommandon från varje PowerShell-session. Från en PowerShell-prompt använder du upp- och nedpilarna på tangentbordet för att bläddra igenom kommandohistoriken. Om du vill visa PSReadLine konfiguration 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 en PowerShell-sessionshistorik.

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 Senaste 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 kriterier som definierats 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 6och ID 7 har tagits bort.

Exempel 4: Ta bort kommandon via 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 över ID tal.

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 den angivna ID 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 kommandohistoriken från en PowerShell-session. Strängen måste vara en exakt matchning, eller så måste jokertecken användas för att matcha kommandon i PowerShell-sessionshistoriken som visas av Get-History. Om du anger mer än en sträng tar Clear-History bort kommandon som matchar någon av strängarna. Parametern CommandLine kan användas med Count.

För strängar med ett blanksteg använder du enkla citattecken. Mer information finns i about_Quoting_Rules.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten Clear-History.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Count

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

Parametrarna Count och ID kan användas tillsammans. Parametern Count anger antalet kommandon som ska tas bort, inklusive det angivna -ID:t. Från och med den angivna IDtas kommandon bort i omvänd sekventiell ordning. Om -ID:t till exempel är 30 och Antal ä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 CommandLine- parametervärde. Kommandona tas bort i sekventiell ordning.

Typ:Int32
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Id

Anger kommandohistoriken ID som Clear-History tar bort. Om du vill visa ID tal använder du cmdleten Get-History. -ID:t tal är sekventiella och kommandona behåller sitt -ID tal under en PowerShell-session. Parametern ID kan användas med Count och Newest.

Typ:Int32[]
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Newest

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

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

PowerShell innehåller följande alias för Clear-History:

  • Alla plattformar:
    • clhy

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