Partager via

Invoke-History

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

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

Syntaxe

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 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 : 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

Remarque

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 demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

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

Windows PowerShell inclut les alias suivants pour Invoke-History:

  • ihy
  • r

L'historique de session est une liste des commandes entrées pendant la session. L'historique de session 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.