Share via

Clear-History

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

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

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 de 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’ID séparés 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 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.

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 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 correspondre exactement 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:Int32
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 est supprimé. 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 tout au long d’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 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 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 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 produirait 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.

L’historique des sessions est géré séparément de l’historique géré 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 des sessions. Pour plus d’informations, consultez , about_PSReadLine.