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 Get-History commande.
Par défaut, Clear-History supprime l’intégralité de l’historique des commandes d’une session PowerShell. Vous pouvez utiliser des paramètres pour Clear-History supprimer les commandes sélectionnées.
Clear-History ne efface pas le fichier d’historique PSReadLine des commandes. Le PSReadLine module 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 de l’historique PSReadLine 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 Get-History de commande affiche l’historique de la session PowerShell.
Clear-History supprime l’intégralité de 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 Get-History de commande 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 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 Get-History de commande affiche l’historique de la session PowerShell.
Clear-History supprime l’historique des commandes. Le paramètre CommandLine spécifie les commandes qui contiennent l’aide ou se terminent par la syntaxe.
Get-History affiche l’historique des commandes mis à jour et confirme que les commandes ID 3, ID 5, ID 6 et 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 à l’aide de l’ID. Pour supprimer plusieurs commandes, envoyez une liste séparée par des virgules de numéros d’ID .
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 Get-History de commande 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 l’ID 3 et l’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, le plus récent au plus ancien.
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 Get-History de commande affiche l’historique de la session PowerShell.
Clear-History supprime l’historique des commandes. Le paramètre Id spécifie de commencer par l’ID 7. Le paramètre Count spécifie de supprimer cinq commandes, y compris l’ID 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 être une correspondance exacte ou utiliser des caractères génériques pour faire correspondre les commandes dans l’historique des sessions PowerShell affichée 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 Clear-History commande.
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 qui Clear-History suppriment. 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 spécifié. À partir de l’ID spécifié, les commandes sont supprimées dans l’ordre séquentiel inverse. Par exemple, si l’ID est 30 et que le nombre est égal à 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 du 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’ID de l’historique des commandes qui Clear-History supprime. Pour afficher les numéros d’ID , utilisez l’applet de Get-History commande. Les numéros d’ID sont séquentiels et les commandes conservent leur numéro d’ID dans 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 dans l’historique.
Le paramètre Le plus récent peut être utilisé avec ID et Count. Le paramètre Count spécifie le nombre de commandes à supprimer, y compris l’ID spécifié. À partir de l’ID spécifié, les commandes sont supprimées dans l’ordre séquentiel. Par exemple, si l’ID est 30 et que le nombre 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 s’exécute Clear-History . 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
PowerShell inclut les alias suivants pour Clear-History:
- Toutes les plateformes :
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.
