Partager via

Get-History

Module:
Microsoft.PowerShell.Core Module

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

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

L’historique des sessions est géré séparément de l’historique conservé par le module PSReadLine. Les deux historiques sont disponibles lors des sessions où PSReadLine est chargé. Cette applet de commande fonctionne uniquement avec l’historique de session. Pour plus d’informations, consultez about_PSReadLine.

Exemples

Exemple 1 : Obtenir l’historique des sessions

Cet exemple permet d'obtenir les entrées de l'historique de la 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.

Get-History

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

Cet exemple permet d'obtenir les entrées de l'historique des commandes qui contiennent la chaîne de caractères service. 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.

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

Exemple 3 : Exporter des entrées d’historique jusqu’à un ID spécifique

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

Get-History -Id 7 -Count 5 | Export-Csv -Path History.csv

Exemple 4 : Afficher la commande la plus récente

Cet exemple 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, Get-History 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.

Get-History -Count 1

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

Cet exemple montre comment afficher 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.

Get-History | Format-List -Property *

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, Get-History 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. Get-History obtient uniquement les entrées spécifiées. Si vous utilisez les paramètres id et Count dans une commande, Get-History obtient les entrées les plus récentes se terminant par l’entrée spécifiée par le paramètre ID.

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

PowerShell inclut les alias suivants pour Get-History:

  • Toutes les plateformes :
    • h
    • history
    • ghy

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.