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

Standardmäßig Clear-History löscht 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 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. Verwenden Sie Get-PSReadLineOptionzum Anzeigen der Konfiguration für den PSReadLine Befehlsverlauf . 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

Dieser Befehl löscht alle Befehle aus dem Verlauf einer PowerShell-Sitzung.

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 Count und Newest , 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 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

Dieser Befehl löscht Befehle, die bestimmten Kriterien entsprechen, die vom CommandLine-Parameter definiert werden.

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 enthalten oder mit Syntax enden. Get-History zeigt den aktualisierten Befehlsverlauf an und bestätigt, dass die Befehle ID 3, ID 5, ID 6 und ID 7 gelöscht wurden.

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

Dieser Befehl löscht bestimmte Verlaufselemente mithilfe der ID. Um mehrere Befehle zu löschen, übermitteln Sie eine durch Trennzeichen getrennte Liste von 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 von der angegebenen ID in umgekehrter Reihenfolge gelöscht, von der neuesten bis zur ältesten.

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 mit id 7 begonnen werden soll. Der Count-Parameter 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, um Befehle im PowerShell-Sitzungsverlauf abzugleichen, der von angezeigt wird Get-History. Wenn Sie mehr als eine Zeichenfolge eingeben, Clear-History löscht Befehle, 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.

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 an, einschließlich der angegebenen ID. Ab der angegebenen ID werden Befehle in umgekehrter sequenzieller Reihenfolge gelöscht. Wenn die ID beispielsweise 30 und die Anzahl 10 ist, Clear-History werden die Elemente 21 bis 30 gelöscht.

Die Parameter Count und CommandLine können zusammen verwendet werden. Count gibt die Anzahl der zu löschenden Befehle an, die mit dem CommandLine-Parameterwert übereinstimmen. Die Befehle werden in sequenzieller Reihenfolge gelöscht.

Type:Int32
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Newest

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

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 und die Anzahl 10 ist, Clear-History werden die Elemente 30 bis 39 gelöscht.

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

-WhatIf

Zeigt an, was passieren würde, wenn das Clear-History Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

None

Sie können keine Objekte an dieses Cmdlet übergeben.

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 Verlaufsverläufe sind in Sitzungen verfügbar, in denen PSReadLine geladen wird. Dieses Cmdlet funktioniert nur mit dem Sitzungsverlauf. Weitere Informationen finden Sie unter about_PSReadLine.