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.