Invoke-History

  • Referência
Módulo:
Microsoft.PowerShell.Core

Executa comandos do histórico de sessão.

Sintaxe

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

Description

O Invoke-History cmdlet executa comandos do histórico da sessão. Você pode passar objetos que representam os comandos de Get-History para Invoke-History, ou pode identificar comandos no histórico atual usando seu número de ID . Para localizar o número de identificação de um comando, use o Get-History cmdlet.

O histórico da sessão é gerenciado separadamente do histórico mantido pelo módulo PSReadLine . Ambos os históricos estão disponíveis em sessões em que PSReadLine é carregado. Esse cmdlet só funciona com o histórico da sessão. Para obter mais informações, consulte about_PSReadLine.

Exemplos

Exemplo 1: Executar o comando mais recente no histórico

Este exemplo executa o último comando ou o mais recente no histórico da sessão. Você pode abreviar esse comando como r, o alias para Invoke-History.

Invoke-History

Exemplo 2: Executar o comando que tem uma ID especificada

Este exemplo executa o comando no histórico da sessão com o Id 132. Como o nome do parâmetro Id é opcional, você pode abreviar esse comando da seguinte forma: Invoke-History 132, ihy 132, ou r 132.

Invoke-History -Id 132

Exemplo 3: Executar o comando mais recente usando o texto do comando

Este exemplo executa o comando mais recente Get-Process no histórico da sessão. Quando você digita caracteres para o parâmetro Id , Invoke-History executa o primeiro comando que ele encontra que corresponde ao padrão, começando com os comandos mais recentes.

Invoke-History -Id get-pr

Observação

A correspondência de padrões não diferencia maiúsculas de minúsculas, mas o padrão corresponde ao início da linha.

Exemplo 4: Executar uma sequência de comandos do histórico

Este exemplo executa os comandos 16 a 24. Como você pode listar apenas um valor de Id , o comando usa o ForEach-Object cmdlet para executar o Invoke-History comando uma vez para cada valor de Id .

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

Exemplo 5

Este exemplo executa os sete comandos no histórico que terminam com o comando 255 (249 a 255). Ele usa o Get-History cmdlet para recuperar os comandos. Como você pode listar apenas um valor de Id , o comando usa o ForEach-Object cmdlet para executar o Invoke-History comando uma vez para cada valor de Id .

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

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica a ID de um comando no histórico. Você pode digitar o número de ID do comando ou os primeiros caracteres do comando.

Se você digitar caracteres, corresponderá Invoke-History aos comandos mais recentes primeiro. Se você omitir esse parâmetro, Invoke-History executará o último comando ou o mais recente. Para localizar o número de ID de um comando, use o Get-History cmdlet.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Você pode canalizar uma ID de histórico para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída própria, mas os comandos que ele executa podem retornar sua própria saída.

Observações

O PowerShell inclui os seguintes aliases para Invoke-History:

  • Todas as plataformas:
    • ihy
    • r

O histórico da sessão é uma lista dos comandos inseridos durante a sessão. O histórico da sessão representa a ordem de execução, o status e os horários de início e término do comando. À medida que você insere cada comando, o PowerShell o adiciona ao histórico para que você possa reutilizá-lo. Para obter mais informações sobre o histórico da sessão, consulte about_History.