Disable-PSBreakpoint
Menonaktifkan titik henti di konsol saat ini.
Sintaks
Breakpoint (Default)
Disable-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Disable-PSBreakpoint
[-Id] <Int32[]>
[-PassThru]
[-Runspace <Runspace>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
cmdlet Disable-PSBreakpoint menonaktifkan titik henti, yang memastikan bahwa mereka tidak terpukul saat skrip berjalan. Anda dapat menggunakannya untuk menonaktifkan semua titik henti, atau Anda dapat menentukan titik henti dengan mengirimkan objek titik henti atau ID titik henti.
Secara teknis, cmdlet ini mengubah nilai properti Enabled dari objek breakpoint menjadi False.
Untuk mengaktifkan kembali titik henti, gunakan cmdlet Enable-PSBreakpoint. Titik henti diaktifkan secara bawaan ketika Anda membuatnya menggunakan cmdlet Set-PSBreakpoint.
Titik henti adalah titik dalam skrip di mana eksekusi berhenti sementara sehingga Anda dapat memeriksa instruksi dalam skrip.
Disable-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: Mengatur titik henti dan menonaktifkannya
Perintah ini menonaktifkan titik henti yang baru dibuat.
$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint
Cmdlet Set-PSBreakpoint membuat titik henti pada variabel $Name dalam skrip Sample.ps1 dan menyimpan objek titik henti dalam variabel $B. Cmdlet Disable-PSBreakpoint menonaktifkan titik henti baru. Ini menggunakan operator alur (|) untuk mengirim objek titik henti dalam $B ke cmdlet Disable-PSBreakpoint.
Sebagai hasil dari perintah ini, nilai properti Diaktifkan dari objek titik henti di $B adalah False.
Contoh 2: Menonaktifkan titik henti
Perintah ini menonaktifkan titik henti dengan ID titik henti 0.
Disable-PSBreakpoint -Id 0
Contoh 3: Membuat titik henti yang dinonaktifkan
Perintah ini membuat titik henti baru yang dinonaktifkan hingga Anda mengaktifkannya.
Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
Ini menggunakan cmdlet Disable-PSBreakpoint untuk menonaktifkan titik henti. Nilai parameter Breakpoint adalah perintah Set-PSBreakpoint yang mengatur titik henti baru, menghasilkan objek titik henti, dan menyimpan objek dalam variabel $B.
Parameter cmdlet yang mengambil objek sebagai nilainya dapat menerima variabel yang berisi objek atau perintah yang mendapatkan atau menghasilkan objek. Dalam hal ini, karena
Contoh 4: Nonaktifkan semua titik henti di konsol saat ini
Perintah ini menonaktifkan semua titik henti di konsol saat ini.
`Get-PSBreakpoint` | Disable-PSBreakpoint
Contoh 5: Menonaktifkan titik henti di runspace
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 . Keluaran dari Get-PSBreakpoint disalurkan ke Disable-PSBreakpoint untuk menonaktifkan poin penghentian di runspace.
Start-Job -ScriptBlock {
Set-PSBreakpoint -Command Start-Sleep
Start-Sleep -Seconds 10
}
$runspace = Get-Runspace -Id 1
Get-PSBreakpoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace
Parameter
-Breakpoint
Menentukan titik henti yang akan dinonaktifkan. Masukkan variabel yang berisi objek titik henti atau perintah yang mendapatkan objek titik henti, seperti perintah Get-PSBreakpoint. Anda juga dapat menyalurkan objek titik henti ke cmdlet Disable-PSBreakpoint.
Properti parameter
| Jenis: | |
| 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
Menonaktifkan titik henti dengan ID titik henti yang ditentukan. Masukkan ID atau variabel yang berisi ID. Anda tidak dapat menyalurkan ID ke Disable-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
Ketika Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek breakpoint yang mewakili titik henti yang dinonaktifkan.
Catatan
PowerShell menyertakan alias berikut untuk Disable-PSBreakpoint:
- Semua platform:
dbp
