ปิดการใช้งาน PSBreakpoint (Microsoft.PowerShell.Utility)

ปิดการใช้งาน-PSBreakpoint

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

ปิดใช้งานเบรกพอยต์ในคอนโซลปัจจุบัน

ไวยากรณ์

Disable-PSBreakpoint
       [-PassThru]
       [-Breakpoint] <Breakpoint[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

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

คำอธิบาย

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

ในทางเทคนิค cmdlet นี้เปลี่ยนค่าของคุณสมบัติเปิดใช้งานของวัตถุเบรกพอยต์เป็นเท็จ หากต้องการเปิดใช้งานเบรกพอยต์อีกครั้ง ให้ใช้ Enable-PSBreakpoint cmdlet เบรกพอยต์จะเปิดใช้งานตามค่าเริ่มต้นเมื่อคุณสร้างโดยใช้ cmdlet Set-PSBreakpoint

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

ตัวอย่าง

ตัวอย่างที่ 1: ตั้งค่าเบรกพอยต์และปิดใช้งาน

คำสั่งเหล่านี้ปิดใช้งานเบรกพอยต์ที่สร้างขึ้นใหม่

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

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

จากผลของคำสั่งนี้ ค่าของคุณสมบัติ เปิดใช้งาน ของออบเจ็กต์เบรกพอยต์ใน $B จะเป็น False

ตัวอย่างที่ 2: ปิดการใช้งานเบรกพอยต์

คำสั่งนี้ปิดใช้งานเบรกพอยต์ด้วยเบรกพอยต์ ID 0

Disable-PSBreakpoint -Id 0

ตัวอย่างที่ 3: สร้างเบรกพอยต์ที่ปิดใช้งาน

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

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

ใช้ cmdlet Disable-PSBreakpoint เพื่อปิดใช้งานเบรกพอยต์ ค่าของพารามิเตอร์ เบรกพอยต์ คือคำสั่ง Set-PSBreakpoint ที่ตั้งค่าเบรกพอยต์ใหม่ สร้างออบเจ็กต์เบรกพอยต์ และบันทึกออบเจ็กต์ไว้ใน $B ตัวแปร

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

ตัวอย่างที่ 4: ปิดใช้งานเบรกพอยต์ทั้งหมดในคอนโซลปัจจุบัน

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

`Get-PSBreakpoint` | Disable-PSBreakpoint

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

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

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

$runspace = Get-Runspace -Id 1

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

พารามิเตอร์

-Breakpoint

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

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

-Confirm

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

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

-Id

ปิดใช้งานเบรกพอยต์ด้วย ID เบรกพอยต์ที่ระบุ ป้อนรหัสหรือตัวแปรที่มีรหัส คุณไม่สามารถไปป์ ID เพื่อ Disable-PSBreakpoint

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

-PassThru

ส่งคืนวัตถุที่แสดงถึงเบรกพอยต์ที่เปิดใช้งาน ตามค่าเริ่มต้น cmdlet นี้ไม่สร้างผลลัพธ์ใดๆ

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

-Runspace

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

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

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

-WhatIf

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

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

อินพุต

เบรกพอยต์

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

เอาท์พุต

ไม่มี

ตามค่าเริ่มต้น cmdlet นี้จะส่งกลับไม่มีผลลัพธ์

เบรกพอยต์

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

หมายเหตุ

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

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

ปิดการใช้งาน PSBreakpoint (Microsoft.PowerShell.Utility)