Invoke-History

Module:
Microsoft.PowerShell.Core Module

Exécute des commandes à partir de l’historique de session.

Syntaxe

Default (Par défaut) 

Invoke-History
    [[-Id] <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet Invoke-History de commande exécute des commandes à partir de l’historique de session. Vous pouvez transmettre des objets représentant les commandes de Get-History à Invoke-History, ou vous pouvez identifier les commandes dans l’historique actuel à l’aide de leur numéro d’ID . Pour rechercher le numéro d’identification d’une commande, utilisez l’applet Get-History de commande.

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 : Exécuter la commande la plus récente dans l’historique

Cet exemple exécute la dernière commande, ou la plus récente, dans l’historique de session. Vous pouvez abbrevier cette commande en tant que r, l’alias pour Invoke-History.

Invoke-History

Exemple 2 : Exécuter la commande qui a un ID spécifié

Cet exemple exécute la commande dans l’historique de session avec l’ID 132. Étant donné que le nom du paramètre Id est facultatif, vous pouvez abrégér cette commande comme suit : Invoke-History 132, ihy 132ou r 132.

Invoke-History -Id 132

Exemple 3 : Exécuter la commande la plus récente à l’aide du texte de la commande

Cet exemple exécute la commande la plus récente Get-Process dans l’historique de session. Lorsque vous tapez des caractères pour le paramètre Id , Invoke-History exécute la première commande qu’il trouve qui correspond au modèle, en commençant par les commandes les plus récentes.

Invoke-History -Id get-pr

Note

La correspondance de modèle ne respecte pas la casse, mais le modèle correspond au début de la ligne.

Exemple 4 : Exécuter une séquence de commandes à partir de l’historique

Cet exemple exécute les commandes 16 à 24. Étant donné que vous ne pouvez répertorier qu’une seule valeur d’ID , la commande utilise l’applet ForEach-Object de commande pour exécuter la Invoke-History commande une fois pour chaque valeur d’ID .

16..24 | ForEach-Object {Invoke-History -Id $_ }

Exemple 5

Cet exemple exécute les sept commandes de l’historique qui se terminent par la commande 255 (249 à 255). Il utilise l’applet Get-History de commande pour récupérer les commandes. Étant donné que vous ne pouvez répertorier qu’une seule valeur d’ID , la commande utilise l’applet ForEach-Object de commande pour exécuter la Invoke-History commande une seule fois pour chaque valeur d’ID .

Get-History -Id 255 -Count 7 | ForEach-Object {Invoke-History -Id $_.Id}

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Id

Spécifie l’ID d’une commande dans l’historique. Vous pouvez taper le numéro d’ID de la commande ou les premiers caractères de la commande.

Si vous tapez des caractères, Invoke-History correspond d’abord aux commandes les plus récentes. Si vous omettez ce paramètre, Invoke-History exécute la dernière commande, ou la plus récente. Pour rechercher le numéro d’ID d’une commande, utilisez l’applet Get-History de commande.

Propriétés du paramètre

Type:String
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:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

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

String

Vous pouvez diriger un ID d’historique vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne aucune sortie propre, mais les commandes qu’elle exécute peuvent retourner leur propre sortie.

Notes

PowerShell inclut les alias suivants pour Invoke-History:

  • Toutes les plateformes :
    • ihy
    • r

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 sessions, consultez about_History.