Partager via

Clear-History

  • Référence
Module:
Microsoft.PowerShell.Core

Supprime des entrées de l’historique des commandes 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 des commandes. Pour afficher l’historique des commandes, utilisez l’applet de Get-History commande .

Par défaut, Clear-History supprime l’historique complet des commandes d’une session PowerShell. Vous pouvez utiliser des paramètres avec Clear-History pour supprimer les commandes sélectionnées.

Clear-History n’efface pas le fichier d’historique des PSReadLine 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 de votre clavier pour faire défiler 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 PSReadLine et 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.

PS> Get-History

  Id CommandLine
  -- -----------
   1 Set-Location .\Test
   2 Update-Help
   3 Set-Location C:\Test\Logs
   4 Get-Location

PS> Clear-History

PS> 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.

PS> 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

PS> Clear-History -Count 5 -Newest

PS> 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 Newest 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 .

PS C:\Test> 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

PS> Clear-History -CommandLine *Help*, *Syntax

PS> 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ées.

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 de numéros d’identification séparés par des virgules.

PS> 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

PS C:\> Clear-History -Id 3, 5

PS> 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 des 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, du plus récent au plus ancien.

PS> 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

PS> Clear-History -Id 7 -Count 5

PS> 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 la suppression de 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é 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 sont supprimées. Les commandes sont supprimées dans l’ordre, en commençant par l’entrée la plus ancienne de 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 le nombre 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 du paramètre CommandLine . Les commandes sont supprimées dans l’ordre séquentiel.

Type:Int
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Spécifie l’ID d’historique des commandes qui Clear-History supprime. Pour afficher les numéros d’identification , utilisez l’applet de Get-History commande . Les numéros d’identification sont séquentiels et les commandes conservent leur numéro d’identification tout au long d’une session PowerShell. Le paramètre Id peut être utilisé avec Count et Newest.

Type:Int[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Newest

Lorsque le paramètre Newest est utilisé, Clear-History supprime les entrées les plus récentes de 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 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 le nombre est 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 Clear-History.

Sorties

None

Clear-History ne génère aucune sortie.

Notes

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.