Bagikan melalui

Enable-PSBreakpoint

Modul:
Microsoft.PowerShell.Utility Module

Mengaktifkan titik henti di konsol saat ini.

Sintaks

Breakpoint (Default) 

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

Id 

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

Deskripsi

cmdlet Enable-PSBreakpoint mengaktifkan kembali titik henti yang dinonaktifkan. Anda dapat menggunakannya untuk mengaktifkan semua titik henti, atau titik henti tertentu dengan menyediakan objek titik henti atau ID.

Titik henti adalah titik dalam skrip di mana eksekusi berhenti sementara sehingga Anda dapat memeriksa status skrip. Titik henti yang baru dibuat diaktifkan secara otomatis, tetapi dapat dinonaktifkan menggunakan Disable-PSBreakpoint.

Secara teknis, cmdlet ini mengubah nilai properti Diaktifkan dari objek titik henti menjadi True.

Enable-PSBreakpoint adalah salah satu dari beberapa cmdlet yang dirancang untuk men-debug skrip PowerShell. Untuk informasi selengkapnya tentang debugger PowerShell, lihat about_Debuggers.

Contoh

Contoh 1: Aktifkan semua titik henti

Contoh ini memungkinkan semua titik henti dalam sesi saat ini.

Get-PSBreakpoint | Enable-PSBreakpoint

Menggunakan alias, contoh ini dapat disingkat sebagai gbp | ebp.

Contoh 2: Mengaktifkan titik henti menurut ID

Contoh ini memungkinkan beberapa titik henti menggunakan ID titik hentinya.

Enable-PSBreakpoint -Id 0, 1, 5

Contoh 3: Mengaktifkan titik henti yang dinonaktifkan

Contoh ini mengaktifkan kembali titik henti yang telah dinonaktifkan.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable Name -PassThru
$B | Enable-PSBreakpoint -PassThru

AccessMode : Write
Variable   : Name
Action     :
Enabled    : False
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

membuat titik henti pada variabel Nama dalam skrip menyimpan objek titik henti dalam variabel . Parameter PassThru menampilkan nilai properti Diaktifkan dari titik henti False.

Enable-PSBreakpoint mengaktifkan kembali titik henti. Sekali lagi, menggunakan parameter PassThru kita melihat bahwa nilai properti Diaktifkan True.

Contoh 4: Mengaktifkan titik henti menggunakan variabel

Contoh ini memungkinkan serangkaian titik henti menggunakan objek titik henti.

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint mendapatkan titik henti dan menyimpannya dalam variabel $B. Menggunakan parameter Breakpoint, mengaktifkan titik henti.

Contoh ini setara dengan menjalankan Enable-PSBreakpoint -Id 3, 5.

Contoh 5: Mengaktifkan titik henti di runspace

Dalam contoh ini, pekerjaan dimulai dengan titik henti diatur untuk diputuskan lalu dinonaktifkan. Runspace yang disimpan dalam variabel diteruskan ke perintah Get-PSBreakpoint dengan parameter Runspace . Output Get-PSBreakpoint disalurkan ke Enable-PSBreakpoint untuk mengaktifkan titik henti di runspace.

Start-Job -ScriptBlock {
    $bp = Set-PSBreakpoint -Command Start-Sleep
    Disable-PSBreakpoint $bp
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakpoint -Runspace $runspace | Enable-Breakpoint -Runspace $runspace

Parameter

-Breakpoint

Menentukan titik henti yang akan diaktifkan. Berikan variabel yang berisi titik henti atau perintah yang mendapatkan objek titik henti, seperti Get-PSBreakpoint. Anda juga dapat menyalurkan objek titik henti ke Enable-PSBreakpoint.

Properti parameter

Jenis:

Breakpoint[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Breakpoint
Position:0
Wajib:True
Nilai dari alur:True
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:Cf

Kumpulan parameter

(All)
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:False
Nilai dari argumen yang tersisa:False

-Id

Menentukan id nomor titik henti yang akan diaktifkan. Nilai defaultnya adalah semua titik henti. Berikan Id berdasarkan angka atau dalam variabel. Anda tidak dapat menyalurkan nomor Id ke . Untuk menemukan id titik henti, gunakan cmdlet Get-PSBreakpoint.

Properti parameter

Jenis:

Int32[]

Nilai default:None
Mendukung wildcard:False
DontShow:False

Kumpulan parameter

Id
Position:0
Wajib:True
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-PassThru

Mengembalikan objek yang mewakili titik henti yang diaktifkan. Secara default, cmdlet ini tidak menghasilkan output apa pun.

Properti parameter

Jenis:SwitchParameter
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

-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
Alias:RunspaceId

Kumpulan parameter

Id
Position:Named
Wajib:False
Nilai dari alur:False
Nilai dari alur berdasarkan nama properti:True
Nilai dari argumen yang tersisa:False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:SwitchParameter
Nilai default:False
Mendukung wildcard:False
DontShow:False
Alias:wi

Kumpulan parameter

(All)
Position:Named
Wajib:False
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

Breakpoint

Anda dapat menyalurkan objek titik henti ke cmdlet ini.

Output

None

Secara default, cmdlet ini tidak mengembalikan output.

Breakpoint

Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek titik henti yang mewakili titik henti yang diaktifkan.

Catatan

PowerShell menyertakan alias berikut untuk Enable-PSBreakpoint:

  • Semua platform:

    • ebp

  • cmdlet Enable-PSBreakpoint tidak menghasilkan kesalahan jika Anda mencoba mengaktifkan titik henti yang sudah diaktifkan. Dengan demikian, Anda dapat mengaktifkan semua titik henti tanpa kesalahan, bahkan ketika hanya beberapa yang dinonaktifkan.

  • Titik henti diaktifkan saat Anda membuatnya dengan menggunakan cmdlet Set-PSBreakpoint. Anda tidak perlu mengaktifkan titik henti yang baru dibuat.