Remove-Event
Menghapus peristiwa dari antrean peristiwa.
Sintaks
BySource (Default)
Remove-Event
[-SourceIdentifier] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByIdentifier
Remove-Event
[-EventIdentifier] <Int32>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
cmdlet Remove-Event menghapus peristiwa dari antrean peristiwa di sesi saat ini.
Cmdlet ini hanya menghapus peristiwa yang saat ini dalam antrean. Untuk membatalkan pendaftaran peristiwa atau berhenti berlangganan, gunakan cmdlet Unregister-Event.
Contoh
Contoh 1: Menghapus peristiwa menurut pengidentifikasi sumber
PS C:\> Remove-Event -SourceIdentifier "ProcessStarted"
Perintah ini menghapus peristiwa dengan pengidentifikasi sumber Proses Dimulai dari antrean peristiwa.
Contoh 2: Menghapus peristiwa menurut pengidentifikasi peristiwa
PS C:\> Remove-Event -EventIdentifier 30
Perintah ini menghapus peristiwa dengan ID peristiwa 30 dari antrean peristiwa.
Contoh 3: Menghapus semua peristiwa
PS C:\> Get-Event | Remove-Event
Perintah ini menghapus semua peristiwa dari antrean peristiwa.
Parameter
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-EventIdentifier
Menentukan pengidentifikasi peristiwa yang cmdletnya dihapus. Parameter EventIdentifier atau SourceIdentifier diperlukan di setiap perintah.
Properti parameter
| Jenis: | Int32 |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
ByIdentifier
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | True |
| Nilai dari argumen yang tersisa: | False |
-SourceIdentifier
Menentukan pengidentifikasi sumber tempat cmdlet ini menghapus peristiwa. Kartubebas tidak diizinkan. Parameter EventIdentifier atau SourceIdentifier diperlukan di setiap perintah.
Properti parameter
| Jenis: | String |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
BySource
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
Input
PSEventArgs
Anda dapat menyalurkan peristiwa dari Get-Event ke cmdlet ini.
Output
None
Cmdlet ini tidak mengembalikan output.
Catatan
Peristiwa, langganan peristiwa, dan antrean peristiwa hanya ada di sesi saat ini. Jika Anda menutup sesi saat ini, antrian peristiwa akan dibuang dan langganan peristiwa dibatalkan.
