Compartilhar via

Invoke-History

Módulo:
Microsoft.PowerShell.Core Module

Executa comandos do histórico da sessão.

Sintaxe

Default (Padrão) 

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, confira 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-Object {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-Object {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 retorna nenhuma saída própria, mas os comandos executados podem retornar sua própria saída.

Observações

O PowerShell inclui os seguintes aliases para Invoke-History:

  • Todas as plataformas:
    • ihy
    • r

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.