ลบ-PSBreakpoint (Microsoft.PowerShell.Utility)

ลบ-PSBreakpoint

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

ลบเบรกพอยต์ออกจากคอนโซลปัจจุบัน

ไวยากรณ์

Remove-PSBreakpoint
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-PSBreakpoint
      [-Id] <Int32[]>
      [-Runspace <Runspace>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

คำอธิบาย

cmdlet Remove-PSBreakpoint ลบเบรกพอยต์ ป้อนวัตถุเบรกพอยต์หรือรหัสเบรกพอยต์

เมื่อคุณลบเบรกพอยต์ วัตถุเบรกพอยต์จะไม่พร้อมใช้งานหรือทำงานได้อีกต่อไป หากคุณได้บันทึกออบเจ็กต์เบรกพอยต์ไว้ในตัวแปร การอ้างอิงยังคงมีอยู่ แต่เบรกพอยต์จะไม่ทำงาน

Remove-PSBreakpoint เป็นหนึ่งใน cmdlet ต่างๆ ที่ออกแบบมาสำหรับการแก้ไขข้อบกพร่องของสคริปต์ PowerShell สำหรับข้อมูลเพิ่มเติมเกี่ยวกับดีบักเกอร์ PowerShell ดูabout_Debuggers

ตัวอย่าง

ตัวอย่างที่ 1: ลบเบรกพอยต์ทั้งหมด

คำสั่งนี้จะลบจุดพักทั้งหมดในคอนโซลปัจจุบัน

Get-PSBreakpoint | Remove-PSBreakpoint

ตัวอย่างที่ 2: ลบเบรกพอยต์ที่ระบุ

คำสั่งนี้จะลบเบรกพอยต์

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
$B | Remove-PSBreakpoint

Set-PSBreakpoint cmdlet สร้างเบรกพอยต์บนตัวแปร $Name ในสคริปต์ Sample.ps1 และบันทึกวัตถุเบรกพอยต์ใน $B ตัวแปร Remove-PSBreakpoint cmdlet ลบเบรกพอยต์ใหม่ ใช้ตัวดำเนินการไปป์ไลน์ (|) เพื่อส่งวัตถุจุดพักในตัวแปร $B ไปยัง cmdlet Remove-PSBreakpoint

จากผลของคำสั่งนี้ หากคุณรันสคริปต์ สคริปต์ก็จะรันจนเสร็จสิ้นโดยไม่หยุด นอกจากนี้ cmdlet Get-PSBreakpoint ไม่ส่งคืนเบรกพอยต์นี้

ตัวอย่างที่ 3: ลบเบรกพอยต์ด้วย ID

คำสั่งนี้จะลบเบรกพอยต์ด้วยเบรกพอยต์ ID 2

Remove-PSBreakpoint -Id 2

ตัวอย่างที่ 4: ใช้ฟังก์ชันเพื่อลบเบรกพอยต์ทั้งหมด

ฟังก์ชันแบบง่ายนี้จะลบเบรกพอยต์ทั้งหมดในเซสชันปัจจุบัน

function del-psb { Get-PSBreakpoint | Remove-PSBreakpoint }

ใช้ cmdlet Get-PSBreakpoint เพื่อรับเบรกพอยท์ จากนั้น จะใช้ตัวดำเนินการไปป์ไลน์ (|) เพื่อส่งจุดพักไปยัง cmdlet Remove-PSBreakpoint ซึ่งจะลบออก

ตัวอย่างที่ 5: ลบเบรกพอยต์ในรันสเปซ

ในตัวอย่างนี้ งานจะเริ่มต้นขึ้นและมีการตั้งค่าเบรกพอยต์ให้ใช้งานไม่ได้เมื่อมีการรัน Set-PSBreakPoint Runspace ถูกจัดเก็บไว้ในตัวแปรและส่งผ่านไปยังคำสั่ง Get-PSBreakPoint พร้อมด้วยพารามิเตอร์ Runspace ผลลัพธ์ของ Get-PSBreakPoint ถูกส่งไปยัง Remove-PSBreakpoint เพื่อลบเบรกพอยต์ในรันสเปซ

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Remove-Breakpoint -Runspace $runspace

พารามิเตอร์

-Breakpoint

ระบุเบรกพอยต์ที่จะลบ ป้อนตัวแปรที่มีวัตถุเบรกพอยต์หรือคำสั่งที่ได้รับวัตถุเบรกพอยต์ เช่น คำสั่ง Get-PSBreakpoint คุณยังสามารถไปป์วัตถุเบรกพอยต์เพื่อ Remove-PSBreakpoint

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

-Confirm

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

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

-Id

ระบุรหัสเบรกพอยต์ที่ cmdlet นี้ลบเบรกพอยต์

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

-Runspace

ระบุรหัสของออบเจ็กต์ Runspace เพื่อให้คุณสามารถโต้ตอบกับเบรกพอยต์ในรันสเปซที่ระบุได้

พารามิเตอร์นี้ถูกเพิ่มใน PowerShell 7.2

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

-WhatIf

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

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

อินพุต

เบรกพอยต์[]

คุณสามารถไปป์วัตถุเบรกพอยต์กับ cmdlet นี้

Int32[]

รันสเปซ

เอาท์พุต

ไม่มี

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

หมายเหตุ

PowerShell มีนามแฝงต่อไปนี้สำหรับ Remove-PSBreakpoint:

ทุกแพลตฟอร์ม:

ลบ-PSBreakpoint (Microsoft.PowerShell.Utility)