Compartilhar via

Disable-PSBreakpoint

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Desabilita os pontos de interrupção no console atual.

Sintaxe

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

Description

O cmdlet Disable-PSBreakpoint desabilita pontos de interrupção, o que garante que eles não sejam atingidos quando o script for executado. Você pode usá-lo para desabilitar todos os pontos de interrupção ou 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 habilitar novamente 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 em que a execução é interrompida 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.

Exemplos

Exemplo 1: Definir um ponto de interrupção e desabilitá-lo

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 nome do 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.

Exemplo 2: Desabilitar um ponto de interrupção

PS C:\> Disable-PSBreakpoint -Id 0

Esse comando desabilita o ponto de interrupção com a ID do ponto de interrupção 0.

Exemplo 3: Criar um ponto de interrupção desabilitado

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

Esse comando cria um novo ponto de interrupção que está desabilitado até 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.

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 de ponto de interrupção .

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

Exemplo 4: Desabilitar todos os pontos de interrupção no console atual

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

Esse comando desabilita todos os pontos de interrupção no console atual. Você pode abreviar este comando como: "gbp | dbp".

Parâmetros

-Breakpoint

Especifica os pontos de interrupção a serem desabilitados. Insira uma variável que contenha objetos de ponto de interrupção ou um comando que obtém objetos de ponto de interrupção, como um comando Get-PSBreakpoint. Você também pode redirecionar objetos de ponto de interrupção para o cmdlet Disable-PSBreakpoint.

Tipo:Breakpoint[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica uma matriz de IDs ou variáveis que contém as IDs do ponto de interrupção. Não é possível redirecionar IDs para Disable-PSBreakpoint.

Tipo:Int32[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Breakpoint

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

Saídas

None or System.Management.Automation.Breakpoint

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.