Compartilhar via

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 cmdlet Get-History 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 preferência $MaximumHistoryCount. A partir do Windows PowerShell 3.0, o valor padrão é 4096.

Você pode salvar o histórico de sessão no formato XML ou CSV. Por padrão, os arquivos de histórico são salvos no diretório inicial, mas você pode salvar o arquivo em qualquer local.

Para obter mais informações sobre os recursos de histórico no PowerShell, consulte about_History no Microsoft Docs.

Exemplos

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

Get-History

Esse comando 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.

Exemplo 2: Obter entradas que incluem uma cadeia de caracteres

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

Esse comando 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 cmdlet Where-Object, que seleciona apenas os comandos que incluem o serviço.

Exemplo 3: exportar no máximo sete entradas

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

Esse comando 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 cmdlet Export-Csv, 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 os horários de status e início e término do comando.

Exemplo 4: Exibir o comando mais recente

Get-History -Count 1

Esse comando 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. Esse comando pode ser abreviado como "h -c 1" e é equivalente a pressionar a tecla de seta para cima.

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

Get-History | Format-List -Property *

Esse comando exibe todas as propriedades das entradas no histórico de sessão. O operador de pipeline passa os resultados de um comando Get-History para o cmdlet Format-List, 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.

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 de Contagem de e 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 de sessão. get-history obtém apenas as entradas especificadas. Se você usar os parâmetros de ID de e Contar em um comando, obter as entradas mais recentes que terminam com a entrada especificada pelo parâmetro de ID de .

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 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 de 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 preferência $MaximumHistoryCount é 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.