Unregister-Event (Microsoft.PowerShell.Utility)

Unregister-Event

โมดูล :: Microsoft.PowerShell.Utility

ยกเลิกการสมัครสมาชิกกิจกรรม

ไวยากรณ์

Unregister-Event
          [-SourceIdentifier] <String>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Unregister-Event
          [-SubscriptionId] <Int32>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

คำอธิบาย

Unregister-Event cmdlet ยกเลิกการสมัครสมาชิกเหตุการณ์ที่สร้างขึ้นโดยใช้ Register-EngineEvent, Register-ObjectEvent หรือ Register- WmiEvent cmdlet

เมื่อยกเลิกการสมัครสมาชิกกิจกรรม ผู้สมัครสมาชิกกิจกรรมจะถูกลบออกจากเซสชัน และกิจกรรมที่สมัครเป็นสมาชิกจะไม่ถูกเพิ่มลงในคิวกิจกรรมอีกต่อไป เมื่อคุณยกเลิกการสมัครรับเหตุการณ์ที่สร้างขึ้นโดยใช้ cmdlet New-Event กิจกรรมใหม่จะถูกลบออกจากเซสชันด้วย

Unregister-Event จะไม่ลบเหตุการณ์ออกจากคิวเหตุการณ์ หากต้องการลบกิจกรรม ให้ใช้ Remove-Event cmdlet

ตัวอย่าง

ตัวอย่างที่ 1: ยกเลิกการสมัครสมาชิกกิจกรรมตามตัวระบุแหล่งที่มา

คำสั่งนี้ยกเลิกการสมัครสมาชิกเหตุการณ์ที่มีตัวระบุแหล่งที่มาของ ProcessStarted

Unregister-Event -SourceIdentifier "ProcessStarted"

หากต้องการค้นหาตัวระบุแหล่งที่มาของเหตุการณ์ ให้ใช้ Get-Event cmdlet หากต้องการค้นหาตัวระบุแหล่งที่มาของการสมัครสมาชิกกิจกรรม ให้ใช้ Get-EventSubscriber cmdlet

ตัวอย่างที่ 2: ยกเลิกการสมัครสมาชิกกิจกรรมตามตัวระบุการสมัครรับข้อมูล

คำสั่งนี้ยกเลิกการสมัครสมาชิกเหตุการณ์ที่มีตัวระบุการสมัครสมาชิกเป็น 2

Unregister-Event -SubscriptionId 2

หากต้องการค้นหาตัวระบุการสมัครรับข้อมูลการสมัครรับข้อมูลกิจกรรม ให้ใช้ Get-EventSubscriber cmdlet

ตัวอย่างที่ 3: ยกเลิกการสมัครสมาชิกกิจกรรมทั้งหมด

ตัวอย่างนี้จะยกเลิกการสมัครสมาชิกกิจกรรมทั้งหมดในเซสชัน

Get-EventSubscriber -Force | Unregister-Event -Force

การใช้พารามิเตอร์ Force กับ Get-EventSubscriber จะได้รับออบเจ็กต์สมาชิกเหตุการณ์ทั้งหมดในเซสชัน รวมถึงสมาชิกที่ถูกซ่อนไว้ เอาต์พุตถูกส่งไปยัง Unregister-Event ซึ่งจะลบสมาชิกออกจากเซสชัน ต้องใช้พารามิเตอร์ บังคับ ใน Unregister-Event เพื่อลบสมาชิกที่ซ่อนอยู่

พารามิเตอร์

-Confirm

แจ้งให้คุณยืนยันก่อนเรียกใช้ cmdlet

พิมพ์ :: SwitchParameter
นามแฝง :: cf
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: False
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

-Force

ยกเลิกการสมัครสมาชิกเหตุการณ์ทั้งหมด รวมถึงการสมัครสมาชิกที่ถูกซ่อนไว้โดยใช้พารามิเตอร์ SupportEvent ของ Register-ObjectEvent, Register-WmiEvent และ Register -EngineEvent.

พิมพ์ :: SwitchParameter
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: None
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

-SourceIdentifier

ระบุตัวระบุแหล่งที่มาที่ cmdlet นี้ยกเลิกการสมัครสมาชิกกิจกรรม

ต้องมีพารามิเตอร์ SourceIdentifier หรือ SubscriptionId ในทุกคำสั่ง

พิมพ์ :: String
ตำแหน่ง:: 0
ค่าเริ่มต้น:: None
ที่จำเป็น:: True
ยอมรับอินพุตไปป์ไลน์:: True
ยอมรับอักขระตัวแทน:: False

-SubscriptionId

ระบุรหัสตัวระบุแหล่งที่มาที่ cmdlet นี้ยกเลิกการสมัครสมาชิกกิจกรรม

ต้องมีพารามิเตอร์ SourceIdentifier หรือ SubscriptionId ในทุกคำสั่ง

พิมพ์ :: Int32
ตำแหน่ง:: 0
ค่าเริ่มต้น:: None
ที่จำเป็น:: True
ยอมรับอินพุตไปป์ไลน์:: True
ยอมรับอักขระตัวแทน:: False

-WhatIf

แสดงสิ่งที่จะเกิดขึ้นหาก cmdlet ทำงาน cmdlet ไม่ทำงาน

พิมพ์ :: SwitchParameter
นามแฝง :: wi
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: False
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

อินพุต

สมาชิก PSEvent

คุณสามารถไปป์เอาต์พุตจาก Get-EventSubscriber ไปยัง cmdlet นี้

เอาท์พุต

ไม่มี

cmdlet นี้ส่งคืนไม่มีผลลัพธ์

หมายเหตุ

ไม่มีแหล่งที่มาของเหตุการณ์บนแพลตฟอร์ม Linux หรือ macOS

กิจกรรม การสมัครสมาชิกกิจกรรม และคิวกิจกรรมมีอยู่ในเซสชันปัจจุบันเท่านั้น หากคุณปิดเซสชันปัจจุบัน คิวกิจกรรมจะถูกยกเลิกและการสมัครสมาชิกกิจกรรมจะถูกยกเลิก

Unregister-Event ไม่สามารถลบเหตุการณ์ที่สร้างขึ้นโดยใช้ cmdlet New-Event เว้นแต่คุณได้สมัครรับเหตุการณ์โดยใช้ cmdlet Register-EngineEvent หากต้องการลบเหตุการณ์ที่กำหนดเองออกจากเซสชัน คุณต้องลบเหตุการณ์นั้นออกโดยทางโปรแกรมหรือปิดเซสชัน

Unregister-Event (Microsoft.PowerShell.Utility)