Udostępnij za pośrednictwem

Clear-History

  • Odwołanie
Moduł:
Microsoft.PowerShell.Core

Usuwa wpisy z historii poleceń sesji programu PowerShell.

Składnia

Clear-History
     [[-Id] <int[]>]
     [[-Count] <int>]
     [-Newest]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
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, zapoznaj się z about_PSReadLine.

Przykłady

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

To polecenie usuwa wszystkie polecenia z historii sesji programu PowerShell.

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

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.

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

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.

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

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.

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

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.

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

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.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-Confirm

Prosi o potwierdzenie przed uruchomieniem polecenia cmdlet Clear-History.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Int32
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Int32[]
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet Clear-History zostanie uruchomione. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

Program PowerShell zawiera następujące aliasy dla Clear-History:

  • Wszystkie platformy:
    • clhy

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.

Historia sesji jest zarządzana niezależnie od historii obsługiwanej przez moduł PSReadLine. Obie historie są dostępne w sesjach, w których PSReadLine. Polecenie cmdlet działa tylko z historią sesji. Aby uzyskać więcej informacji, zobacz about_PSReadLine.