Partilhar via

Invoke-History

  • Referência
Módulo:
Microsoft.PowerShell.Core

Executa comandos a partir do histórico de sessões.

Syntax

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

Description

O Invoke-History cmdlet executa comandos do histórico de sessões. Pode transmitir objetos que representam os comandos de Get-History para Invoke-History, ou pode identificar comandos no histórico atual com o respetivo número de ID . Para localizar o número de identificação de um comando, utilize o Get-History cmdlet .

O histórico de sessões é gerido separadamente do histórico mantido pelo módulo PSReadLine . Ambos os históricos estão disponíveis em sessões em que o PSReadLine está carregado. Este cmdlet só funciona com o histórico de sessões. Para obter mais informações, veja 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 de sessões. Pode abreviar este comando como r, o alias de Invoke-History.

Invoke-History

Exemplo 2: executar o comando que tem um ID especificado

Este exemplo executa o comando no histórico de sessões com o ID 132. Uma vez que o nome do parâmetro ID é opcional, pode abreviar este comando da seguinte forma: Invoke-History 132, ihy 132ou r 132.

Invoke-History -Id 132

Exemplo 3: executar o comando mais recente com o texto do comando

Este exemplo executa o comando mais recente Get-Process no histórico de sessões. Quando escreve carateres para o parâmetro ID , Invoke-History executa o primeiro comando que localiza que corresponde ao padrão, começando pelos comandos mais recentes.

Invoke-History -Id get-pr

Nota

A correspondência de padrões não é sensível a maiúsculas e 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. Uma vez que só pode listar um valor de ID , o comando utiliza o ForEach-Object cmdlet para executar o Invoke-History comando uma 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). Utiliza o Get-History cmdlet para obter os comandos. Uma vez que só pode listar um valor de ID , o comando utiliza o ForEach-Object cmdlet para executar o Invoke-History comando uma vez para cada valor de ID .

Get-History -Id 255 -Count 7 | ForEach-Object {Invoke-History -Id $_.Id}

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica o ID de um comando no histórico. Pode escrever o número de ID do comando ou os primeiros carateres do comando.

Se escrever carateres, Invoke-History corresponde primeiro aos comandos mais recentes. Se omitir este parâmetro, Invoke-History executa o último comando ou o mais recente. Para localizar o número de ID de um comando, utilize o Get-History cmdlet .

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Pode encaminhar um ID do histórico para este cmdlet.

Saídas

None

Este cmdlet não devolve nenhuma saída própria, mas os comandos que executa podem devolver o seu próprio resultado.

Notas

O PowerShell inclui os seguintes aliases para Invoke-History:

  • Todas as plataformas:
    • ihy
    • r

O histórico de sessões é uma lista dos comandos introduzidos durante a sessão. O histórico de sessões representa a ordem de execução, o estado e as horas de início e de fim do comando. À medida que introduz cada comando, o PowerShell adiciona-o ao histórico para que possa reutilizá-lo. Para obter mais informações sobre o histórico de sessões, consulte about_History.