Obtient la liste des commandes entrées pendant la session active.
Syntaxe
Get-History [[-Id] <Int64[]>] [[-Count] <int>] [<CommonParameters>]
Description
L'applet de commande Get-History obtient l'historique de la session, c'est-à-dire la liste des commandes entrées pendant la session active. Windows PowerShell gère automatiquement un historique de chaque session. Vous pouvez enregistrer l'historique de la session au format XML ou CSV. Par défaut, les fichiers d'historique sont enregistrés dans le répertoire de base, mais vous pouvez les enregistrer dans n'importe quel emplacement.
Paramètres
-Count <int>
Affiche le nombre spécifié d'entrées de l'historique les plus récentes. La valeur par défaut est 32. 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.
|
Obligatoire ? |
false |
|
Position ? |
2 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Id <Int64[]>
Spécifie le numéro d'ID d'une commande dans l'historique de la session. Get-History obtient uniquement la commande spécifiée. Si vous utilisez Id et Count, Get-History obtient les commandes les plus récentes se terminant par la commande spécifiée par le paramètre Id.
|
Obligatoire ? |
false |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
Int64 Vous pouvez diriger un ID d'historique vers Get-History. |
|
Sorties |
Microsoft.PowerShell.Commands.HistoryInfo Get-History retourne un objet d'historique pour chaque élément d'historique obtenu. |
Remarques
L'historique de la session correspond à une liste des commandes entrées pendant la session, accompagnées de leur ID. Il représente l'ordre d'exécution, l'état, ainsi que les heures de début et de fin de la commande. À mesure que vous entrez chaque commande, Windows PowerShell l'ajoute à l'historique afin que vous puissiez la réutiliser. Pour plus d'informations sur l'historique des commandes, consultez about_History.
Vous pouvez également faire référence à Get-History en utilisant ses alias intégrés, « h », « history » et « ghy ». Pour plus d'informations, consultez about_Aliases.
Exemple 1
C:\PS>get-history Description ----------- Cette commande obtient les dernières 32 commandes envoyées. L'affichage par défaut présente chaque commande et son ID, lequel indique l'ordre d'exécution.
Exemple 2
C:\PS>get-history | where-object {$_.commandLine -like "*service*"}
Description
-----------
Cette commande obtient les entrées de l'historique des commandes qui incluent le mot « service ». La première commande obtient les 32 entrées les plus récentes de l'historique de la session. L'opérateur de pipeline (|) passe les résultats à l'applet de commande Where-Object, laquelle sélectionne uniquement les commandes qui incluent « service ».
Exemple 3
C:\PS>get-history -id 7 -count 5 | export-csv history.csv Description ----------- Cette commande obtient les cinq entrées les plus récentes de l'historique se terminant par l'entrée 7. L'opérateur de pipeline (|) passe le résultat à l'applet de commande Export-Csv, laquelle 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 qui s'affichent lorsque vous mettez en forme l'historique en tant que liste, y compris l'état et les heures de début et de fin de la commande.
Exemple 4
C:\PS>get-history -count 1 Description ----------- Cette commande obtient la dernière commande (la plus récemment entrée) dans l'historique des commandes. Elle utilise le paramètre Count pour afficher une seule commande. Par défaut, Get-History affiche les commandes les plus récentes. Cette commande peut être abrégée sous la forme « h –c 1 » et revient à appuyer sur la touche Haut.
Exemple 5
C:\PS>get-history -count $MaximumHistoryCount Description ----------- Cette commande affiche toutes les commandes enregistrées dans l'historique de la session. Par défaut, $MaximumHistoryCount a la valeur 64 ; cette commande peut donc être abrégée sous la forme « h -c 64 ».
Exemple 6
C:\PS>get-history | format-list Description ----------- Cette commande affiche toutes les propriétés des entrées de l'historique de la session. L'opérateur de pipeline (|) passe le résultat à l'applet de commande Format-List, laquelle affiche toutes les propriétés de chaque entrée de l'historique, y compris l'ID, l'état et les heures de début et de fin de la commande.
Voir aussi