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




Inhaltsverzeichnis