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 Get-History polecenia cmdlet .

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

Clear-History nie czyści PSReadLine pliku historii poleceń. 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 przewinąć historię poleceń. Aby wyświetlić konfigurację PSReadLine historii poleceń, użyj polecenia Get-PSReadLineOption. PSReadLine dostarczane z programem PowerShell 5.0 lub nowszym. Aby uzyskać więcej informacji, zobacz 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 Get-History cmdlet 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 Liczba i Najnowsze , 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 Get-History cmdlet 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. Najnowszy parametr określa, że najnowsze polecenia są czyszczone z historii. Get-History wyświetla zaktualizowaną historię poleceń i potwierdza, że usunięto pięć najnowszych poleceń o identyfikatorze 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 Get-History cmdlet wyświetla historię sesji programu PowerShell. Clear-History usuwa historię poleceń. Parametr CommandLine określa polecenia, które zawierają Pomoc lub koniec składni. Get-History Wyświetla zaktualizowaną historię poleceń i potwierdza, że polecenia o identyfikatorze 3, identyfikatorze 5, identyfikatorze 6 i identyfikatorze 7 zostały usunięte.

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

To polecenie usuwa określone elementy historii przy użyciu identyfikatora. Aby usunąć wiele poleceń, prześlij rozdzielaną przecinkami listę numerów identyfikatorów .

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 Get-History cmdlet 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 identyfikator 3 i identyfikator 5 zostały usunięte.

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

To polecenie używa parametrów Identyfikator i Liczba do usuwania historii poleceń. Polecenia są usuwane z określonego identyfikatora w odwrotnej kolejności, od najnowszej do najstarszej.

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 Get-History cmdlet wyświetla historię sesji programu PowerShell. Clear-History usuwa historię poleceń. Parametr Id określa, aby rozpocząć od identyfikatora 7. Parametr Count określa, aby usunąć pięć poleceń, włącznie z określonym identyfikatorem. Get-History wyświetla zaktualizowaną historię poleceń i potwierdza, że usunięto pięć poleceń o identyfikatorze 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 sesji programu PowerShell wyświetlanej przez Get-Historyprogram . Jeśli wprowadzisz więcej niż jeden ciąg, Clear-History usuwa polecenia zgodne z dowolnymi ciągami. Parametr CommandLine może być używany z funkcją Count.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Confirm

Monituje o potwierdzenie przed uruchomieniem Clear-History polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Count

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

Parametry Count i Id można używać 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 to 30, a wartość Liczba to 10, Clear-History usuwa elementy od 21 do 30.

Parametry Count i CommandLine można używać 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.

Type:Int32
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:Int32[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Newest

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

Najnowszy parametr może być używany z identyfikatorem i liczbą. 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. Jeśli na przykład identyfikator to 30, a wartość Liczba to 10, Clear-History usuwa elementy od 30 do 39.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

None

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

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.

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