Partager via

Get-History

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

Obtient une liste des commandes entrées pendant la session active.

Syntaxe

Get-History
   [[-Id] <Int64[]>]
   [[-Count] <Int32>]
   [<CommonParameters>]

Description

L'applet de commande Get-History obtient l’historique de session, c’est-à-dire la liste des commandes entrées pendant la session active.

PowerShell gère automatiquement un historique de chaque session. Le nombre d’entrées dans l’historique de session est déterminé par la valeur de la variable de préférence $MaximumHistoryCount. À compter de Windows PowerShell 3.0, la valeur par défaut est 4096.

Vous pouvez enregistrer l’historique des sessions au format XML ou CSV. Par défaut, les fichiers d’historique sont enregistrés dans le répertoire de base, mais vous pouvez enregistrer le fichier à n’importe quel emplacement.

Pour plus d’informations sur les fonctionnalités d’historique dans PowerShell, consultez about_History dans Microsoft Docs.

Exemples

Exemple 1 : Obtenir l’historique des sessions

Get-History

Cette commande obtient les entrées de l’historique de session. L’affichage par défaut affiche chaque commande et son ID, ce qui indique l’ordre dans lequel ils ont été exécutés.

Exemple 2 : Obtenir des entrées qui incluent une chaîne

Get-History | Where-Object {$_.CommandLine -like "*Service*"}

Cette commande obtient des entrées dans l’historique des commandes qui incluent le service de chaînes. La première commande obtient toutes les entrées de l’historique de session. L’opérateur de pipeline (|) transmet les résultats à l’applet de commande Where-Object, qui sélectionne uniquement les commandes qui incluent le service.

Exemple 3 : Exporter au maximum sept entrées

Get-History -ID 7 -Count 5 | Export-Csv History.csv

Cette commande obtient les cinq entrées d’historique les plus récentes se terminant par l’entrée 7. L’opérateur de pipeline transmet le résultat à l’applet de commande Export-Csv, qui met en forme l’historique en tant que texte séparé par des virgules et l’enregistre dans le fichier History.csv. Le fichier inclut les données affichées lorsque vous mettez en forme l’historique en tant que liste. Cela inclut l’état et les heures de début et de fin de la commande.

Exemple 4 : Afficher la commande la plus récente

Get-History -Count 1

Cette commande obtient la dernière commande dans l’historique des commandes. La dernière commande est la commande la plus récente entrée. Cette commande utilise le paramètre Count pour afficher une seule commande. Par défaut, obtenir l’historique des obtient les commandes les plus récentes. Cette commande peut être abrégée en « h -c 1 » et équivaut à appuyer sur la flèche vers le haut.

Exemple 5 : Afficher toutes les propriétés des entrées dans l’historique

Get-History | Format-List -Property *

Cette commande affiche toutes les propriétés des entrées dans l’historique de session. L’opérateur de pipeline transmet les résultats d’une commande Get-History à l’applet de commande Format-List, qui affiche toutes les propriétés de chaque entrée d’historique. Cela inclut l’ID, l’état et les heures de début et de fin de la commande.

Paramètres

-Count

Spécifie le nombre des entrées d’historique les plus récentes que cette applet de commande obtient. Par défaut, get-History obtient toutes les entrées de l’historique de session. Si vous utilisez les paramètres count et Id dans une commande, l’affichage se termine par la commande spécifiée par le paramètre Id.

Dans Windows PowerShell 2.0, par défaut, obtenir l’historique des obtient les 32 entrées les plus récentes.

Type:Int32
Position:1
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifie un tableau des ID d’entrées dans l’historique de session. obtenir l’historique des obtient uniquement les entrées spécifiées. Si vous utilisez les paramètres Id et Count dans une commande, Obtenir l’historique obtient les entrées les plus récentes se terminant par l’entrée spécifiée par le paramètre ID de .

Type:Int64[]
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

Int64

Vous pouvez diriger un ID d’historique vers cette applet de commande.

Sorties

HistoryInfo

Cette applet de commande retourne un objet d’historique pour chaque élément d’historique qu’il obtient.

Notes

  • L’historique des sessions est une liste des commandes entrées pendant la session. L’historique des sessions représente l’ordre d’exécution, l’état et les heures de début et de fin de la commande. Lorsque vous entrez chaque commande, PowerShell l’ajoute à l’historique afin de pouvoir le réutiliser. Pour plus d’informations sur l’historique des commandes, consultez about_History.
  • À compter de Windows PowerShell 3.0, la valeur par défaut de la variable de préférence $MaximumHistoryCount est 4096. Dans Windows PowerShell 2.0, la valeur par défaut est 64. Pour plus d’informations sur la variable $MaximumHistoryCount, consultez about_Preference_Variables.