Partager via

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 de commande Invoke-History 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 grâce à leur numéro Id . Pour rechercher le numéro d’identification d’une commande, utilisez l’applet de commande Get-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 : 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 abrégée cette commande en tant que r, l’alias de 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 ID 132. Étant donné que le nom du paramètre ID de 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 Get-Process la plus récente dans l’historique de session. Lorsque vous tapez des caractères pour le paramètre ID de, 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

Remarque

Le modèle de correspondance est insensible à 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 Id, la commande utilise l’applet de commande ForEach-Object pour exécuter la commande Invoke-History une fois pour chaque valeur 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 de commande Get-History pour récupérer les commandes. Étant donné que vous ne pouvez répertorier qu’une seule valeur ID, la commande utilise l’applet de commande ForEach-Object pour exécuter la commande Invoke-History une fois pour chaque valeur 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 l’ID numéro 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 l’ID numéro d’une commande, utilisez l’applet de commande Get-History.

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 ajouter un ID historique à cette cmdlet.

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.