Invoke-History
Executa comandos do histórico de sessões.
Sintaxe
Default (Predefinição)
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 o número de ID . Para localizar o número de identificação de um comando, use o cmdlet Get-History.
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 onde PSReadLine é carregado. Este 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 do histórico
Este exemplo executa o último comando, ou o mais recente, no histórico da sessão. Você pode abreviar este comando como r, o alias para Invoke-History.
Invoke-History
Exemplo 2: Execute o comando que tem uma ID especificada
Este exemplo 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.
Invoke-History -Id 132
Exemplo 3: Execute o comando mais recente usando o texto do comando
Este exemplo 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 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 a partir do histórico
Este exemplo executa os comandos 16 a 24. Como pode listar apenas um Id , o comando usa o cmdlet ForEach-Object para executar o comando Invoke-History uma vez para cada 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. Pode-se listar apenas um valor de Id, portanto, o comando utiliza o cmdlet ForEach-Object para executar o comando Invoke-History uma vez para cada valor de Id .
Get-History -Id 255 -Count 7 | ForEach {Invoke-History -Id $_.Id}
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Id
Especifica o ID de um comando no histórico. Você pode digitar o Id número 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.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 transmitir um histórico Id para este cmdlet.
Saídas
None
Esse cmdlet não gera nenhuma saída, mas a saída pode ser gerada pelos comandos executados Invoke-History .
Notas
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 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.