Sdílet prostřednictvím

Clear-History

  • Reference
Modul:
Microsoft.PowerShell.Core

Odstraní položky z historie příkazů relace PowerShellu.

Syntaxe

Clear-History
     [[-Id] <int[]>]
     [[-Count] <int>]
     [-Newest]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
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. Více informací naleznete v části 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 tématu about_Quoting_Rules.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:True

-Confirm

Před spuštěním rutiny Clear-History vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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í.

Typ:Int32
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Int32[]
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se příkaz cmdlet Clear-History spustí. Cmdlet se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Do tohoto cmdletu nemůžete předávat objekty.

Výstupy

None

Tato rutina 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 PSReadLine. Tento cmdlet funguje pouze s historií relace. Další informace naleznete v about_PSReadLine.