รับ-PSBreakpoint (Microsoft.PowerShell.Utility)

รับ-PSBreakpoint

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

รับจุดพักที่ตั้งค่าไว้ในเซสชันปัจจุบัน

ไวยากรณ์

Get-PSBreakpoint
   [[-Script] <String[]>]
   [-Runspace <Runspace>]
   [<CommonParameters>]

Get-PSBreakpoint
   [[-Script] <String[]>]
   -Command <String[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]

Get-PSBreakpoint
   [[-Script] <String[]>]
   -Variable <String[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]

Get-PSBreakpoint
   [[-Script] <String[]>]
   [-Type] <BreakpointType[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]

Get-PSBreakpoint
   [-Id] <Int32[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]

คำอธิบาย

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

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

ตัวอย่าง

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

คำสั่งนี้รับจุดพักทั้งหมดที่ตั้งไว้บนสคริปต์และฟังก์ชันทั้งหมดในเซสชันปัจจุบัน

Get-PSBreakpoint

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

คำสั่งนี้รับจุดพักด้วยจุดพัก ID 2

Get-PSBreakpoint -Id 2

Function         :
IncrementAction  :
Enabled          :
TrueHitCount     : 0
Id               : 2
Script           : C:\ps-test\sample.ps1
ScriptName       : C:\ps-test\sample.ps1

ตัวอย่างที่ 3: ไปป์ ID ไปที่ `Get-PSBreakpoint`

คำสั่งเหล่านี้แสดงวิธีรับเบรกพอยต์โดยไพพ์ ID เบรกพอยต์ไปที่ Get-PSBreakpoint

$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint

Set-PSBreakpoint cmdlet สร้างเบรกพอยต์บนฟังก์ชัน Increase ในสคริปต์ Sample.ps1 และบันทึกออบเจ็กต์เบรกพอยต์ในตัวแปร $B คุณสมบัติ Id ของออบเจ็กต์เบรกพอยต์ในตัวแปร $B ถูกส่งไปยัง Get-PSBreakpoint cmdlet เพื่อแสดงข้อมูลเบรกพอยต์

ตัวอย่างที่ 4: รับเบรกพอยต์ในไฟล์สคริปต์ที่ระบุ

คำสั่งนี้รับจุดพักทั้งหมดในไฟล์ Sample.ps1 และ SupportScript.ps1

Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

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

ตัวอย่างที่ 5: รับเบรกพอยต์ใน cmdlets ที่ระบุ

คำสั่งนี้รับจุดพักคำสั่งทั้งหมดที่ตั้งค่าไว้ในคำสั่ง Read-Host หรือ Write-Host ในไฟล์ Sample.ps1

Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

ตัวอย่างที่ 6: รับคำสั่งเบรกพอยต์ในไฟล์ที่ระบุ

Get-PSBreakpoint -Type Command -Script "Sample.ps1"

คำสั่งนี้รับจุดพักคำสั่งทั้งหมดในไฟล์ Sample.ps1

ตัวอย่างที่ 7: รับเบรกพอยต์ตามตัวแปร

คำสั่งนี้รับจุดพักที่ตั้งค่าไว้ในตัวแปร $Index และ $Swap ในเซสชันปัจจุบัน

Get-PSBreakpoint -Variable "Index, Swap"

ตัวอย่างที่ 8: รับเบรกพอยต์บรรทัดและตัวแปรทั้งหมดในไฟล์

คำสั่งนี้รับจุดพักบรรทัดและตัวแปรทั้งหมดในสคริปต์ Sample.ps1

Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

ตัวอย่างที่ 9: รับเบรกพอยต์ที่ตั้งค่าในรันสเปซเฉพาะ

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

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

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakPoint -Runspace $runspace

พารามิเตอร์

-Command

ระบุอาร์เรย์ของจุดพักคำสั่งที่ตั้งค่าบนชื่อคำสั่งที่ระบุ ป้อนชื่อคำสั่ง เช่น ชื่อของ cmdlet หรือฟังก์ชัน

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

-Id

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

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

-Runspace

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

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

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

-Script

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

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

-Type

ระบุอาร์เรย์ของชนิดเบรกพอยต์ที่ได้รับ cmdlet นี้ ป้อนหนึ่งประเภทขึ้นไป ค่าที่ยอมรับได้สำหรับพารามิเตอร์นี้คือ:

เส้น
สั่งการ
ตัวแปร

คุณยังสามารถไปป์ประเภทเบรกพอยต์ไปที่ Get-PSBreakPoint

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

-Variable

ระบุอาร์เรย์ของจุดพักตัวแปรที่ตั้งค่าบนชื่อตัวแปรที่ระบุ ป้อนชื่อตัวแปรโดยไม่มีเครื่องหมายดอลลาร์

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

อินพุต

Int32

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

ประเภทเบรกพอยต์

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

เอาท์พุต

คอมมานด์เบรกพอยต์

ไลน์เบรกพอยต์

ตัวแปรเบรกพอยต์

เบรกพอยต์

cmdlet นี้ส่งกลับวัตถุที่แสดงถึงจุดพักในเซสชัน

หมายเหตุ

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

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

รับ-PSBreakpoint (Microsoft.PowerShell.Utility)