Compartilhar via

Get-History

Módulo:
Microsoft.PowerShell.Core Module

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

Sintaxe

Default (Default) 

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

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 .

Propriedades do parâmetro

Tipo:

Int64[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

Int64

Você pode encaminhar um 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 recebe.

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.