Get-History

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

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

Syntax

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

Description

L’applet Get-History de commande 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 $MaximumHistoryCount variable de préférence. À 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 dans les 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 obtient les entrées dans 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.

Get-History

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

Cet exemple 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 Where-Object de commande, 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 Export-Csv de commande, qui met l’historique en forme de 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 touche 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 Get-History commande à l’applet Format-List de commande, 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 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.

Type:Int32
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:Int64[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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

PowerShell inclut les alias suivants pour Get-History:

  • Toutes les plateformes :
    • h
    • history
    • ghy

L'historique de session 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 $MaximumHistoryCount variable de préférence 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.