Freigeben über


Clear-History

Löscht Einträge aus dem PowerShell-Befehlsverlauf.

Syntax

IDParameter (Standard)

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

CommandLineParameter

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

Beschreibung

Clear-History löscht den Befehlsverlauf aus einer PowerShell-Sitzung. Jede PowerShell-Sitzung verfügt über einen eigenen Befehlsverlauf. Verwenden Sie das Cmdlet Get-History, um den Befehlsverlauf anzuzeigen.

Standardmäßig löscht Clear-History den gesamten Befehlsverlauf aus einer PowerShell-Sitzung. Sie können Parameter mit Clear-History verwenden, um ausgewählte Befehle zu löschen.

Clear-History löscht die PSReadLine Befehlsverlaufsdatei nicht. Das modul PSReadLine speichert eine Verlaufsdatei, die jeden PowerShell-Befehl aus jeder PowerShell-Sitzung enthält. Verwenden Sie an einer PowerShell-Eingabeaufforderung die Pfeile nach oben und unten auf der Tastatur, um durch den Befehlsverlauf zu scrollen. Verwenden Sie PSReadLine, um die Get-PSReadLineOption Konfiguration für den Befehlsverlauf anzuzeigen. PSReadLine mit PowerShell 5.0 und höher ausgeliefert. Weitere Informationen finden Sie unter PSReadLine und about_PSReadLine.

Beispiele

Beispiel 1: Löschen des Befehlsverlaufs aus einer PowerShell-Sitzung

Mit diesem Befehl werden alle Befehle aus dem Verlauf einer PowerShell-Sitzung gelöscht.

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

Das Cmdlet Get-History zeigt den Verlauf der PowerShell-Sitzung an. Clear-History löscht den gesamten Befehlsverlauf. Get-History zeigt den aktualisierten Befehlsverlauf an und bestätigt, dass der vorherige Verlauf gelöscht wurde.

Beispiel 2: Löschen der neuesten Befehle

Dieser Befehl verwendet die parameter "Count" und "Neueste", um die neuesten Befehle aus dem Verlauf einer PowerShell-Sitzung zu löschen.

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

Das Cmdlet Get-History zeigt den Verlauf der PowerShell-Sitzung an. Clear-History wird verwendet, um den Befehlsverlauf zu löschen. Der parameter Count gibt die Anzahl der zu löschenden Befehle einschließlich der angegebenen IDan. Der parameter Newest gibt an, dass die neuesten Befehle aus dem Verlauf gelöscht werden. Get-History zeigt den aktualisierten Befehlsverlauf an und bestätigt, dass die fünf neuesten Befehle gelöscht wurden, ID 6 - ID 10.

Beispiel 3: Löschen von Befehlen, die bestimmten Kriterien entsprechen

Mit diesem Befehl werden Befehle gelöscht, die bestimmten Kriterien entsprechen, die vom CommandLine--Parameter definiert sind.

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

Das Cmdlet Get-History zeigt den Verlauf der PowerShell-Sitzung an. Clear-History löscht den Befehlsverlauf. Der Parameter CommandLine gibt Befehle an, die Hilfe enthalten oder mit Syntaxenden. Get-History zeigt den aktualisierten Befehlsverlauf an und bestätigt, dass Befehle ID 3, ID 5, ID 6und ID 7 gelöscht wurden.

Beispiel 4: Löschen von Befehlen nach ID-Nummer

Dieser Befehl löscht bestimmte Verlaufselemente anhand der ID. Um mehrere Befehle zu löschen, senden Sie eine durch Kommas getrennte Liste mit ID-Nummern.

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

Das Cmdlet Get-History zeigt den Verlauf der PowerShell-Sitzung an. Clear-History löscht den Befehlsverlauf. Der parameter ID gibt an, welche Befehle gelöscht werden sollen. Get-History zeigt den aktualisierten Befehlsverlauf an und bestätigt, dass ID 3 und ID 5 gelöscht wurden.

Beispiel 5: Löschen von Befehlen nach ID-Nummer und Anzahl

Dieser Befehl verwendet die Id und Count Parameter zum Löschen des Befehlsverlaufs. Befehle werden in umgekehrter Reihenfolge, von den neuesten zu den ältesten, aus der angegebenen -ID gelöscht.

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

Das Cmdlet Get-History zeigt den Verlauf der PowerShell-Sitzung an. Clear-History löscht den Befehlsverlauf. Der parameter ID gibt an, mit ID 7zu beginnen. Der parameter Count gibt an, fünf Befehle zu löschen, einschließlich der angegebenen ID-. Get-History zeigt den aktualisierten Befehlsverlauf an und bestätigt, dass fünf Befehle gelöscht wurden, ID 3 - ID 7.

Parameter

-CommandLine

Löscht den Befehlsverlauf aus einer PowerShell-Sitzung. Die Zeichenfolge muss exakt übereinstimmen oder Sie verwenden Platzhalter, um Befehle im PowerShell-Sitzungsverlauf abzugleichen, der angezeigt wird von Get-History. Wenn Sie mehrere Zeichenfolgen eingeben, werden Clear-History Befehle gelöscht, die mit einer der Zeichenfolgen übereinstimmen. Der CommandLine-Parameter kann mit Count verwendet werden.

Verwenden Sie für Zeichenfolgen mit einem Leerzeichen einfache Anführungszeichen. Weitere Informationen finden Sie unter über_Zitierregeln.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

CommandLineParameter
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet Clear-History ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Count

Gibt die Anzahl der Verlaufseinträge an, die von gelöscht Clear-History werden. Befehle werden in der Reihenfolge gelöscht, beginnend mit dem ältesten Eintrag in der Historie.

Die Parameter Count und ID können zusammen verwendet werden. Der parameter Count gibt die Anzahl der zu löschenden Befehle einschließlich der angegebenen IDan. Beginnend mit der angegebenen IDwerden Befehle in umgekehrter sequenzieller Reihenfolge gelöscht. Wenn z. B. die -ID 30 ist und die Count 10 ist, Clear-History Elemente 21 bis 30 löscht.

Die parameter Count und CommandLine können zusammen verwendet werden. Count gibt die Anzahl der zu löschenden Befehle an, die CommandLine Parameterwert entsprechen. Die Befehle werden in sequenzieller Reihenfolge gelöscht.

Parametereigenschaften

Typ:Int
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

Gibt die Befehlsverlaufs-ID an, die Clear-History löscht. Um ID- Zahlen anzuzeigen, verwenden Sie das Cmdlet Get-History. Die -ID Nummern sind sequenziell und Befehle behalten ihre ID Nummer während einer PowerShell-Sitzung bei. Der Parameter Id kann mit Count und Newest verwendet werden.

Parametereigenschaften

Typ:

Int[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

IDParameter
Position:0
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Newest

Wenn der parameter Newest verwendet wird, löscht Clear-History die neuesten Einträge im Verlauf. Standardmäßig löscht Clear-History die ältesten Einträge in der Historie.

Der Parameter Newest kann mit Id und Count verwendet werden. Der parameter Count gibt die Anzahl der zu löschenden Befehle einschließlich der angegebenen IDan. Beginnend mit der angegebenen IDwerden Befehle in sequenzieller Reihenfolge gelöscht. Wenn z. B. die -ID 30 ist und die Count 10 ist, löscht Clear-History Elemente 30 bis 39.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das cmdlet Clear-History ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Objekte können nicht an Clear-Historyweitergeleitet werden.

Ausgaben

None

Clear-History generiert keine Ausgabe.

Hinweise

Der PowerShell-Sitzungsverlauf ist eine Liste der Befehle, die während einer PowerShell-Sitzung eingegeben wurden. Sie können den Verlauf anzeigen, Befehle hinzufügen und löschen und Befehle aus dem Verlauf ausführen. Weitere Informationen finden Sie unter about_History.