Remove-Event

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Menghapus peristiwa dari antrean peristiwa.

Sintaks

Remove-Event
      [-SourceIdentifier] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Event
      [-EventIdentifier] <Int32>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Deskripsi

Remove-Event Cmdlet 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 Unregister-Event cmdlet.

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 Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventIdentifier

Menentukan pengidentifikasi peristiwa yang cmdletnya dihapus. Parameter EventIdentifier atau SourceIdentifier diperlukan di setiap perintah.

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SourceIdentifier

Menentukan pengidentifikasi sumber tempat cmdlet ini menghapus peristiwa. Kartubebas tidak diizinkan. Parameter EventIdentifier atau SourceIdentifier diperlukan di setiap perintah.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

PSEventArgs

Anda dapat menyalurkan peristiwa dari Get-Event ke cmdlet ini.

Output

None

Cmdlet ini tidak mengembalikan output.

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.