Condividi tramite

Get-History

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

Ottiene un elenco dei comandi immessi durante la sessione corrente.

Sintassi

Get-History
   [[-Id] <Int64[]>]
   [[-Count] <Int32>]
   [<CommonParameters>]

Descrizione

Il Get-History cmdlet ottiene la cronologia delle sessioni, ovvero l'elenco dei comandi immessi durante la sessione corrente.

PowerShell mantiene automaticamente una cronologia di ogni sessione. Il numero di voci nella cronologia delle sessioni è determinato dal valore della $MaximumHistoryCount variabile di preferenza. A partire da Windows PowerShell 3.0, il valore predefinito è 4096. Per impostazione predefinita, i file di cronologia vengono salvati nella home directory, ma è possibile salvarli in qualsiasi percorso. Per altre informazioni sulle funzionalità della cronologia in PowerShell, vedere about_History.

La cronologia delle sessioni viene gestita separatamente dalla cronologia gestita dal modulo PSReadLine . Entrambe le cronologie sono disponibili nelle sessioni in cui viene caricato PSReadLine . Questo cmdlet funziona solo con la cronologia delle sessioni. Per altre informazioni, vedere about_PSReadLine.

Esempio

Esempio 1: Ottenere la cronologia della sessione

In questo esempio vengono recuperate le voci nella cronologia delle sessioni. La visualizzazione predefinita mostra ogni comando e il relativo ID, che indica l'ordine in cui sono stati eseguiti.

Get-History

Esempio 2: Ottenere voci che includono una stringa

In questo esempio vengono recuperate le voci nella cronologia dei comandi che includono il servizio stringa. Il primo comando ottiene tutte le voci della cronologia della sessione. L'operatore pipeline (|) passa i risultati al Where-Object cmdlet , che seleziona solo i comandi che includono il servizio.

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

Esempio 3: Esportare voci della cronologia fino a un ID specifico

In questo esempio vengono recuperate le cinque voci di cronologia più recenti che terminano con la voce 7. L'operatore pipeline passa il risultato al Export-Csv cmdlet , che formatta la cronologia come testo delimitato da virgole e lo salva nel file History.csv. Il file include i dati visualizzati quando si formatta la cronologia come elenco. Sono inclusi lo stato e l'ora di inizio e fine del comando.

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

Esempio 4: Visualizzare il comando più recente

Questo esempio ottiene l'ultimo comando nella cronologia dei comandi. L'ultimo comando è il comando immesso più di recente. Questo comando usa il parametro Count per visualizzare un solo comando. Per impostazione predefinita, Get-History ottiene i comandi più recenti. Questo comando può essere abbreviato in "h -c 1" ed equivale a premere la freccia SU.

Get-History -Count 1

Esempio 5: Visualizzare tutte le proprietà delle voci nella cronologia

In questo esempio vengono visualizzate tutte le proprietà delle voci nella cronologia delle sessioni. L'operatore pipeline passa i risultati di un Get-History comando al Format-List cmdlet , che visualizza tutte le proprietà di ogni voce di cronologia. Sono inclusi l'ID, lo stato e l'ora di inizio e fine del comando.

Get-History | Format-List -Property *

Parametri

-Count

Specifica il numero delle voci di cronologia più recenti recuperate da questo cmdlet. Per impostazione predefinita, Get-History ottiene tutte le voci nella cronologia delle sessioni. Se si usano entrambi i parametri Count e Id in un comando, la visualizzazione termina con il comando specificato dal parametro Id .

In Windows PowerShell 2.0, per impostazione predefinita, Get-History ottiene le 32 voci più recenti.

Tipo:Int32
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specifica una matrice degli ID delle voci nella cronologia delle sessioni. Get-History ottiene solo le voci specificate. Se si usano entrambi i parametri Id e Count in un comando, Get-History ottiene le voci più recenti che terminano con la voce specificata dal parametro Id .

Tipo:Int64[]
Posizione:0
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

Int64

È possibile inviare tramite pipe un ID cronologia a questo cmdlet.

Output

HistoryInfo

Questo cmdlet restituisce un oggetto cronologia per ogni elemento della cronologia che ottiene.

Note

Windows PowerShell include gli alias seguenti per Get-History:

  • h
  • history
  • ghy

La cronologia della sessione è un elenco dei comandi immessi durante la sessione. La cronologia della sessione rappresenta l'ordine di esecuzione, lo stato e l'ora di inizio e fine del comando. Quando si immette ogni comando, PowerShell lo aggiunge alla cronologia in modo da poterlo riutilizzare. Per altre informazioni sulla cronologia dei comandi, vedere about_History.

A partire da Windows PowerShell 3.0, il valore predefinito della $MaximumHistoryCount variabile di preferenza è 4096. In Windows PowerShell 2.0 il valore predefinito è 64. Per altre informazioni sulla $MaximumHistoryCount variabile, vedere about_Preference_Variables.