Compartir a través de

Invoke-History

Módulo:
Microsoft.PowerShell.Core Module

Ejecuta comandos desde el historial de sesiones.

Sintaxis

Default (valor predeterminado) 

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

Description

El cmdlet Invoke-History ejecuta comandos desde el historial de sesiones. Puede pasar objetos que representan los comandos de Get-History a Invoke-History, o bien puede identificar comandos en el historial actual mediante su número de Id. Para buscar el número de identificación de un comando, use el cmdlet Get-History.

El historial de sesiones se administra independientemente del historial mantenido por el módulo PSReadLine. Ambos historiales están disponibles en sesiones en las que se carga PSReadLine. Este cmdlet solo funciona con el historial de sesiones. Para obtener más información, consulte about_PSReadLine.

Ejemplos

Ejemplo 1: Ejecutar el comando más reciente del historial

En este ejemplo se ejecuta el último comando, o más reciente, en el historial de sesiones. Puede abreviar este comando como r, el alias de Invoke-History.

Invoke-History

Ejemplo 2: Ejecutar el comando que tiene un identificador especificado

En este ejemplo se ejecuta el comando en el historial de sesión con Id 132. Dado que el nombre del parámetro id. de es opcional, puede abreviar este comando como el siguiente: Invoke-History 132, ihy 132o r 132.

Invoke-History -Id 132

Ejemplo 3: Ejecutar el comando más reciente mediante el texto del comando

En este ejemplo se ejecuta el comando Get-Process más reciente en el historial de sesiones. Al escribir caracteres para el parámetro id. de , Invoke-History ejecuta el primer comando que encuentra que coincide con el patrón, empezando por los comandos más recientes.

Invoke-History -Id get-pr

Nota:

La coincidencia de patrones no distingue mayúsculas de minúsculas, pero el patrón coincide con el principio de la línea.

Ejemplo 4: Ejecución de una secuencia de comandos desde el historial

En este ejemplo se ejecutan los comandos de 16 a 24. Dado que solo puede enumerar un valor de Id, el comando usa el cmdlet ForEach-Object para ejecutar el comando Invoke-History una vez para cada valor Id.

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

Ejemplo 5

En este ejemplo se ejecutan los siete comandos del historial que terminan con el comando 255 (de 249 a 255). Usa el cmdlet Get-History para recuperar los comandos. Dado que solo puede enumerar un valor de Id de , el comando usa el cmdlet ForEach-Object para ejecutar el comando Invoke-History una vez por cada valor de Id .

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

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Id

Especifica el ID de un comando en el historial. Puede escribir el número de identificación Id del comando o los primeros caracteres del mismo.

Si escribe caracteres, Invoke-History coincide primero con los comandos más recientes. Si omite este parámetro, Invoke-History ejecuta el comando último o más reciente. Para encontrar el número de identificación Id de un comando, use el cmdlet Get-History.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

Puede canalizar un historial Id a este cmdlet.

Salidas

None

Este cmdlet no devuelve ninguna salida propia, pero los comandos que ejecuta pueden devolver su propia salida.

Notas

PowerShell incluye los siguientes alias para Invoke-History:

  • Todas las plataformas:
    • ihy
    • r

El historial de sesiones es una lista de los comandos especificados durante la sesión. El historial de sesiones representa el orden de ejecución, el estado y las horas de inicio y finalización del comando. Al escribir cada comando, PowerShell lo agrega al historial para que pueda reutilizarlo. Para obtener más información sobre el historial de sesiones, consulte about_History.