Get-Event
Lekéri az eseményeket az eseménysoron.
Syntax
Get-Event
[[-SourceIdentifier] <String>]
[<CommonParameters>]
Get-Event
[-EventIdentifier] <Int32>
[<CommonParameters>]
Description
A Get-Event
parancsmag lekéri az aktuális munkamenet PowerShell-eseménysorában lévő eseményeket. Lekérheti az összes eseményt, vagy az EventIdentifier vagy a SourceIdentifier paraméter használatával megadhatja az eseményeket.
Amikor egy esemény bekövetkezik, a rendszer hozzáadja azt az eseménysorhoz. Az eseménysor tartalmazza azokat az eseményeket, amelyekre regisztrált, a New-Event
parancsmag használatával létrehozott eseményeket, valamint a PowerShell kilépésekor létrejött eseményt. Használhatja Get-Event
vagy Wait-Event
lekérheti az eseményeket.
Ez a parancsmag nem kap eseményeket a Eseménynapló naplókból. Az események lekéréséhez használja Get-WinEvent
vagy Get-EventLog
.
Példák
1. példa: Az összes esemény lekérése
PS C:\> Get-Event
Ez a parancs lekéri az eseménysor összes eseményét.
2. példa: Események lekérése forrásazonosító alapján
PS C:\> Get-Event -SourceIdentifier "PowerShell.ProcessCreated"
Ez a parancs lekéri azokat az eseményeket, amelyekben a SourceIdentifier tulajdonság értéke PowerShell.ProcessCreated.
3. példa: Esemény lekérése a létrehozás időpontja alapján
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 :
Ez a példa bemutatja, hogyan kérhet le eseményeket a SourceIdentifier tulajdonságtól eltérő tulajdonságok használatával.
Az első parancs lekéri az eseménysor összes eseményét, és menti őket a $Events
változóba.
A második parancs tömbjelezést használ a változó tömbjének első (0 indexes) eseményének lekéréséhez $Events
. A parancs egy folyamatkezelővel (|
) küldi el az eseményt a Format-List
parancsnak, amely egy listában jeleníti meg az esemény összes tulajdonságát. Ez lehetővé teszi az eseményobjektum tulajdonságainak vizsgálatát.
A harmadik parancs bemutatja, hogyan használhatja a Where-Object
parancsmagot egy esemény lekérésére a létrehozás időpontja alapján.
4. példa: Esemény lekérése az azonosító alapján
PS C:\> Get-Event -EventIdentifier 2
Ez a parancs lekéri az eseményt 2 eseményazonosítóval.
Paraméterek
-EventIdentifier
Megadja azokat az eseményazonosítókat, amelyekhez ez a parancsmag eseményeket kér le.
Type: | Int32 |
Aliases: | Id |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceIdentifier
Megadja azokat a forrásazonosítókat, amelyekhez ez a parancsmag eseményeket kér le. Az alapértelmezett érték az eseménysor összes eseménye. Helyettesítő karakterek használata nem engedélyezett.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Bevitelek
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
Ez a parancsmag minden eseményhez egy P Standard kiadás ventArgs objektumot ad vissza. Az objektum leírásának megtekintéséhez írja be Get-Help Get-Event -Full
és tekintse meg a súgótémakör Jegyzetek szakaszát.
Jegyzetek
Linux vagy macOS platformokon nem érhetők el eseményforrások.
Az események, az esemény-előfizetések és az eseménysor csak az aktuális munkamenetben léteznek. Ha bezárja az aktuális munkamenetet, a rendszer elveti az eseménysort, és megszakítja az esemény-előfizetést.
A Get-Event
parancsmag egy P Standard kiadás ventArgs objektumot (System.Management.Automation.P Standard kiadás ventArgs) ad vissza a következő tulajdonságokkal:
Számítógépnév. Annak a számítógépnek a neve, amelyen az esemény történt. Ezt a tulajdonságértéket csak akkor tölti ki a rendszer, ha az eseményt távoli számítógépről továbbítják.
RunspaceId. Egy GUID, amely egyedileg azonosítja azt a munkamenetet, amelyben az esemény történt. Ezt a tulajdonságértéket csak akkor tölti ki a rendszer, ha az eseményt távoli számítógépről továbbítják.
EventIdentifier. Egész szám (Int32), amely egyedileg azonosítja az eseményértesítést az aktuális munkamenetben.
Feladó. Az eseményt létrehozó objektum. A Művelet paraméter értékében az
$Sender
automatikus változó tartalmazza a feladó objektumot.SourceEventArgs. Az EventArgsből származó első paraméter, ha létezik. Egy eltelt időzítőeseményben például, amelyben az aláírás az Objektum feladója (Timers.ElapsedEventArgs e) űrlapot tartalmazza, a SourceEventArgs tulajdonság a Timers.ElapsedEventArgs tulajdonságot tartalmazza. A Művelet paraméter értékében az
$EventArgs
automatikus változó ezt az értéket tartalmazza.SourceArgs. Az eredeti esemény-aláírás összes paramétere. Normál eseményaadvány
$Args[0]
esetén a feladót és$Args[1]
a SourceEventArgset jelöli. A Művelet paraméter értékében az$Args
automatikus változó ezt az értéket tartalmazza.SourceIdentifier. Az esemény-előfizetést azonosító sztring. A Művelet paraméter értékében az automatikus változó SourceIdentifier tulajdonsága tartalmazza ezt az
$Event
értéket.TimeGenerated. DateTime-objektum, amely az esemény létrehozásának időpontját jelöli. A Művelet paraméter értékében az automatikus változó TimeGenerated tulajdonsága tartalmazza ezt az
$Event
értéket.MessageData. Az esemény-előfizetéshez társított adatok. A felhasználók az esemény regisztrálásakor adják meg ezeket az adatokat. A Művelet paraméter értékében az automatikus változó MessageData tulajdonsága tartalmazza ezt az
$Event
értéket.
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: