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