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.