Clear-History
Odstraní položky z historie příkazů relace PowerShellu.
Syntax
IDParameter (Výchozí)
Clear-History
[[-Id] <int[]>]
[[-Count] <int>]
[-Newest]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CommandLineParameter
Clear-History
[[-Count] <int>]
[-CommandLine <string[]>]
[-Newest]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Clear-History odstraní historii příkazů z relace PowerShellu. Každá relace PowerShellu má vlastní historii příkazů. Pokud chcete zobrazit historii příkazů, použijte rutinu Get-History.
Ve výchozím nastavení Clear-History odstraní celou historii příkazů z relace PowerShellu. K odstranění vybraných příkazů můžete použít parametry s Clear-History.
Clear-History soubor historie příkazů PSReadLine nevymaže. Modul PSReadLine ukládá soubor historie, který obsahuje každý příkaz PowerShellu z každé relace PowerShellu. Z příkazového řádku PowerShellu můžete pomocí šipek nahoru a dolů na klávesnici procházet historii příkazů. Pro zobrazení konfigurace historie příkazů PSReadLine použijte Get-PSReadLineOption.
PSReadLine dodáván s PowerShellem 5.0 a novějším. Další informace najdete v tématu about_PSReadLine.
Příklady
Příklad 1: Odstranění historie příkazů z relace PowerShellu
Tento příkaz odstraní všechny příkazy z historie relace PowerShellu.
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
Cmdlet Get-History zobrazí historii relace PowerShellu.
Clear-History odstraní celou historii příkazů.
Get-History zobrazí aktualizovanou historii příkazů a potvrdí, že předchozí historie byla odstraněna.
Příklad 2: Odstranění nejnovějších příkazů
Tento příkaz používá parametry Count a Nejnovější k odstranění nejnovějších příkazů z historie relace v PowerShellu.
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
Cmdlet Get-History zobrazí historii relace PowerShellu.
Clear-History slouží k odstranění historie příkazů. Parametr Count určuje počet příkazů, které se mají odstranit, včetně zadaného ID. Parametr Nejnovější určuje, že nejnovější příkazy se vymažou z historie.
Get-History zobrazí aktualizovanou historii příkazů a potvrdí, že bylo odstraněno pět nejnovějších příkazů, ID 6 - ID 10.
Příklad 3: Odstranění příkazů, které odpovídají konkrétním kritériím
Tento příkaz odstraní příkazy, které odpovídají konkrétním kritériím definovaným parametrem 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
Cmdlet Get-History zobrazí historii relace PowerShellu.
Clear-History odstraní historii příkazů. Parametr příkazového řádku specifikuje příkazy, které obsahují nápovědu nebo končí syntaxí.
Get-History zobrazí aktualizovanou historii příkazů a potvrdí, že příkazy ID 3, ID 5, ID 6a ID 7 byly odstraněny.
Příklad 4: Odstranění příkazů podle čísla ID
Tento příkaz odstraní konkrétní položky historie pomocí ID. Pokud chcete odstranit více příkazů, odešlete čárkami oddělený seznam čísel ID.
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
Cmdlet Get-History zobrazí historii relace PowerShellu.
Clear-History odstraní historii příkazů. Parametr id určuje, které příkazy se mají odstranit.
Get-History zobrazí aktualizovanou historii příkazů a potvrdí, že ID 3 a ID 5 byly odstraněny.
Příklad 5: Odstranění příkazů podle čísla ID a počtu
Tento příkaz používá parametry ID a Počet k odstranění historie příkazů. Příkazy se odstraní ze zadaného id v obráceném pořadí od nejnovějšího po nejstarší.
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
Cmdlet Get-History zobrazí historii relace PowerShellu.
Clear-History odstraní historii příkazů. Parametr id určuje, že má začínat ID 7. Parametr Count určuje, že se má odstranit pět příkazů včetně zadaného id . Get-History zobrazí aktualizovanou historii příkazů a potvrdí, že bylo odstraněno pět příkazů, ID 3 - ID 7.
Parametry
-CommandLine
Odstraní historii příkazů z relace PowerShellu. Řetězec musí být přesnou shodou nebo musí použít zástupné znaky pro porovnání příkazů v historii relace PowerShell zobrazené v Get-History. Pokud zadáte více než jeden řetězec, Clear-History odstraní příkazy, které odpovídají některému z řetězců. Parametr příkazového řádku lze použít s parametrem Count.
U řetězců s mezerou použijte jednoduché uvozovky. Další informace najdete v about_Quoting_Rules.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | True |
| DontShow: | False |
Sady parametrů
CommandLineParameter
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním rutiny Clear-History vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Count
Určuje počet položek historie, které Clear-History odstraní. Příkazy se odstraní v pořadí, počínaje nejstarší položkou v historii.
Parametry Počet a ID lze použít společně. Parametr Count určuje počet příkazů, které se mají odstranit, včetně zadaného ID. Počínaje zadaným id idse příkazy odstraní v obráceném sekvenčním pořadí. Pokud je například Id 30 a Počet je 10, Clear-History odstraní položky 21 až 30.
Parametry Count a CommandLine lze použít společně. Počet určuje počet příkazů k odstranění, které odpovídají hodnotě parametru CommandLine. Příkazy se odstraní v sekvenčním pořadí.
Vlastnosti parametru
| Typ: | Int32 |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Id
Určuje historii příkazů ID, které Clear-History odstraní. K zobrazení ID čísel použijte rutinu Get-History. Čísla Id jsou sekvenční a příkazy si udržují svá čísla Id v celém sezení PowerShell. Parametr Id lze použít s Count a Newest.
Vlastnosti parametru
| Typ: | Int32[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
IDParameter
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Newest
Když se použije parametr Nejnovější, Clear-History odstraní nejnovější položky v historii. Ve výchozím nastavení Clear-History odstraní nejstarší položky v historii.
Parametr nejnovějšího lze použít s id a Count. Parametr Count určuje počet příkazů, které se mají odstranit, včetně zadaného ID. Počínaje zadaným id idse příkazy odstraní v sekvenčním pořadí. Například, pokud je Id 30 a Count je 10, Clear-History odstraní položky 30 až 39.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz cmdlet Clear-History spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
None
Do tohoto cmdletu nemůžete předávat objekty.
Výstupy
None
Tento cmdlet nevrátí žádný výstup.
Poznámky
PowerShell obsahuje následující aliasy pro Clear-History:
- Všechny platformy:
clhy
Historie relací PowerShellu je seznam příkazů zadaných během relace PowerShellu. Můžete zobrazit historii, přidat a odstranit příkazy a spouštět příkazy z historie. Další informace najdete v tématu about_History.
Historie relací se spravuje odděleně od historie spravované modulem PSReadLine. Obě historie jsou k dispozici v relacích, kde je načten modul PSReadLine. Tento cmdlet funguje jenom s historií relace. Další informace naleznete v about_PSReadLine.
