Invoke-History
Executa comandos do histórico da sessão.
Sintaxe
Default (Default)
Invoke-History
[[-Id] <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Invoke-History executa comandos do histórico de sessão. Você pode passar objetos que representam os comandos de Get-History para Invoke-Historyou identificar comandos no histórico atual usando o número de ID . Para localizar o número de identificação de um comando, use o cmdlet Get-History.
O histórico de sessão é gerenciado separadamente do histórico mantido pelo módulo PSReadLine. Os dois históricos estão disponíveis nas sessões em que se carrega PSReadLine. Esse cmdlet funciona apenas 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 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
Esse exemplo executa o comando no histórico de sessão com Id 132. Como o nome do parâmetro ID é opcional, você pode abreviar esse comando como o seguinte: Invoke-History 132, ihy 132ou r 132.
Invoke-History -Id 132
Exemplo 3: executar o comando mais recente usando o texto de comando
Este exemplo executa o comando Get-Process mais recente no histórico da sessão. Quando você digita caracteres para o parâmetro de ID , Invoke-History executa o primeiro comando encontrado que corresponde ao padrão, começando com os comandos mais recentes.
Invoke-History -Id get-pr
Observação
A correspondência de padrão não faz distinção entre maiúsculas e minúsculas, mas o padrão Faz correspondência com o início da linha.
Exemplo 4: executar uma sequência de comandos do histórico
Este exemplo executa os comandos de 16 a 24. Como você pode listar apenas um valor de ID, o comando utiliza o cmdlet ForEach-Object para executar o comando Invoke-History uma única vez para cada valor de ID.
16..24 | ForEach {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 cmdlet Get-History para recuperar os comandos. Como você pode listar apenas um valor Id, o comando usa o cmdlet ForEach-Object para executar o comando Invoke-History uma vez para cada valor Id.
Get-History -Id 255 -Count 7 | ForEach {Invoke-History -Id $_.Id}
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Id
Especifica o de ID de de um comando no histórico. Você pode digitar o número de ID ou do comando ou os primeiros caracteres do comando.
Se você digitar caracteres, Invoke-History irá 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
String
Você pode redirecionar um Id de histórico para esse cmdlet.
Saídas
None
Esse cmdlet não gera nenhuma saída, mas a saída pode ser gerada pelos comandos executados Invoke-History .
Observações
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.
Você também pode consultar Invoke-History por seus aliases internos, r e ihy. Para obter mais informações, consulte about_Aliases.