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 de sessão é determinado pelo valor da variável de $MaximumHistoryCount preferência. Começando no 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 de 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, o 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 de 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 exibidos quando você formata o histórico como uma lista. Isso inclui as status e as horas de início e término do comando.

Get-History -ID 7 -Count 5 | Export-Csv 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 de entradas no histórico de 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, 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 ambos os parâmetros Count e Id em um comando, a exibição é encerrada 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 das IDs de entradas no histórico de sessão. Get-History obtém apenas as 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 este 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 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. Conforme 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.

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