Compartilhar via


Invoke-History

Executa comandos do histórico da sessão.

Sintaxe

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

Descrição

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 identificar comandos no histórico atual usando seus respectivos números de ID. Para localizar o número de identificação de um comando, use Get-History.

Parâmetros

-Id <string>

Identifica um comando no histórico da sessão. Você pode digitar o número de ID do comando ou os primeiros caracteres do comando.

Se você digitar caracteres, Invoke-History fará a correspondência com o comando mais recente primeiro. Se você omitir esse parâmetro, Invoke-History executará o último comando (mais recente). O nome do parâmetro ("id") é opcional. Para localizar o número do ID de um comando, use Get-History.

Necessário?

false

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

Nenhum

Você não pode canalizar a entrada para este cmdlet.

Saídas

Nenhum

Invoke-History não gera saída, mas a saída pode ser gerada pelos comandos executados por Invoke-History.

Observações

O histórico da sessão é uma lista dos comandos inseridos durante a sessão junto com a ID. 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 Windows 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 usando seus aliases internos, "r" e "ihy". Para obter mais informações, consulte about_Aliases.

Exemplo 1

C:\PS>invoke-history

Descrição
-----------
Esse comando executa o último comando (mais recente) do histórico da sessão. Você pode abreviar esse comando como "r" ("repeat" ou "rerun"), o alias para Invoke-History.





Exemplo 2

C:\PS>invoke-history -id 132

Descrição
-----------
Esse comando executa o comando no histórico da sessão com ID 132. Como o nome do parâmetro Id é opcional, você pode abreviar o comando como "Invoke-History 132", "ihy 132" ou "r 132".





Exemplo 3

C:\PS>invoke-history get-pr

Descrição
-----------
Esse 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 considera correspondente ao padrão, começando com os comandos mais recentes. Esse comando utiliza o parâmetro ID, mas omite o nome de parâmetro opcional.





Exemplo 4

C:\PS>invoke-history (16..24), 27

Descrição
-----------
Esse comando executa os comandos de 16 a 24 e 27. Você pode listar várias IDs e intervalos de IDs separados por vírgulas.





Exemplo 5

C:\PS>get-history -id 255 -count 7 | invoke-history

Descrição
-----------
Esse comando executa os 7 comandos do histórico que terminam com o comando 255 (geralmente e 249 a 255). Ele usa o cmdlet Get-History para recuperar os comandos. O operador de pipeline (|) passa os comandos para Invoke-History, que os executa.





Consulte também

Conceitos

about_History
Get-History
Add-History
Clear-History