Get-Event

Get-Event
    [[-SourceIdentifier] <String>]
    [<CommonParameters>]

Get-Event
    [-EventIdentifier] <Int32>
    [<CommonParameters>]

Das Cmdlet Get-Event ruft Ereignisse in der Windows PowerShell-Ereigniswarteschlange für die aktuelle Sitzung ab. Sie können alle Ereignisse abrufen oder den EventIdentifier oder SourceIdentifier Parameter verwenden, um die Ereignisse anzugeben.

Wenn ein Ereignis auftritt, wird es der Ereigniswarteschlange hinzugefügt. Die Ereigniswarteschlange enthält Ereignisse, für die Sie sich registriert haben, Ereignisse, die mit dem Cmdlet New-Event erstellt wurden, und das Ereignis, das beim Beenden von Windows PowerShell ausgelöst wird. Sie können Get-Event oder Wait-Event verwenden, um die Ereignisse abzurufen.

Dieses Cmdlet ruft keine Ereignisse aus den Ereignisanzeigeprotokollen ab. Verwenden Sie zum Abrufen dieser Ereignisse Get-WinEvent oder Get-EventLog.

PS C:\> Get-Event

Dieser Befehl ruft alle Ereignisse in der Ereigniswarteschlange ab.

PS C:\> Get-Event -SourceIdentifier "PowerShell.ProcessCreated"

Dieser Befehl ruft Ereignisse ab, in denen der Wert der SourceIdentifier-Eigenschaft "PowerShell.ProcessCreated" lautet.

PS C:\> $Events = Get-Event
PS C:\> $Events[0] | Format-List -Property *
ComputerName     :
RunspaceId       : c2153740-256d-46c0-a57c-b805917d1b7b
EventIdentifier  : 1
Sender           : System.Management.ManagementEventWatcher
SourceEventArgs  : System.Management.EventArrivedEventArgs
SourceArgs       : {System.Management.ManagementEventWatcher, System.Management.EventArrivedEventArgs}
SourceIdentifier : ProcessStarted
TimeGenerated    : 11/13/2008 12:09:32 PM
MessageData      : PS C:\> Get-Event | Where {$_.TimeGenerated -ge "11/13/2008 12:15:00 PM"}
ComputerName     :
RunspaceId       : c2153740-256d-46c0-a57c-b8059325d1a0
EventIdentifier  : 1
Sender           : System.Management.ManagementEventWatcher
SourceEventArgs  : System.Management.EventArrivedEventArgs
SourceArgs       : {System.Management.ManagementEventWatcher, System.Management.EventArrivedEventArgs}
SourceIdentifier : ProcessStarted
TimeGenerated    : 11/13/2008 12:15:00 PM
MessageData      :

In diesem Beispiel wird gezeigt, wie Ereignisse mithilfe anderer Eigenschaften als SourceIdentifier abgerufen werden.

Der erste Befehl ruft alle Ereignisse in der Ereigniswarteschlange ab und speichert sie in der Variablen $Events.

Der zweite Befehl verwendet die Array-Notation, um das erste Ereignis (0-Index) im Array in der Variablen $Events abzurufen. Der Befehl verwendet einen Pipelineoperator (|), um das Ereignis an den Befehl Format-List zu senden, der alle Eigenschaften des Ereignisses in einer Liste anzeigt. Auf diese Weise können Sie die Eigenschaften des Ereignisobjekts untersuchen.

Der dritte Befehl zeigt, wie Sie das Cmdlet Where-Object verwenden, um ein Ereignis basierend auf dem Zeitpunkt abzurufen, zu dem es generiert wurde.

PS C:\> Get-Event -EventIdentifier 2

Dieser Befehl ruft das Ereignis mit einem Ereignisbezeichner von 2 ab.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben können nicht an dieses Cmdlet weitergereicht werden.

Get-Event gibt für jedes Ereignis ein PSEventArgs-Objekt zurück. Wenn Sie eine Beschreibung dieses Objekts anzeigen möchten, geben Sie Get-Help Get-Event -Full ein, und lesen Sie den Abschnitt "Notizen" des Hilfethemas.

• Ereignisse, Ereignisabonnements und die Ereigniswarteschlange sind nur in der aktuellen Sitzung verfügbar. Wenn Sie die aktuelle Sitzung schließen, wird die Ereigniswarteschlange verworfen, und das Ereignisabonnement wird abgebrochen.

  Das Cmdlet Get-Event gibt ein PSEventArgs-Objekt (System.Management.Automation.PSEventArgs) mit den folgenden Eigenschaften zurück:

  • ComputerName. Der Name des Computers, auf dem das Ereignis aufgetreten ist. Dieser Eigenschaftswert wird nur aufgefüllt, wenn das Ereignis von einem Remotecomputer weitergeleitet wird.

  • RunspaceId. Eine GUID, die die Sitzung eindeutig identifiziert, in der das Ereignis aufgetreten ist. Dieser Eigenschaftswert wird nur aufgefüllt, wenn das Ereignis von einem Remotecomputer weitergeleitet wird.

  • EventIdentifier. Eine ganze Zahl (Int32), die die Ereignisbenachrichtigung in der aktuellen Sitzung eindeutig identifiziert.

  • Absender. Das Objekt, das das Ereignis generiert hat. Im Wert des Action-Parameters enthält die Variable $Sender automatic das Absenderobjekt.

  • SourceEventArgs. Der erste Parameter, der von EventArgs abgeleitet wird, sofern vorhanden. In einem Timer-Ablaufereignis, in dem die Signatur das Format Objektabsender Timers.ElapsedEventArgs e hat, würde die SourceEventArgs-Eigenschaft z. B. die Timers.ElapsedEventArgs enthalten. Im Wert des Action-Parameters enthält die Variable $EventArgs automatic diesen Wert.

  • SourceArgs. Alle Parameter der ursprünglichen Ereignissignatur. Bei einer Standardereignissignatur stellt $Args[0] den Absender und $Args[1] die SourceEventArgs dar. Im Wert des Action-Parameters enthält die Variable $Args automatic diesen Wert.

  • SourceIdentifier. Eine Zeichenfolge, die das Ereignisabonnement identifiziert. Im Wert des Action-Parameters enthält die SourceIdentifier-Eigenschaft der $Event automatischen Variablen diesen Wert.

  • TimeGenerated. Ein DateTime--Objekt, das die Uhrzeit darstellt, zu der das Ereignis generiert wurde. Im Wert des Action-Parameters enthält die TimeGenerated-Eigenschaft der $Event automatischen Variablen diesen Wert.

  --MessageData. Daten, die dem Ereignisabonnement zugeordnet sind. Benutzer geben diese Daten an, wenn sie ein Ereignis registrieren. Im Wert des Action-Parameters enthält die MessageData-Eigenschaft der $Event automatischen Variablen diesen Wert.