Clear-History
Tar bort poster från PowerShell-sessionskommandohistoriken.
Syntax
IDParameter (Standard)
Clear-History
[[-Id] <int[]>]
[[-Count] <int>]
[-Newest]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CommandLineParameter
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.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
CommandLineParameter
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten Clear-History.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | jfr |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | Int32 |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 1 |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | Int32[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
IDParameter
| Position: | 0 |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-WhatIf
Visar vad som skulle hända om cmdleten Clear-History körs. Cmdleten körs inte.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Wi |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
None
Du kan inte skicka objekt till den här cmdleten.
Utdata
None
Den här cmdleten returnerar inga utdata.
Kommentarer
Windows PowerShell innehåller följande alias för Clear-History:
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 är laddad. Den här cmdleten fungerar bara med sessionshistoriken. Mer information finns i about_PSReadLine.
