Get-PSBreakpoint
Mendapatkan titik henti yang diatur dalam sesi saat ini.
Sintaks
Line (Default)
Get-PSBreakpoint
[[-Script] <String[]>]
[-Runspace <Runspace>]
[<CommonParameters>]
Command
Get-PSBreakpoint
[[-Script] <String[]>]
-Command <String[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Variable
Get-PSBreakpoint
[[-Script] <String[]>]
-Variable <String[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Type
Get-PSBreakpoint
[[-Script] <String[]>]
[-Type] <BreakpointType[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Id
Get-PSBreakpoint
[-Id] <Int32[]>
[-Runspace <Runspace>]
[<CommonParameters>]
Deskripsi
cmdlet Get-PSBreakpoint 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
Cmdlet Set-PSBreakpoint membuat titik henti pada fungsi Kenaikan dalam skrip Sample.ps1 dan menyimpan objek titik henti dalam variabel $B. Properti Id objek titik henti dalam variabel $B disalurkan ke cmdlet Get-PSBreakpoint untuk menampilkan informasi titik henti.
Contoh 4: Mendapatkan titik henti dalam file skrip tertentu
Perintah ini mendapatkan semua titik henti dalam file Sample.ps1 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 perintah Read-Host atau Write-Host dalam file Sample.ps1.
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 variabel $Index 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 skrip Sample.ps1.
Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"
Contoh 9: Mendapatkan titik henti yang diatur di runspace tertentu
Dalam contoh ini, tugas dimulai dan titik henti diatur untuk berhenti ketika Set-PSBreakpoint dijalankan. Runspace yang disimpan dalam variabel diteruskan ke perintah Get-PSBreakpoint dengan parameter Runspace . Anda kemudian dapat memeriksa titik henti dalam variabel $breakpoint.
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.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Command
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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.
Properti parameter
| Jenis: | Int32[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Id
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Runspace
Menentukan Id objek Runspace sehingga Anda dapat berinteraksi dengan titik henti di Runspace yang ditentukan.
Parameter ini ditambahkan di PowerShell 7.2.
Properti parameter
| Jenis: | Runspace |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Script
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
Variable
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
Command
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
Type
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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.
Properti parameter
| Jenis: | |
| Nilai default: | None |
| Nilai yang diterima: | Line, Variable, Command |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Type
| Position: | 0 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Variable
Menentukan array titik henti variabel yang diatur pada nama variabel yang ditentukan. Masukkan nama variabel tanpa tanda dolar.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Kumpulan parameter
Variable
| Position: | Named |
| Wajib: | True |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.
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
