Get-Event
Mendapatkan peristiwa dalam antrean peristiwa.
Sintaks
Get-Event
[[-SourceIdentifier] <String>]
[<CommonParameters>]
Get-Event
[-EventIdentifier] <Int32>
[<CommonParameters>]
Deskripsi
Get-Event
Cmdlet mendapatkan peristiwa dalam antrean peristiwa PowerShell untuk sesi saat ini. Anda bisa mendapatkan semua peristiwa atau menggunakan parameter EventIdentifier atau SourceIdentifier untuk menentukan peristiwa.
Saat peristiwa terjadi, peristiwa ditambahkan ke antrean peristiwa. Antrean peristiwa mencakup peristiwa yang telah Anda daftarkan, peristiwa yang dibuat dengan menggunakan New-Event
cmdlet, dan peristiwa yang dinaikkan saat PowerShell keluar. Anda dapat menggunakan Get-Event
atau Wait-Event
untuk mendapatkan peristiwa.
Cmdlet ini tidak mendapatkan peristiwa dari log Pemantau Peristiwa. Untuk mendapatkan peristiwa tersebut, gunakan Get-WinEvent
atau Get-EventLog
.
Contoh
Contoh 1: Dapatkan semua peristiwa
PS C:\> Get-Event
Perintah ini mendapatkan semua peristiwa dalam antrean peristiwa.
Contoh 2: Mendapatkan peristiwa menurut pengidentifikasi sumber
PS C:\> Get-Event -SourceIdentifier "PowerShell.ProcessCreated"
Perintah ini mendapatkan peristiwa di mana nilai properti SourceIdentifier adalah PowerShell.ProcessCreated.
Contoh 3: Dapatkan peristiwa berdasarkan waktu pembuatannya
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 :
Contoh ini menunjukkan cara mendapatkan peristiwa dengan menggunakan properti selain SourceIdentifier.
Perintah pertama mendapatkan semua peristiwa dalam antrean peristiwa dan menyimpannya dalam $Events
variabel.
Perintah kedua menggunakan notasi array untuk mendapatkan peristiwa (0-indeks) pertama dalam array dalam $Events
variabel. Perintah menggunakan operator alur (|
) untuk mengirim peristiwa ke Format-List
perintah, yang menampilkan semua properti peristiwa dalam daftar. Ini memungkinkan Anda untuk memeriksa properti objek peristiwa.
Perintah ketiga menunjukkan cara menggunakan Where-Object
cmdlet untuk mendapatkan peristiwa berdasarkan waktu pembuatannya.
Contoh 4: Mendapatkan peristiwa berdasarkan pengidentifikasinya
PS C:\> Get-Event -EventIdentifier 2
Perintah ini mendapatkan peristiwa dengan pengidentifikasi peristiwa 2.
Parameter
-EventIdentifier
Menentukan pengidentifikasi peristiwa tempat cmdlet ini mendapatkan peristiwa.
Jenis: | Int32 |
Alias: | Id |
Position: | 0 |
Nilai default: | None |
Diperlukan: | True |
Terima input alur: | True |
Terima karakter wildcard: | False |
-SourceIdentifier
Menentukan pengidentifikasi sumber tempat cmdlet ini mendapatkan peristiwa. Defaultnya adalah semua peristiwa dalam antrean peristiwa. Kartubebas tidak diizinkan.
Jenis: | String |
Position: | 0 |
Nilai default: | None |
Diperlukan: | False |
Terima input alur: | True |
Terima karakter wildcard: | False |
Input
None
Anda tidak dapat menyalurkan objek ke cmdlet ini.
Output
Cmdlet ini mengembalikan objek PSEventArgs untuk setiap peristiwa. Untuk melihat deskripsi objek ini, ketik Get-Help Get-Event -Full
dan lihat bagian Catatan dari topik bantuan.
Catatan
Tidak ada sumber peristiwa yang tersedia di platform Linux atau macOS.
Peristiwa, langganan peristiwa, dan antrean peristiwa hanya ada di sesi saat ini. Jika Anda menutup sesi saat ini, antrean peristiwa akan dibuang dan langganan acara dibatalkan.
Get-Event
Cmdlet mengembalikan objek PSEventArgs (System.Management.Automation.PSEventArgs) dengan properti berikut:
ComputerName. Nama komputer tempat peristiwa terjadi. Nilai properti ini diisi hanya ketika peristiwa diteruskan dari komputer jarak jauh.
RunspaceId. GUID yang secara unik mengidentifikasi sesi tempat peristiwa terjadi. Nilai properti ini diisi hanya ketika peristiwa diteruskan dari komputer jarak jauh.
EventIdentifier. Bilangan bulat (Int32) yang secara unik mengidentifikasi pemberitahuan peristiwa dalam sesi saat ini.
Pengirim. Objek yang menghasilkan peristiwa. Dalam nilai parameter Tindakan ,
$Sender
variabel otomatis berisi objek pengirim.SourceEventArgs. Parameter pertama yang berasal dari EventArgs, jika ada. Misalnya, dalam peristiwa timer yang berlalu di mana tanda tangan memiliki formulir Pengirim objek, Timers.ElapsedEventArgs e, properti SourceEventArgs akan berisi Timers.ElapsedEventArgs. Dalam nilai parameter Tindakan ,
$EventArgs
variabel otomatis berisi nilai ini.SourceArgs. Semua parameter tanda tangan peristiwa asli. Untuk tanda tangan peristiwa standar,
$Args[0]
mewakili pengirim, dan$Args[1]
mewakili SourceEventArgs. Dalam nilai parameter Tindakan ,$Args
variabel otomatis berisi nilai ini.SourceIdentifier. String yang mengidentifikasi langganan peristiwa. Dalam nilai parameter Tindakan , properti SourceIdentifier dari
$Event
variabel otomatis berisi nilai ini.TimeGenerated. Objek DateTime yang mewakili waktu di mana peristiwa dibuat. Dalam nilai parameter Tindakan , properti TimeGenerated dari
$Event
variabel otomatis berisi nilai ini.MessageData. Data yang terkait dengan langganan peristiwa. Pengguna menentukan data ini saat mereka mendaftarkan peristiwa. Dalam nilai parameter Tindakan , properti MessageData dari
$Event
variabel otomatis berisi nilai ini.