Disable-PSBreakpoint

  • Referensi
Modul:
Microsoft.PowerShell.Utility

Menonaktifkan titik henti di konsol saat ini.

Sintaks

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

Deskripsi

Disable-PSBreakpoint Cmdlet 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 Diaktifkan dari objek titik henti menjadi False. Untuk mengaktifkan kembali titik henti, gunakan Enable-PSBreakpoint cmdlet. Titik henti diaktifkan secara default saat Anda membuatnya menggunakan Set-PSBreakpoint cmdlet.

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

Set-PSBreakpoint Cmdlet membuat titik henti pada $Name variabel dalam Sample.ps1 skrip dan menyimpan objek titik henti dalam $B variabel. Disable-PSBreakpoint Cmdlet menonaktifkan titik henti baru. Ini menggunakan operator alur (|) untuk mengirim objek $B titik henti ke Disable-PSBreakpoint cmdlet.

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 Disable-PSBreakpoint cmdlet untuk menonaktifkan titik henti. Nilai parameter Breakpoint adalah Set-PSBreakpoint perintah yang mengatur titik henti baru, menghasilkan objek titik henti, dan menyimpan objek dalam $B variabel.

Parameter cmdlet yang mengambil objek sebagai nilainya dapat menerima variabel yang berisi objek atau perintah yang mendapatkan atau menghasilkan objek. Dalam hal ini, karena Set-PSBreakpoint menghasilkan objek titik henti, objek tersebut dapat digunakan sebagai nilai parameter Breakpoint .

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, 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 . Output disalurkan Get-PSBreakPoint ke untuk Disable-PSBreakpoint menonaktifkan titik henti 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 Get-PSBreakpoint perintah. Anda juga dapat menyalurkan objek titik henti ke Disable-PSBreakpoint cmdlet.

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

Menonaktifkan titik henti dengan ID titik henti yang ditentukan. Masukkan ID atau variabel yang berisi ID. Anda tidak dapat menyalurkan ID ke Disable-PSBreakpoint.

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 dinonaktifkan.

Catatan

PowerShell menyertakan alias berikut untuk Disable-PSBreakpoint:

  • Semua platform:
    • dbp