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í PowerShellu pro aktuální relaci. Můžete získat všechny události nebo můžete k určení událostí použít parametr EventIdentifier nebo SourceIdentifier .

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í PowerShellu. K získání událostí můžete použít Get-Event nebo Wait-Event je získat.

Tato rutina nezískáte události z protokolů Prohlížeč událostí. Chcete-li tyto události získat, 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 $Events proměnné.

Druhý příkaz používá maticový zápis k získání první události (0-index) v matici v $Events proměnné. Příkaz pomocí operátoru kanálu (|) odešle událost Format-List do příkazu, 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, který byl vygenerován.

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

Do této rutiny nemůžete roušit objekty.

Výstupy

PSEventArgs

Tato rutina 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

Na platformách Linux nebo macOS nejsou dostupné žádné zdroje událostí.

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 $Sender Action obsahuje 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 $EventArgs Action obsahuje automatická proměnná tuto hodnotu.

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

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

  • TimeGenerated. A DateTime objekt, který představuje čas, kdy byla událost vygenerována. V hodnotě action parametru TimeGenerated vlastnost $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ě action parametru MessageData vlastnost $Event automatické proměnné obsahuje tuto hodnotu.