Get-Event

Il cmdlet Get-Event consente di ottenere eventi nella coda degli eventi di Windows PowerShell per la sessione corrente. È possibile ottenere tutti gli eventi o utilizzare i parametri EventIdentifier o SourceIdentifier per specificarne alcuni.

Quando si verifica un evento, esso viene aggiunto alla coda degli eventi. La coda degli eventi include gli eventi per i quali è stata effettuata la registrazione, gli eventi creati tramite il cmdlet New-Event e l'evento generato alla chiusura di Windows PowerShell. È possibile utilizzare Get-Event o Wait-Event per ottenere gli eventi.

Questo cmdlet non consente di ottenere eventi dai registri del Visualizzatore eventi. Per ottenere tali eventi, utilizzare Get-WinEvent o Get-EventLog.

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Gli eventi, le sottoscrizioni di eventi e la coda degli eventi esistono solo nella sessione corrente. Se si chiude la sessione corrente, la coda degli eventi viene eliminata e la sottoscrizione di eventi viene annullata.

Il cmdlet Get-Event restituisce un oggetto PSEventArgs (System.Management.Automation.PSEventArgs) con le proprietà seguenti.

-- ComputerName: il nome del computer agente nel quale si è verificato l'evento. Il valore di questa proprietà viene compilato solo quando l'evento viene inoltrato da un computer remoto.

-- RunspaceId: GUID che identifica in modo univoco la sessione nella quale si verificato l'evento. Il valore di questa proprietà viene compilato solo quando l'evento viene inoltrato da un computer remoto.

-- EventIdentifier: valore intero (Int32) che identifica in modo univoco la funzionalità di notifica degli eventi nella sessione corrente.

-- Sender: oggetto che ha generato l'evento. Nel valore del parametro Action, la variabile automatica $Sender contiene l'oggetto Sender.

-- SourceEventArgs: il primo parametro che deriva da EventArgs, se esiste. Ad esempio, in un evento Elapsed del timer in cui la firma presenta il formato "Oggetto Sender, Timers.ElapsedEventArgs e", la proprietà SourceEventArgs conterrebbe Timers.ElapsedEventArgs. Nel valore del parametro Action, la variabile automatica $SourceEventArgs contiene tale valore.

-- SourceArgs: tutti i parametri della firma dell'evento originale. Per una firma dell'evento standard, $args[0] rappresenta il mittente e $args[1] rappresenta SourceEventArgs. Nel valore del parametro Action, la variabile automatica $SourceArgs contiene tale valore.

-- SourceIdentifier: stringa che identifica la sottoscrizione di eventi. Nel valore del parametro Action, la proprietà SourceIdentifier della variabile automatica $Event contiene tale valore.

-- TimeGenerated: oggetto DateTime che rappresenta l'ora alla quale è stato generato l'evento. Nel valore del parametro Action, la proprietà TimeGenerated della variabile automatica $Event contiene tale valore.

--MessageData: dati associati alla sottoscrizione di eventi. Gli utenti specificano questi dati quando registrano un evento. Nel valore del parametro Action, la proprietà MessageData della variabile automatica $Event contiene tale valore.