Disable-PSBreakpoint

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

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

O cmdlet Disable-PSBreakpoint desabilita pontos de interrupção, o que garante que eles não sejam atingidos quando o script é executado. Você pode usá-lo para desabilitar todos os pontos de interrupção ou pode especificar pontos de interrupção enviando objetos de ponto de interrupção ou IDs de ponto de interrupção.

Tecnicamente, esse cmdlet altera o valor da propriedade Enabled de um objeto de ponto de interrupção para False. Para reativar um ponto de interrupção, use o cmdlet Enable-PSBreakpoint. Os pontos de interrupção são habilitados por padrão quando você os cria usando o cmdlet Set-PSBreakpoint.

Um ponto de interrupção é um ponto em um script onde a execução para temporariamente para que você possa examinar as instruções no script. Disable-PSBreakpoint é um dos vários cmdlets projetados para depurar scripts do Windows PowerShell. Para obter mais informações sobre o depurador do Windows PowerShell, consulte about_Debuggers.

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint

Esses comandos desabilitam um ponto de interrupção recém-criado.

O primeiro comando usa o cmdlet Set-PSBreakpoint para criar um ponto de interrupção na variável Name no script Sample.ps1. Em seguida, ele salva o objeto de ponto de interrupção na variável $B.

O segundo comando usa o cmdlet Disable-PSBreakpoint para desabilitar o novo ponto de interrupção. Ele usa um operador de pipeline (|) para enviar o objeto de ponto de interrupção em $B para o cmdlet Disable-PSBreakpoint.

Como resultado desse comando, o valor da propriedade Enabled do objeto de ponto de interrupção no $B é False.

PS C:\> Disable-PSBreakpoint -Id 0

Este comando desativa o ponto de interrupção com ID de ponto de interrupção 0.

PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B

Este comando cria um novo ponto de interrupção que é desativado até que você habilitá-lo.

Ele usa o cmdlet Disable-PSBreakpoint para desabilitar o ponto de interrupção. O valor do parâmetro Breakpoint é um comando Set-PSBreakpoint que define um novo ponto de interrupção, gera um objeto de ponto de interrupção e salva o objeto na variável $B.

Os parâmetros de cmdlet que tomam objetos como seus valores podem aceitar uma variável que contém o objeto ou um comando que obtém ou gera o objeto. Nesse caso, como Set-PSBreakpoint gera um objeto de ponto de interrupção, ele pode ser usado como o valor do parâmetro Breakpoint.

O segundo comando exibe o objeto de ponto de interrupção no valor da variável $B.

PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint

Este comando desativa todos os pontos de interrupção no console atual. Você pode abreviar este comando como: "gbp | DBP".

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Você pode canalizar um objeto de ponto de interrupção para Disable-PSBreakpoint.

Quando você usa o parâmetro PassThru, Disable-PSBreakpoint retorna um objeto que representa o ponto de interrupção desabilitado. Caso contrário, esse cmdlet não gerará nenhuma saída.