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.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Runspace

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

Parameter ini ditambahkan di PowerShell 7.2.

Type:Runspace
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:BreakpointType[]
Accepted values:Line, Variable, Command
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Variable

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

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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