Sdílet prostřednictvím

Get-Event

  • Reference
Modul:
Microsoft.PowerShell.Utility

Získá události ve frontě událostí.

Syntaxe

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

Description

Rutina Get-Event získá události ve frontě událostí Windows PowerShellu pro aktuální relaci. Můžete získat všechny události nebo použít EventIdentifier nebo SourceIdentifier parametr k určení událostí.

Když dojde k události, přidá se do fronty událostí. Fronta událostí obsahuje události, pro které jste zaregistrovali, události vytvořené pomocí rutiny New-Event a událost, která se vyvolá při ukončení Windows PowerShellu. K získání událostí můžete použít Get-Event nebo Wait-Event.

Tato rutina nezískáte události z protokolů Prohlížeče událostí. K získání těchto událostí použijte Get-WinEvent nebo Get-EventLog.

Příklady

Příklad 1: Získání všech událostí

PS C:\> Get-Event

Tento příkaz získá všechny události ve frontě událostí.

Příklad 2: Získání událostí podle identifikátoru zdroje

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

Tento příkaz získá události, ve kterých hodnota SourceIdentifier vlastnost je PowerShell.ProcessCreated.

Příklad 3: Získání události na základě času, kdy byla vygenerována

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      :

Tento příklad ukazuje, jak získat události pomocí jiných vlastností než SourceIdentifier.

První příkaz získá všechny události ve frontě událostí a uloží je do proměnné $Events.

Druhý příkaz používá maticový zápis k získání první události (0-index) v poli v proměnné $Events. Příkaz pomocí operátoru kanálu (|) odešle událost do příkazu Format-List, který zobrazí všechny vlastnosti události v seznamu. To vám umožní prozkoumat vlastnosti objektu události.

Třetí příkaz ukazuje, jak pomocí rutiny Where-Object získat událost na základě času, kdy byla vygenerována.

Příklad 4: Získání události podle jeho identifikátoru

PS C:\> Get-Event -EventIdentifier 2

Tento příkaz získá událost s identifikátorem události 2.

Parametry

-EventIdentifier

Určuje identifikátory událostí, pro které tato rutina získává události.

Typ:Int32
Aliasy:Id
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-SourceIdentifier

Určuje identifikátory zdroje, pro které tato rutina získává události. Výchozí hodnota je všechny události ve frontě událostí. Zástupné dokumentace nejsou povoleny.

Typ:String
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

None

Vstup do této rutiny nelze převést.

Výstupy

PSEventArgs

Get-Event vrátí objekt PSEventArgs pro každou událost. Pokud chcete zobrazit popis tohoto objektu, zadejte Get-Help Get-Event -Full a podívejte se do části Poznámky tématu nápovědy.

Poznámky

  • Události, odběry událostí a fronta událostí existují pouze v aktuální relaci. Pokud zavřete aktuální relaci, fronta událostí se zahodí a odběr události se zruší.

    Rutina Get-Event vrátí objekt PSEventArgs (System.Management.Automation.PSEventArgs) s následujícími vlastnostmi:

    • Název_počítače. Název počítače, na kterém došlo k události. Tato hodnota vlastnosti se naplní pouze v případě, že se událost přeposílala ze vzdáleného počítače.

    • RunspaceId. Identifikátor GUID, který jednoznačně identifikuje relaci, ve které došlo k události. Tato hodnota vlastnosti se naplní pouze v případě, že se událost přeposílala ze vzdáleného počítače.

    • EventIdentifier. Celé číslo (Int32), které jednoznačně identifikuje oznámení události v aktuální relaci.

    • Odesílatel. Objekt, který událost vygeneroval. V hodnotě parametru Action obsahuje $Sender automatická proměnná objekt odesílatele.

    • SourceEventArgs. První parametr, který je odvozen z EventArgs, pokud existuje. Například v časovači uplynulé události, ve které má podpis formulář Object sender, Timers.ElapsedEventArgs e, SourceEventArgs vlastnost by obsahovala Timers.ElapsedEventArgs. V hodnotě parametru Action obsahuje tato hodnota $EventArgs automatická proměnná.

    • SourceArgs. Všechny parametry původního podpisu události. U standardního podpisu události představuje $Args[0] odesílatele a $Args[1] představuje sourceEventArgs. V hodnotě parametru Action obsahuje tato hodnota $Args automatická proměnná.

    • SourceIdentifier. Řetězec, který identifikuje odběr události. V hodnotě Action parametru SourceIdentifier $Event automatická proměnná obsahuje tuto hodnotu.

    • TimeGenerated. Objekt DateTime, který představuje čas vygenerování události. V hodnotě Action parametru TimeGenerated $Event automatická proměnná obsahuje tuto hodnotu.

    --MessageData. Data přidružená k odběru událostí Uživatelé tato data zadají při registraci události. V hodnotě parametru Action vlastnost MessageData $Event automatické proměnné obsahuje tuto hodnotu.