Löscht Einträge aus dem Befehlsverlauf.
Syntax
Clear-History [[-Id] <Int32[]>] [[-Count] <int>] [-Newest] [-Bestätigung] [-WhatIf] [<CommonParameters>] Clear-History [[-Count] <int>] [-CommandLine <string[]>] [-Newest] [-Bestätigung] [-WhatIf] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Clear-History" werden Befehle aus dem Befehlsverlauf entfernt bzw. wird die Liste der im Verlauf der aktuellen Sitzung eingegebenen Befehle gelöscht.
Wenn keine Parameter angegeben werden, werden mit Clear-History alle Befehle aus dem Sitzungsverlauf gelöscht. Mit den Parametern von Clear-History können jedoch auch ausgewählte Befehle gelöscht werden.
Parameter
-CommandLine <string[]>
Löscht Befehle mit den angegebenen Textzeichenfolgen. Wenn Sie mehr als eine Zeichenfolge eingeben, werden Befehle mit einer beliebigen Zeichenfolge von Clear-History gelöscht.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
true |
-Count <int>
Löscht die angegebene Anzahl der Verlaufseinträge beginnend mit dem ältesten Eintrag.
Wenn Sie den Count-Parameter und den Id-Parameter in einem Befehl verwenden, werden so viele Einträge vom Cmdlet gelöscht, wie durch den Count-Parameter angegeben werden. Dabei wird mit dem Eintrag begonnen, der durch den Id-Parameter angegeben wird. Wenn für Count beispielsweise "10" und für "Id" 30 angegeben wird, werden die Elemente 21 bis einschließlich 30 von Clear-History gelöscht.
Wenn Sie den Count-Parameter und den CommandLine-Parameter in einem Befehl verwenden, werden so viele Einträge von Clear-History gelöscht, wie durch den Count-Parameter angegeben werden. Dabei wird mit dem Eintrag begonnen, der durch den CommandLine-Parameter angegeben wird.
|
Erforderlich? |
false |
|
Position? |
2 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Id <Int32[]>
Löscht Befehle mit den angegebenen Verlauf-IDs.
Mit Get-History können Sie die Verlaufs-ID eines Befehls bestimmen.
|
Erforderlich? |
false |
|
Position? |
1 |
|
Standardwert |
keine |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Newest
Löscht die neuesten Einträge im Verlauf. Clear-History entfernt standardmäßig die ältesten Einträge im Verlauf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
False |
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Bestätigung
Fordert Sie vor der Ausführung des Befehls zur Bestätigung auf.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen.
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
None Objekte können nicht über die Pipeline an Clear-History übergeben werden. |
|
Ausgaben |
None Dieses Cmdlet generiert keine Ausgabe. |
Hinweise
Der Sitzungsverlauf enthält eine Liste der Befehle, die während der aktuellen Sitzung eingegeben wurden. Sie können den Verlauf anzeigen, Befehle hinzufügen und Befehle aus dem Verlauf ausführen. Weitere Informationen finden Sie unter "about_History".
Durch das Löschen eines Befehls aus dem Verlauf werden die Verlauf-IDs der verbleibenden Elemente im Befehlsverlauf nicht verändert.
Beispiel 1
C:\PS>clear-history Beschreibung ----------- Löscht alle Befehle aus dem Sitzungsverlauf.
Beispiel 2
C:\PS>clear-history -id 23, 25 Beschreibung ----------- Löscht die Befehle mit den Verlauf-IDs 23 und 25.
Beispiel 3
C:\PS>clear-history -command *help*, *command Beschreibung ----------- Löscht Befehle, die "help" beinhalten oder auf "command" enden.
Beispiel 4
C:\PS>clear-history -count 10 -newest Beschreibung ----------- Löscht die 10 neuesten Befehle aus dem Verlauf.
Beispiel 5
C:\PS>clear-history -id 10 -count 3 Beschreibung ----------- Löscht die drei ältesten Befehle beginnend mit dem Eintrag mit der ID 10.
Siehe auch