Get-Event

  • Referentie
Module:
Microsoft.PowerShell.Utility

Haalt de gebeurtenissen op in de gebeurteniswachtrij.

Syntax

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

Description

De Get-Event cmdlet haalt gebeurtenissen op in de PowerShell-gebeurteniswachtrij voor de huidige sessie. U kunt alle gebeurtenissen ophalen of de parameter EventIdentifier of SourceIdentifier gebruiken om de gebeurtenissen op te geven.

Wanneer een gebeurtenis plaatsvindt, wordt deze toegevoegd aan de gebeurteniswachtrij. De gebeurteniswachtrij bevat gebeurtenissen waarvoor u zich hebt geregistreerd, gebeurtenissen die zijn gemaakt met behulp van de New-Event cmdlet en de gebeurtenis die wordt gegenereerd wanneer PowerShell wordt afgesloten. U kunt de gebeurtenissen gebruiken Get-Event of Wait-Event ophalen.

Met deze cmdlet worden geen gebeurtenissen opgehaald uit de Logboeken-logboeken. Als u deze gebeurtenissen wilt ophalen, gebruikt Get-WinEvent u of Get-EventLog.

Voorbeelden

Voorbeeld 1: Alle gebeurtenissen ophalen

PS C:\> Get-Event

Met deze opdracht worden alle gebeurtenissen in de gebeurteniswachtrij opgehaald.

Voorbeeld 2: Gebeurtenissen ophalen op bron-id

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

Met deze opdracht worden gebeurtenissen opgehaald waarin de waarde van de eigenschap SourceIdentifier PowerShell.ProcessCreated is.

Voorbeeld 3: Een gebeurtenis ophalen op basis van de tijd waarop deze is gegenereerd

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 dit voorbeeld ziet u hoe u gebeurtenissen kunt ophalen met behulp van andere eigenschappen dan SourceIdentifier.

Met de eerste opdracht worden alle gebeurtenissen in de gebeurteniswachtrij opgehaald en opgeslagen in de $Events variabele.

De tweede opdracht maakt gebruik van matrix-notatie om de eerste gebeurtenis (0-index) op te halen in de matrix in de $Events variabele. De opdracht maakt gebruik van een pijplijnoperator (|) om de gebeurtenis naar de Format-List opdracht te verzenden, waarin alle eigenschappen van de gebeurtenis in een lijst worden weergegeven. Hiermee kunt u de eigenschappen van het gebeurtenisobject onderzoeken.

De derde opdracht laat zien hoe u de Where-Object cmdlet gebruikt om een gebeurtenis op te halen op basis van het tijdstip waarop deze is gegenereerd.

Voorbeeld 4: Een gebeurtenis ophalen op de id

PS C:\> Get-Event -EventIdentifier 2

Met deze opdracht wordt de gebeurtenis met een gebeurtenis-id van 2 geretourneerd.

Parameters

-EventIdentifier

Hiermee geeft u de gebeurtenis-id's waarvoor deze cmdlet gebeurtenissen ophaalt.

Type:Int32
Aliases:Id
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SourceIdentifier

Hiermee geeft u bron-id's op waarvoor deze cmdlet gebeurtenissen ophaalt. De standaardwaarde is alle gebeurtenissen in de gebeurteniswachtrij. Jokertekens zijn niet toegestaan.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

PSEventArgs

Deze cmdlet retourneert een PSEventArgs-object voor elke gebeurtenis. Als u een beschrijving van dit object wilt zien, typt Get-Help Get-Event -Full u de sectie Notities van het Help-onderwerp.

Notities

Er zijn geen gebeurtenisbronnen beschikbaar op de Linux- of macOS-platforms.

Gebeurtenissen, gebeurtenisabonnementen en de gebeurteniswachtrij bestaan alleen in de huidige sessie. Als u de huidige sessie sluit, wordt de gebeurteniswachtrij verwijderd en wordt het gebeurtenisabonnement geannuleerd.

De Get-Event cmdlet retourneert een PSEventArgs-object (System.Management.Automation.PSEventArgs) met de volgende eigenschappen:

  • Computernaam. De naam van de computer waarop de gebeurtenis heeft plaatsgevonden. Deze eigenschapswaarde wordt alleen ingevuld wanneer de gebeurtenis wordt doorgestuurd vanaf een externe computer.

  • RunspaceId. Een GUID die de sessie waarin de gebeurtenis is opgetreden, uniek identificeert. Deze eigenschapswaarde wordt alleen ingevuld wanneer de gebeurtenis wordt doorgestuurd vanaf een externe computer.

  • EventIdentifier. Een geheel getal (Int32) dat de gebeurtenismelding uniek identificeert in de huidige sessie.

  • Afzender. Het object dat de gebeurtenis heeft gegenereerd. In de waarde van de parameter Actie bevat de $Sender automatische variabele het afzenderobject.

  • SourceEventArgs. De eerste parameter die is afgeleid van EventArgs, als deze bestaat. In een timer die bijvoorbeeld is verstreken, waarin de handtekening de afzender van het formulierobject heeft, bevat Timers.ElapsedEventArgs e, bevat de eigenschap SourceEventArgs de eigenschap Timers.ElapsedEventArgs. In de waarde van de parameter Actie bevat de $EventArgs automatische variabele deze waarde.

  • SourceArgs. Alle parameters van de oorspronkelijke gebeurtenishandtekening. Voor een standaard gebeurtenishandtekening $Args[0] vertegenwoordigt u de afzender en $Args[1] vertegenwoordigt u de SourceEventArgs. In de waarde van de parameter Actie bevat de $Args automatische variabele deze waarde.

  • SourceIdentifier. Een tekenreeks die het gebeurtenisabonnement identificeert. In de waarde van de parameter Action bevat de eigenschap SourceIdentifier van de $Event automatische variabele deze waarde.

  • TimeGenerated. Een DateTime-object dat het tijdstip aangeeft waarop de gebeurtenis is gegenereerd. In de waarde van de parameter Action bevat de eigenschap TimeGenerated van de $Event automatische variabele deze waarde.

  • MessageData. Gegevens die zijn gekoppeld aan het gebeurtenisabonnement. Gebruikers geven deze gegevens op wanneer ze een gebeurtenis registreren. In de waarde van de parameter Action bevat de eigenschap MessageData van de $Event automatische variabele deze waarde.