Get-History

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

Obtém uma lista dos comandos inseridos durante a sessão atual.

Sintaxe

Get-History
   [[-Id] <Int64[]>]
   [[-Count] <Int32>]
   [<CommonParameters>]

Description

O Get-History cmdlet obtém o histórico da sessão, ou seja, a lista de comandos inseridos durante a sessão atual.

O PowerShell mantém automaticamente um histórico de cada sessão. O número de entradas no histórico da sessão é determinado pelo valor da $MaximumHistoryCount variável de preferência. A partir do Windows PowerShell 3.0, o valor padrão é 4096. Por padrão, os arquivos de histórico são salvos na pasta raiz, mas você pode salvá-lo em qualquer local. Para obter mais informações sobre os recursos de histórico no PowerShell, consulte about_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 em que PSReadLine é carregado. Esse cmdlet só funciona com o histórico da sessão. Para obter mais informações, consulte about_PSReadLine.

Exemplos

Exemplo 1: Obter o histórico da sessão

Este exemplo obtém as entradas no histórico da sessão. A exibição padrão mostra cada comando e sua ID, que indica a ordem em que eles foram executados.

Get-History

Exemplo 2: Obter entradas que incluem uma cadeia de caracteres

Este exemplo obtém entradas no histórico de comandos que incluem o serviço de cadeia de caracteres. O primeiro comando obtém todas as entradas no histórico da sessão. O operador de pipeline (|) passa os resultados para o Where-Object cmdlet, que seleciona apenas os comandos que incluem service.

Get-History | Where-Object {$_.CommandLine -like "*Service*"}

Exemplo 3: Exportar entradas do histórico para um ID específico

Este exemplo obtém as cinco entradas de histórico mais recentes que terminam com a entrada 7. O operador de pipeline passa o resultado para o Export-Csv cmdlet, que formata o histórico como texto separado por vírgulas e o salva no arquivo History.csv. O arquivo inclui os dados exibidos quando você formata o histórico como uma lista. Isso inclui o status e os horários de início e término do comando.

Get-History -ID 7 -Count 5 | Export-Csv -Path History.csv

Exemplo 4: Exibir o comando mais recente

Este exemplo obtém o último comando no histórico de comandos. O último comando é o comando inserido mais recentemente. Esse comando usa o parâmetro Count para exibir apenas um comando. Por padrão, Get-History obtém os comandos mais recentes. Este comando pode ser abreviado como "h - c 1" e é equivalente a pressionar a tecla de seta para cima.

Get-History -Count 1

Exemplo 5: Exibir todas as propriedades das entradas no histórico

Este exemplo exibe todas as propriedades das entradas no histórico da sessão. O operador de pipeline passa os resultados de um Get-History comando para o Format-List cmdlet, que exibe todas as propriedades de cada entrada de histórico. Isso inclui a ID, o status e os horários de início e término do comando.

Get-History | Format-List -Property *

Parâmetros

-Count

Especifica o número de entradas de histórico mais recentes que esse cmdlet obtém. Por padrão, Get-History obtém todas as entradas no histórico da sessão. Se você usar os parâmetros Count e Id em um comando, a exibição terminará com o comando especificado pelo parâmetro Id .

No Windows PowerShell 2.0, por padrão, Get-History obtém as 32 entradas mais recentes.

Tipo:Int32
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica uma matriz de IDs de entradas no histórico da sessão. Get-History obtém apenas entradas especificadas. Se você usar os parâmetros Id e Count em um comando, Get-History obterá as entradas mais recentes que terminam com a entrada especificada pelo parâmetro Id .

Tipo:Int64[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

Int64

Você pode canalizar uma ID de histórico para esse cmdlet.

Saídas

HistoryInfo

Esse cmdlet retorna um objeto de histórico para cada item de histórico obtido.

Observações

O Windows PowerShell inclui os seguintes aliases para Get-History:

  • h
  • history
  • ghy

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 de comandos, consulte about_History.

A partir do Windows PowerShell 3.0, o valor padrão da variável de $MaximumHistoryCount preferência é 4096. No Windows PowerShell 2.0, o valor padrão é 64. Para obter mais informações sobre a variável $MaximumHistoryCount, consulte about_Preference_Variables.