Partager via


Clear-History

Supprime les entrées de l’historique des commandes de session PowerShell.

Syntax

Clear-History
     [[-Id] <int[]>]
     [[-Count] <int>]
     [-Newest]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
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-Historyaffiche 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-Historyaffiche 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, inclus 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 carte s 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 about_Quoting_Rules.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de Clear-History commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute Clear-History . L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de 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 dans les sessions où PSReadLine est chargé. Cette applet de commande fonctionne uniquement avec l’historique de session. Pour plus d’informations, consultez about_PSReadLine.