Bagikan melalui

Get-PSBreakpoint

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Mendapatkan titik henti yang diatur dalam sesi saat ini.

Sintaks

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>]

Deskripsi

Get-PSBreakPoint Cmdlet mendapatkan titik henti yang diatur dalam sesi saat ini. Anda dapat menggunakan parameter cmdlet untuk mendapatkan titik henti tertentu.

Titik henti adalah titik dalam perintah atau skrip di mana eksekusi berhenti sementara sehingga Anda dapat memeriksa instruksi. Get-PSBreakpoint adalah salah satu dari beberapa cmdlet yang dirancang untuk men-debug skrip dan perintah PowerShell. Untuk informasi selengkapnya tentang debugger PowerShell, lihat about_Debuggers.

Contoh

Contoh 1: Mendapatkan semua titik henti untuk semua skrip dan fungsi

Perintah ini mendapatkan semua titik henti yang diatur pada semua skrip dan fungsi dalam sesi saat ini.

Get-PSBreakpoint

Contoh 2: Dapatkan titik henti berdasarkan ID

Perintah ini mendapatkan titik henti dengan ID titik henti 2.

Get-PSBreakpoint -Id 2

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

Contoh 3: Pipa ID ke 'Get-PSBreakpoint'

Perintah ini menunjukkan cara mendapatkan titik henti dengan memilah ID titik henti ke Get-PSBreakpoint.

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

Set-PSBreakpoint Cmdlet membuat titik henti pada fungsi Kenaikan dalam Sample.ps1 skrip dan menyimpan objek titik henti dalam $B variabel. Properti Id objek titik henti dalam variabel disalurkan $B ke Get-PSBreakpoint cmdlet untuk menampilkan informasi titik henti.

Contoh 4: Mendapatkan titik henti dalam file skrip tertentu

Perintah ini mendapatkan semua titik henti dalam Sample.ps1 file dan SupportScript.ps1 .

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

Perintah ini tidak mendapatkan titik henti lain yang mungkin diatur dalam skrip lain atau pada fungsi dalam sesi.

Contoh 5: Mendapatkan titik henti dalam cmdlet tertentu

Perintah ini mendapatkan semua titik henti Perintah yang diatur pada Read-Host atau Write-Host perintah dalam Sample.ps1 file.

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

Contoh 6: Dapatkan titik henti Perintah dalam file tertentu

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

Perintah ini mendapatkan semua titik henti Perintah dalam file Sample.ps1.

Contoh 7: Dapatkan titik henti menurut variabel

Perintah ini mendapatkan titik henti yang diatur pada $Index variabel dan $Swap dalam sesi saat ini.

Get-PSBreakpoint -Variable "Index, Swap"

Contoh 8: Mendapatkan semua titik henti Baris dan Variabel dalam file

Perintah ini mendapatkan semua titik henti baris dan variabel dalam Sample.ps1 skrip.

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

Contoh 9: Mendapatkan titik henti yang diatur di runspace tertentu

Dalam contoh ini, pekerjaan dimulai dan titik henti diatur untuk berhenti saat Set-PSBreakPoint dijalankan. Runspace disimpan dalam variabel dan diteruskan ke Get-PSBreakPoint perintah dengan parameter Runspace . Anda kemudian dapat memeriksa titik henti dalam $breakpoint variabel.

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

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakPoint -Runspace $runspace

Parameter

-Command

Menentukan array titik henti perintah yang diatur pada nama perintah yang ditentukan. Masukkan nama perintah, seperti nama cmdlet atau fungsi.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-Id

Menentukan ID titik henti yang didapat cmdlet ini. Masukkan ID dalam daftar yang dipisahkan koma. Anda juga dapat menyalurkan ID titik henti ke Get-PSBreakpoint.

Jenis:Int32[]
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Runspace

Menentukan Id objek Runspace sehingga Anda dapat berinteraksi dengan titik henti di runspace yang ditentukan.

Parameter ini ditambahkan di PowerShell 7.2.

Jenis:Runspace
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Script

Menentukan array skrip yang berisi titik henti. Masukkan jalur (opsional) dan nama satu atau beberapa file skrip. Jika Anda menghilangkan jalur, lokasi default adalah direktori saat ini.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Type

Menentukan array jenis titik henti yang didapat cmdlet ini. Masukkan satu atau beberapa jenis. Nilai yang dapat diterima untuk parameter ini adalah:

  • Garis
  • Perintah
  • Variabel

Anda juga dapat menyalurkan jenis titik henti ke Get-PSBreakPoint.

Jenis:BreakpointType[]
Nilai yang diterima:Line, Variable, Command
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Variable

Menentukan array titik henti variabel yang diatur pada nama variabel yang ditentukan. Masukkan nama variabel tanpa tanda dolar.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

Input

Int32

Anda dapat menyalurkan ID titik henti ke cmdlet ini.

BreakpointType

Anda dapat menyalurkan jenis titik henti ke cmdlet ini.

Output

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Cmdlet ini mengembalikan objek yang mewakili titik henti dalam sesi.

Catatan

PowerShell menyertakan alias berikut untuk Get-PSBreakpoint:

  • Semua platform:
    • gbp