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 Get-History Cmdlet, um den Befehlsverlauf anzuzeigen.

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

Clear-History die Befehlsverlaufsdatei wird nicht gelöscht PSReadLine . Das PSReadLine Modul 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. Um die Konfiguration für den PSReadLine Befehlsverlauf anzuzeigen, verwenden Sie Get-PSReadLineOption. PSReadLine ausgeliefert mit PowerShell 5.0 und höher. 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 Get-History Cmdlet 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 "Anzahl" und "Neuste ", 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 Get-History Cmdlet 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 an, einschließlich der angegebenen ID. Der neueste Parameter gibt an, dass die neuesten Befehle aus dem Verlauf gelöscht werden. Get-Historyzeigt 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

Dieser Befehl löscht Befehle, 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 Get-History Cmdlet zeigt den Verlauf der PowerShell-Sitzung an. Clear-History löscht den Befehlsverlauf. Der CommandLine-Parameter gibt Befehle an, die Hilfe oder Ende mit Syntax enthalten. Get-History zeigt den aktualisierten Befehlsverlauf an und bestätigt, dass Befehle ID 3, ID 5, ID 6 und 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 der 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 Get-History Cmdlet zeigt den Verlauf der PowerShell-Sitzung an. Clear-History löscht den Befehlsverlauf. Der Id-Parameter 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 Parameter "ID" und "Count ", um den Befehlsverlauf zu löschen. 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 Get-History Cmdlet zeigt den Verlauf der PowerShell-Sitzung an. Clear-History löscht den Befehlsverlauf. Der Id-Parameter gibt an, dass er mit id 7 beginnt. Der Parameter Count gibt an, fünf Befehle einschließlich der angegebenen ID zu löschen. 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 Karte, um Befehle im PowerShell-Sitzungsverlauf abzugleichen, der von Get-History. Wenn Sie mehrere Zeichenfolgen eingeben, werden Befehle gelöscht, Clear-History 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 about_Quoting_Rules.

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

-Confirm

Fordert Sie vor dem Ausführen des Clear-History Cmdlets zur Bestätigung auf.

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 "Anzahl" und "ID " können zusammen verwendet werden. Der Parameter Count gibt die Anzahl der zu löschenden Befehle an, einschließlich der angegebenen ID. Ab der angegebenen ID werden Befehle in umgekehrter sequenzieller Reihenfolge gelöscht. Wenn die ID beispielsweise 30 ist und die Anzahl 10 ist, Clear-History werden die Elemente 21 bis 30 gelöscht.

Die Parameter "Anzahl" und "CommandLine " können zusammen verwendet werden. Count gibt die Anzahl der Befehle an, die gelöscht werden sollen, die dem Wert des CommandLine-Parameters 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 die Befehlsverlaufs-ID an, die Clear-History gelöscht wird. Verwenden Sie das Get-History Cmdlet, um ID-Nummern anzuzeigen. Die ID-Nummern sind sequenziell und Befehle behalten ihre ID-Nummer während einer PowerShell-Sitzung bei. Der Id-Parameter kann mit Count und Newest verwendet werden.

Typ:Int32[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Newest

Wenn der neueste Parameter verwendet wird, Clear-History werden die neuesten Einträge im Verlauf gelöscht. Löscht standardmäßig Clear-History die ältesten Einträge im Verlauf.

Der neueste Parameter kann mit ID und Count verwendet werden. Der Parameter Count gibt die Anzahl der zu löschenden Befehle an, einschließlich der angegebenen ID. Ab der angegebenen ID werden Befehle in sequenzieller Reihenfolge gelöscht. Wenn die ID beispielsweise 30 ist und die Anzahl 10 ist, Clear-History werden die Elemente 30 bis 39 gelöscht.

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

-WhatIf

Zeigt, was passiert, wenn das Clear-History Cmdlet 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, Standard vom PSReadLine-Modul enthalten ist. Beide Historien sind in Sitzungen verfügbar, in denen PSReadLine geladen wird. Dieses Cmdlet funktioniert nur mit dem Sitzungsverlauf. Weitere Informationen finden Sie unter about_PSReadLine.