Get-History
Obtém uma lista dos comandos inseridos durante a sessão atual.
Sintaxe
Get-History [[-Id] <Int64[]>] [[-Count] <int>] [<CommonParameters>]
Descrição
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 Windows PowerShell mantém automaticamente um histórico de cada sessão. Você pode salvar o histórico da sessão em 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.
Parâmetros
-Count <int>
Exibe o número especificado das entradas mais recentes do histórico. O padrão é 32. Se você usar os parâmetros Count e Id em um comando, a exibição terminará com o comando especificado pelo parâmetro Id.
Necessário? |
false |
Posição? |
2 |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Id <Int64[]>
Especifica o número de ID de um comando no histórico da sessão. Get-History obtém apenas o comando especificado. Se você utilizar Id e Count, Get-History obterá os comandos mais recentes que terminam com o comando especificado pelo parâmetro Id.
Necessário? |
false |
Posição? |
1 |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByValue) |
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
Entradas |
Int64 Você pode canalizar uma ID de histórico para Get-History. |
Saídas |
Microsoft.PowerShell.Commands.HistoryInfo Get-History retorna um objeto de histórico para cada item de histórico que obtém. |
Observações
O histórico da sessão é uma lista dos comandos inseridos durante a sessão junto com a ID. 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 Windows 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.
Você também pode se referir a Get-History utilizando seus aliases internos, "h", "history" e "ghy". Para obter mais informações, consulte about_Aliases.
Exemplo 1
C:\PS>get-history
Descrição
-----------
Esse comando obtém os 32 comandos enviados mais recentemente. A exibição padrão mostra cada comando e seu ID, o que indica a ordem de execução.
Exemplo 2
C:\PS>get-history | where-object {$_.commandLine -like "*service*"}
Descrição
-----------
Esse comando obtém entradas do histórico de comando que inclui a palavra "service". O primeiro comando obtém as 32 entradas mais recentes 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 "service".
Exemplo 3
C:\PS>get-history -id 7 -count 5 | export-csv history.csv
Descrição
-----------
Esse comando obtém as cinco entradas do 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írgula 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, incluindo o status e os horários de início e término do comando.
Exemplo 4
C:\PS>get-history -count 1
Descrição
-----------
Esse comando obtém o último comando (inserido mais recentemente) do histórico de comando. Ele utiliza o parâmetro Count para exibir apenas um comando. Por padrão, Get-History exibe os comandos mais recentes. Esse comando pode ser abreviado para "h -c 1" e é equivalente a pressionar a tecla de seta para cima.
Exemplo 5
C:\PS>get-history -count $MaximumHistoryCount
Descrição
-----------
Esse comando exibe todos os comandos salvos no histórico da sessão. Por padrão, $MaximumHistoryCount é 64, portanto esse comando pode ser abreviado como "h -c 64".
Exemplo 6
C:\PS>get-history | format-list
Descrição
-----------
Esse comando exibe todas as propriedades de entradas no histórico da sessão. O operador de pipeline (|) passa o resultado para o cmdlet Format-List, o qual exibe todas as propriedades de cada entrada do histórico, incluindo o ID, o status e os horários de início e término do comando.