Disable-PSBreakpoint
Desabilita os pontos de interrupção no console atual.
Sintaxe
Breakpoint (Default)
Disable-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Disable-PSBreakpoint
[-Id] <Int32[]>
[-PassThru]
[-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
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
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
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.
Propriedades do parâmetro
| Tipo: | Breakpoint[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Breakpoint
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | Int32[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Id
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
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.
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