Disable-PSBreakpoint

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

Sintaxe

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

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

Descrição

O cmdlet Disable-PSBreakpoint desabilita pontos de interrupção, o que garante que eles não sejam atingidos durante a execução do script. É possível usá-lo para desabilitar todos os pontos de interrupção ou especificar pontos de interrupção enviando objetos 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 reabilitar um ponto de interrupção, use o cmdlet Enable-PSBreakpoint. Por padrão, os pontos de interrupção são habilitados quando você os criar 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. O Disable-PSBreakpoint é um dos vários cmdlets criados para depuração de scripts do Windows PowerShell. Para obter mais informações sobre o depurador do Windows PowerShell, consulte about_Debuggers.

Parâmetros

-Breakpoint <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 obtenha os objetos de ponto de interrupção, como o comando Get-PSBreakpoint. Também é possível canalizar objetos de ponto de interrupção para o cmdlet Disable-PSBreakpoint.

Necessário?	true
Posição?	1
Valor padrão	Nenhum
Aceitar entrada do pipeline?	true (ByValue)
Aceitar caracteres curinga?	false

-Id <Int32[]>

Desabilita os pontos de interrupção com as IDs de ponto de interrupção especificadas. Insira as IDs ou uma variável que contenha as IDs. Não é possível canalizar IDs para o Disable-PSBreakpoint.

Necessário?	true
Posição?	1
Valor padrão
Aceitar entrada do pipeline?	true (ByPropertyName)
Aceitar caracteres curinga?	false

-PassThru

Retorna um objeto que representa os pontos de interrupção habilitados. Por padrão, este cmdlet não gera nenhuma saída.

Necessário?	false
Posição?	named
Valor padrão	Nenhum
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas	System.Management.Automation.Breakpoint É possível canalizar um objeto de ponto de interrupção para o Disable-PSBreakpoint.
Saídas	Nenhum ou System.Management.Automation.Breakpoint Quando você usar o parâmetro PassThru, Disable-PSBreakpoint retornará um objeto que representa o ponto de interrupção desabilitado. Caso contrário, esse cmdlet não gera nenhuma saída.

Exemplo 1

C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable name

C:\PS> $b | disable-psbreakpoint

Descrição
-----------
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 ao cmdlet Disable-PSBreakpoint.

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

Exemplo 2

C:\PS>disable-psbreakpoint -id 0

Descrição
-----------
Esse comando desabilita o ponto de interrupção com ID de ponto de interrupção 0.

Exemplo 3

C:\PS>disable-psbreakpoint -breakpoint ($b = set-psbreakpoint -script sample.ps1 -line 5) 

C:\PS> $b

Descrição
-----------
Esse comando cria um novo ponto de interrupção que é desabilitado até que você o habilite.

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 usam objetos como seus valores podem aceitar uma variável que contenha o objeto ou um comando que obtenha ou gere o objeto. Nesse caso, como o 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.

Exemplo 4

C:\PS>get-psbreakpoint | disable-psbreakpoint

Descrição
-----------
Esse comando desabilita todos os pontos de interrupção no console atual. É possível abreviar esse comando como: "gbp | dbp".

Consulte também

Conceitos

about_Debuggers
Set-PSBreakpoint
Get-PSBreakpoint
Enable-PSBreakpoint
Remove-PSBreakpoint
Get-PSCallStack