Partilhar via

Invoke-History

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

Executa comandos do histórico de sessões.

Sintaxe

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

Description

O cmdlet Invoke-History 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 cmdlet Get-History.

Exemplos

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

PS C:\> Invoke-History

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

Exemplo 2: Execute o comando que tem uma ID especificada

PS C:\> Invoke-History -Id 132

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

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

PS C:\> Invoke-History -ID get-pr

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

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

PS C:\> 16..24 | ForEach {Invoke-History -Id $_ }

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

Exemplo 5

PS C:\> Get-History -Id 255 -Count 7 | ForEach {Invoke-History -Id $_.Id}

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

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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, Invoke-History corresponderá primeiro aos comandos mais recentes. 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 cmdlet Get-History.

Tipo:String
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

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

Saídas

None

Este cmdlet não gera nenhuma saída, mas a saída pode ser gerada pelos comandos que Invoke-History executa.

Notas

  • O histórico da sessão é uma lista dos comandos inseridos durante a sessão, juntamente com o ID. O histórico da sessão representa a ordem de execução, o status e as horas 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.

  • Você também pode se referir a Invoke-History por seus aliases internos, r e ihy. Para obter mais informações, consulte about_Aliases.