Freigeben über

Clear-History

  • Referenz
Modul:
Microsoft.PowerShell.Core

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

Syntax

Clear-History
     [[-Id] <int[]>]
     [[-Count] <int>]
     [-Newest]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
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 Get-PSReadLineOption, um die PSReadLine Konfiguration für den Befehlsverlauf anzuzeigen. PSReadLine mit PowerShell 5.0 und höher ausgeliefert. Weitere Informationen finden Sie unter 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.

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

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.

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

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.

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

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

Mit diesem Befehl werden bestimmte Verlaufselemente mithilfe der -ID-gelöscht. Um mehrere Befehle zu löschen, senden Sie eine durch Trennzeichen getrennte Liste ID Nummern.

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

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 aus der angegebenen -ID in umgekehrter Reihenfolge, neueste bis älteste, gelöscht.

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

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 eine genaue Übereinstimmung sein oder Platzhalter verwenden, um Befehle im PowerShell-Sitzungsverlauf abzugleichen, der von Get-Historyangezeigt wird. Wenn Sie mehrere Zeichenfolgen eingeben, werden Clear-History Befehle gelöscht, die mit einer der Zeichenfolgen übereinstimmen. Der parameter CommandLine kann mit Countverwendet werden.

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

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Count

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

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.

Typ:Int32
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Gibt den Befehlsverlauf 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 Newestverwendet werden.

Typ:Int32[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 im Verlauf.

Der parameter Newest kann mit Id und Countverwendet 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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Clear-History:

  • Alle Plattformen:
    • clhy

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.

Der Sitzungsverlauf wird getrennt vom Verlauf verwaltet, der vom PSReadLine Modul verwaltet wird. Beide Historien sind in Sitzungen verfügbar, in denen PSReadLine- geladen wird. Dieses Cmdlet funktioniert nur mit dem Sitzungsverlauf. Weitere Informationen finden Sie about_PSReadLine.