Clear-History
Supprime les entrées de l’historique des commandes de session PowerShell.
Syntaxe
IDParameter (Par défaut)
Clear-History
[[-Id] <int[]>]
[[-Count] <int>]
[-Newest]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CommandLineParameter
Clear-History
[[-Count] <int>]
[-CommandLine <string[]>]
[-Newest]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Clear-History supprime l’historique des commandes d’une session PowerShell. Chaque session PowerShell a son propre historique de commandes. Pour afficher l’historique des commandes, utilisez l’applet de commande Get-History.
Par défaut, Clear-History supprime l’intégralité de l’historique des commandes d’une session PowerShell. Vous pouvez utiliser des paramètres avec Clear-History pour supprimer les commandes sélectionnées.
Clear-History ne efface pas le fichier d’historique des commandes PSReadLine. Le module PSReadLine stocke un fichier d’historique qui contient chaque commande PowerShell de chaque session PowerShell. À partir d’une invite PowerShell, utilisez les flèches haut et bas sur votre clavier pour parcourir l’historique des commandes. Pour afficher la configuration PSReadLine pour l’historique des commandes, utilisez Get-PSReadLineOption.
PSReadLine fourni avec PowerShell 5.0 et versions ultérieures. Pour plus d’informations, consultez about_PSReadLine.
Exemples
Exemple 1 : Supprimer l’historique des commandes d’une session PowerShell
Cette commande supprime toutes les commandes de l’historique d’une session PowerShell.
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
L’applet de commande Get-History affiche l’historique de la session PowerShell.
Clear-History supprime l’historique des commandes.
Get-History affiche l’historique des commandes mis à jour et confirme que l’historique précédent a été supprimé.
Exemple 2 : Supprimer les commandes les plus récentes
Cette commande utilise les paramètres Count et Newest pour supprimer les commandes les plus récentes de l’historique d’une session PowerShell.
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
L’applet de commande Get-History affiche l’historique de la session PowerShell.
Clear-History est utilisé pour supprimer l’historique des commandes. Le paramètre Count spécifie le nombre de commandes à supprimer, y compris l’ID de spécifié. Le paramètre le plus récent spécifie que les commandes les plus récentes sont effacées de l’historique.
Get-History affiche l’historique des commandes mis à jour et confirme que les cinq commandes les plus récentes ont été supprimées, ID 6 - ID 10.
Exemple 3 : Supprimer des commandes qui correspondent à des critères spécifiques
Cette commande supprime les commandes qui correspondent à des critères spécifiques définis par le paramètre CommandLine.
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
L’applet de commande Get-History affiche l’historique de la session PowerShell.
Clear-History supprime l’historique des commandes. Le paramètre CommandLine spécifie les commandes qui contiennent Aide ou se terminent par Syntaxe.
Get-History affiche l’historique des commandes mis à jour et confirme que les commandes ID 3, ID 5, ID 6et Id 7 ont été supprimés.
Exemple 4 : Supprimer des commandes par numéro d’ID
Cette commande supprime des éléments d’historique spécifiques en utilisant l’ID . Pour supprimer plusieurs commandes, envoyez une liste d’ID , séparée par des virgules.
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
L’applet de commande Get-History affiche l’historique de la session PowerShell.
Clear-History supprime l’historique des commandes. Le paramètre ID spécifie les commandes à supprimer.
Get-History affiche l’historique des commandes mis à jour et confirme que ID 3 et ID 5 ont été supprimés.
Exemple 5 : Supprimer les commandes par numéro d’ID et nombre
Cette commande utilise les paramètres id et Count pour supprimer l’historique des commandes. Les commandes sont supprimées de l’Id spécifié dans l’ordre inverse, de la plus récente à la plus ancienne.
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
L’applet de commande Get-History affiche l’historique de la session PowerShell.
Clear-History supprime l’historique des commandes. Le paramètre Id précise de commencer par Id 7. Le paramètre Count spécifie pour supprimer cinq commandes, y compris l’ID de spécifié. Get-History affiche l’historique des commandes mis à jour et confirme que cinq commandes ont été supprimées, ID 3 - ID 7.
Paramètres
-CommandLine
Supprime l’historique des commandes d’une session PowerShell. La chaîne doit correspondre exactement ou utiliser des caractères génériques pour correspondre aux commandes de l'historique de session PowerShell affiché par Get-History. Si vous entrez plusieurs chaînes, Clear-History supprime les commandes qui correspondent à l’une des chaînes. Le paramètre CommandLine peut être utilisé avec Count.
Pour les chaînes avec un espace, utilisez des guillemets simples. Pour plus d'informations, consultez la section sur les règles de citation.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
CommandLineParameter
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande Clear-History.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Count
Spécifie le nombre d’entrées d’historique que Clear-History supprime. Les commandes sont supprimées dans l’ordre, en commençant par l’entrée la plus ancienne dans l’historique.
Les paramètres Count et Id peuvent être utilisés ensemble. Le paramètre Count spécifie le nombre de commandes à supprimer, y compris l’ID de spécifié. À partir de l’id de spécifié, les commandes sont supprimées dans l’ordre séquentiel inverse. Par exemple, si l’ID de est 30 et que le Count est 10, Clear-History supprime les éléments 21 à 30.
Les paramètres Count et CommandLine peuvent être utilisés ensemble. Count spécifie le nombre de commandes à supprimer qui correspondent à la valeur de paramètre CommandLine. Les commandes sont supprimées dans l’ordre séquentiel.
Propriétés du paramètre
| Type: | Int32 |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Id
Spécifie l’historique des commandes Id que Clear-History supprime. Pour afficher les nombres d'identifiants , utilisez l’applet de commande Get-History. Les numéros d'Id sont séquentiels et les commandes conservent leur numéro d'Id tout au long d’une session PowerShell. Le paramètre Id peut être utilisé avec Count et Newest.
Propriétés du paramètre
| Type: | Int32[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
IDParameter
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Newest
Lorsque le paramètre le plus récent est utilisé, Clear-History supprime les entrées les plus récentes dans l’historique. Par défaut, Clear-History supprime les entrées les plus anciennes de l’historique.
Le paramètre Newest peut être utilisé avec Id et Count. Le paramètre Count spécifie le nombre de commandes à supprimer, y compris l’ID de spécifié. À partir du ID spécifié, les commandes sont supprimées dans l’ordre séquentiel. Par exemple, si l’ID de est de 30 et que le nombre de est égal à 10, Clear-History supprime les éléments 30 à 39.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande Clear-History s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
None
Vous ne pouvez pas diriger les objets vers cette applet de commande.
Sorties
None
Cette applet de commande ne retourne aucune sortie.
Notes
Windows PowerShell inclut les alias suivants pour Clear-History:
clhy
L’historique des sessions PowerShell est une liste des commandes entrées pendant une session PowerShell. Vous pouvez afficher l’historique, ajouter et supprimer des commandes et exécuter des commandes à partir de l’historique. Pour plus d’informations, consultez about_History.
L’historique des sessions est géré séparément de l’historique conservé par le module PSReadLine. Les deux historiques sont disponibles lors des sessions où PSReadLine est chargé. Cette applet de commande fonctionne uniquement avec l’historique de session. Pour plus d’informations, consultez about_PSReadLine.
