Enable-PSBreakpoint

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Mengaktifkan titik henti di konsol saat ini.

Sintaks

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

Deskripsi

Enable-PSBreakpoint Cmdlet 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

Set-PSBreakpoint membuat titik henti pada variabel Nama dalam skrip yang Sample.ps1 menyimpan objek titik henti dalam $B variabel. Parameter PassThru menampilkan nilai properti Diaktifkan dari titik henti adalah False.

Enable-PSBreakpoint mengaktifkan kembali titik henti. Sekali lagi, menggunakan parameter PassThru kita melihat bahwa nilai properti Diaktifkan adalah 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 $B variabel. Menggunakan parameter Breakpoint, Enable-PSBreakpoint memungkinkan 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 disimpan dalam variabel dan diteruskan ke Get-PSBreakPoint perintah dengan parameter Runspace . Output disalurkan Get-PSBreakPoint untuk Enable-PSBreakpoint 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.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

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

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

  • Enable-PSBreakpoint Cmdlet 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 Set-PSBreakpoint cmdlet. Anda tidak perlu mengaktifkan titik henti yang baru dibuat.