Supprime des entrées de l'historique des commandes.

Syntaxe

Clear-History [[-Id] <Int32[]>] [[-Count] <int>] [-Newest] [-Confirmer] [-WhatIf] [<CommonParameters>]

Clear-History [[-Count] <int>] [-CommandLine <string[]>] [-Newest] [-Confirmer] [-WhatIf] [<CommonParameters>]

Description

L'applet de commande Clear-History supprime des commandes de l'historique des commandes, c'est-à-dire de la liste des commandes entrées pendant la session active.

Sans paramètres, Clear-History supprime toutes les commandes de l'historique de la session, mais vous pouvez utiliser les paramètres de Clear-History pour supprimer les commandes de votre choix.

Paramètres

-CommandLine <string[]>

Supprime les commandes comportant les chaînes de texte spécifiées. Si vous entrez plusieurs chaînes, Clear-History supprime les commandes comportant n'importe laquelle des chaînes.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

true

-Count <int>

Efface le nombre spécifié d'entrées de l'historique, en commençant par l'entrée la plus ancienne.

Si vous utilisez les paramètres Count et Id dans la même commande, l'applet de commande efface le nombre d'entrées spécifié par le paramètre Count, en commençant par l'entrée indiquée par le paramètre Id. Par exemple, si Count a la valeur 10 et Id la valeur 30, Clear-History efface les éléments compris entre 21 et 30 inclus.

Si vous utilisez les paramètres Count et CommandLine dans la même commande, Clear-History efface le nombre d'entrées spécifié par le paramètre Count, en commençant par l'entrée spécifiée par le paramètre CommandLine.

Obligatoire ?

false

Position ?

2

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Id <Int32[]>

Supprime les commandes comportant les ID d'historique spécifiés.

Pour rechercher l'ID d'historique d'une commande, utilisez Get-History.

Obligatoire ?

false

Position ?

1

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Newest

Supprime de l'historique les entrées les plus récentes. Par défaut, Clear-History supprime les entrées les plus anciennes de l'historique.

Obligatoire ?

false

Position ?

named

Valeur par défaut

False

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Confirmer

Vous invite à confirmer l'exécution de la commande.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-WhatIf

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

Aucun

Vous ne pouvez pas diriger d'objets vers Clear-History.

Sorties

Aucun

Cette applet de commande ne génère aucune sortie.

Remarques

L'historique de la session est une liste des commandes entrées pendant la session. Vous pouvez consulter l'historique, ajouter et supprimer des commandes, et exécuter des commandes à partir de l'historique. Pour plus d'informations, consultez about_History.

La suppression d'une commande de l'historique ne modifie pas les ID de l'historique des éléments restants dans l'historique des commandes.

Exemple 1

C:\PS>clear-history

Description
-----------
Supprime toutes les commandes de l'historique de la session.






Exemple 2

C:\PS>clear-history -id 23, 25

Description
-----------
Supprime les commandes comportant les ID de l'historique 23 et 25.






Exemple 3

C:\PS>clear-history -command *help*, *command

Description
-----------
Supprime les commandes qui incluent « help » ou se terminent par « command ».






Exemple 4

C:\PS>clear-history -count 10 -newest

Description
-----------
Supprime les 10 commandes les plus récentes de l'historique.






Exemple 5

C:\PS>clear-history -id 10 -count 3

Description
-----------
Supprime les trois commandes les plus anciennes, en commençant par l'entrée avec l'ID 10.






Voir aussi




Table des matières