Udostępnij przez


Clear-History

Usuwa wpisy z historii poleceń programu PowerShell.

Składnia

IDParameter (domyślnie)

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

CommandLineParameter

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

Opis

Clear-History usuwa historię poleceń z sesji programu PowerShell. Każda sesja programu PowerShell ma własną historię poleceń. Aby wyświetlić historię poleceń, użyj polecenia cmdlet Get-History.

Domyślnie Clear-History usuwa całą historię poleceń z sesji programu PowerShell. Aby usunąć wybrane polecenia, można użyć parametrów z Clear-History.

Clear-History nie usuwa pliku historii poleceń PSReadLine. Moduł PSReadLine przechowuje plik historii zawierający każde polecenie programu PowerShell z każdej sesji programu PowerShell. W wierszu polecenia programu PowerShell użyj strzałek w górę i w dół na klawiaturze, aby przewijać historię poleceń. Aby wyświetlić konfigurację PSReadLine historii poleceń, użyj Get-PSReadLineOption. PSReadLine zostało dostarczone z programem PowerShell 5.0 lub nowszym. Aby uzyskać więcej informacji, zobacz PSReadLine i about_PSReadLine.

Przykłady

Przykład 1. Usuwanie historii poleceń z sesji programu PowerShell

To polecenie usuwa wszystkie polecenia z historii sesji programu PowerShell.

PS> Get-History

  Id CommandLine
  -- -----------
   1 Set-Location .\Test
   2 Update-Help
   3 Set-Location C:\Test\Logs
   4 Get-Location

PS> Clear-History

PS> Get-History

  Id CommandLine
  -- -----------
   5 Clear-History

Polecenie cmdlet Get-History wyświetla historię sesji programu PowerShell. Clear-History usuwa całą historię poleceń. Get-History wyświetla zaktualizowaną historię poleceń i potwierdza, że poprzednia historia została usunięta.

Przykład 2. Usuwanie najnowszych poleceń

To polecenie używa parametrów Count i Najnowszy, aby usunąć najnowsze polecenia z historii sesji programu PowerShell.

PS> 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

PS> Clear-History -Count 5 -Newest

PS> 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

Polecenie cmdlet Get-History wyświetla historię sesji programu PowerShell. Clear-History służy do usuwania historii poleceń. Parametr Count określa liczbę poleceń do usunięcia, włącznie z określonym identyfikatorem . Parametr Najnowszy określa, że najnowsze polecenia są czyszczone z historii. Get-History wyświetla zaktualizowaną historię poleceń i potwierdza, że usunięto pięć najnowszych poleceń, Id 6 - Id 10.

Przykład 3. Usuwanie poleceń spełniających określone kryteria

To polecenie usuwa polecenia zgodne z określonymi kryteriami zdefiniowanymi przez parametr CommandLine.

PS C:\Test> 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

PS> Clear-History -CommandLine *Help*, *Syntax

PS> 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

Polecenie cmdlet Get-History wyświetla historię sesji programu PowerShell. Clear-History usuwa historię poleceń. Parametr wiersza polecenia określa polecenia, które zawierają Pomoc lub kończą się składnią . Get-History wyświetla zaktualizowaną historię poleceń i potwierdza, że usunięto polecenia Id 3, Id 5, Id 6i Id 7.

Przykład 4. Usuwanie poleceń według numeru identyfikatora

To polecenie usuwa określone elementy historii za pomocą Id . Aby usunąć wiele poleceń, prześlij listę liczb Id oddzieloną przecinkami.

PS> 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

PS C:\> Clear-History -Id 3, 5

PS> 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

Polecenie cmdlet Get-History wyświetla historię sesji programu PowerShell. Clear-History usuwa historię poleceń. Parametr Id określa polecenia do usunięcia. Get-History wyświetla zaktualizowaną historię poleceń i potwierdza, że Id 3 i Id 5 zostały usunięte.

Przykład 5. Usuwanie poleceń według numeru identyfikatora i liczby

To polecenie używa identyfikatora i parametru Count w celu usunięcia historii poleceń. Polecenia są usuwane z określonego identyfikatora w odwrotnej kolejności, od najnowszych do najstarszych.

PS> 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

PS> Clear-History -Id 7 -Count 5

PS> 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

Polecenie cmdlet Get-History wyświetla historię sesji programu PowerShell. Clear-History usuwa historię poleceń. Parametr Id określa, aby rozpocząć od Id 7. Parametr Count określa, aby usunąć pięć poleceń, łącznie z określonym identyfikatorem . Get-History wyświetla zaktualizowaną historię poleceń i potwierdza, że usunięto pięć poleceń, identyfikator 3 - id 7.

Parametry

-CommandLine

Usuwa historię poleceń z sesji programu PowerShell. Ciąg musi być dokładnym dopasowaniem lub używać symboli wieloznacznych, aby dopasować polecenia w historii poleceń sesji programu PowerShell wyświetlanej przez Get-History. Jeśli wprowadzisz więcej niż jeden ciąg, Clear-History usunie polecenia zgodne z dowolnymi ciągami. Parametr wiersza polecenia może być używany z parametrem Count.

W przypadku ciągów z spacją użyj pojedynczych cudzysłowów. Aby uzyskać więcej informacji, zobacz about_Quoting_Rules.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:True
DontShow:False

Zestawy parametrów

CommandLineParameter
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Confirm

Prosi o potwierdzenie przed uruchomieniem polecenia cmdlet Clear-History.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Count

Określa liczbę wpisów historii, które Clear-History usuwa. Polecenia są usuwane w kolejności, począwszy od najstarszego wpisu w historii.

Parametry Count i Id mogą być używane razem. Parametr Count określa liczbę poleceń do usunięcia, włącznie z określonym identyfikatorem . Począwszy od określonego identyfikatora , polecenia są usuwane w odwrotnej kolejności sekwencyjnej. Jeśli na przykład identyfikator identyfikatora wynosi 30, a liczba wynosi 10, Clear-History usuwa elementy od 21 do 30.

Parametry Count and CommandLine mogą być używane razem. liczba określa liczbę poleceń do usunięcia, które są zgodne z wartością parametru CommandLine. Polecenia są usuwane w kolejności sekwencyjnej.

Właściwości parametru

Typ:Int
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:1
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Id

Określa historię poleceń identyfikator, które Clear-History usuwa. Aby wyświetlić numery Id, użyj polecenia cmdlet Get-History. Numery Id są sekwencyjne i polecenia zachowują swój numer Id w całej sesji programu PowerShell. Parametr identyfikatora może być używany z count i najnowszych.

Właściwości parametru

Typ:

Int[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

IDParameter
Position:0
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Newest

Gdy jest używany parametr Najnowszy, Clear-History usuwa najnowsze wpisy w historii. Domyślnie Clear-History usuwa najstarsze wpisy w historii.

Parametr Najnowszy może być używany z identyfikatorem i count. Parametr Count określa liczbę poleceń do usunięcia, włącznie z określonym identyfikatorem . Począwszy od określonego identyfikatora , polecenia są usuwane w kolejności sekwencyjnej. Na przykład, jeśli identyfikator wynosi 30, a liczba to 10, Clear-History usuwa elementy od 30 do 39.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet Clear-History zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

None

Nie można potokować obiektów do Clear-History.

Dane wyjściowe

None

Clear-History nie generuje żadnych danych wyjściowych.

Uwagi

Historia sesji programu PowerShell to lista poleceń wprowadzonych podczas sesji programu PowerShell. Możesz wyświetlać historię, dodawać i usuwać polecenia oraz uruchamiać polecenia z historii. Aby uzyskać więcej informacji, zobacz about_History.