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 poleceniem Clear-History , aby usunąć wybrane polecenia.

Clear-History program 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 przewijać historię poleceń. Aby wyświetlić konfigurację PSReadLine historii poleceń, użyj polecenia Get-PSReadLineOption. PSReadLine dostarczany 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-HistoryWyś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 zawierające Pomoc lub koniec składni. Get-History Wyświetla zaktualizowaną historię poleceń i potwierdza, że usunięto polecenia o identyfikatorze 3, identyfikatorze 5, identyfikatorze 6 i identyfikatorze 7 .

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

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 usunięto identyfikator 3 i identyfikator 5 .

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

To polecenie używa parametrów Id i Count do 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 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życie symboli wieloznacznych w celu dopasowania poleceń w historii sesji programu PowerShell wyświetlanej przez Get-Historyelement . 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 wartością 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 zostaną usunięte. 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 ma wartość 30, a wartość Liczba to 10, Clear-History usuwa elementy od 21 do 30.

Parametry Count i CommandLine mogą być używane razem. Count określa liczbę poleceń do usunięcia, które pasują do 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 id w całej sesji programu PowerShell. Parametr Id może być używany z wartościami 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 licznikiem. 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 ma wartość 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 Clear-History polecenie cmdlet zostanie uruchomione. 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 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 programu 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 jest ładowana funkcja PSReadLine . To polecenie cmdlet działa tylko z historią sesji. Aby uzyskać więcej informacji, zobacz about_PSReadLine.