Compartilhar via

Get-History

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

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

Syntax

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 variável de $MaximumHistoryCount 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 onde o 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 o serviço.

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

Exemplo 3: Exportar entradas do histórico até uma ID específica

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 que são exibidos quando você formata o histórico como uma lista. Isso inclui o status e as horas 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 as horas de início e término do comando.

Get-History | Format-List -Property *

Parâmetros

-Count

Especifica o número das 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.

Type:Int32
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica uma matriz dos IDs das 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 .

Type:Int64[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 que ele obtém.

Observações

O PowerShell inclui os seguintes aliases para Get-History:

  • Todas as plataformas:
    • 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 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 de comandos, consulte about_History.

A partir do Windows PowerShell 3.0, o $MaximumHistoryCount valor padrão da variável de 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.