Partager via


Get-History

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

Syntaxe

Default (Par défaut)

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 à la fois 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.

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

Propriétés du paramètre

Type:

Int64[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:False
Valeur du pipeline:True
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

Int64

Vous pouvez transmettre un ID d’historique à cette cmdlet.

Sorties

HistoryInfo

Cette applet de commande retourne un objet d'historique pour chaque élément d'historique qu'elle 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.