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 |
None 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".
See Also