Disable-PSBreakpoint

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

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

Sintaxe

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

Description

O Disable-PSBreakpoint cmdlet desabilita os 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 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 Enable-PSBreakpoint cmdlet. Os pontos de interrupção são habilitados por padrão quando você os cria usando o Set-PSBreakpoint cmdlet.

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 PowerShell. Para obter mais informações sobre o depurador do PowerShell, consulte about_Debuggers.

Exemplos

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

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

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint

O Set-PSBreakpoint cmdlet cria um ponto de interrupção na $Name variável no Sample.ps1 script e salva o objeto de ponto de interrupção na $B variável. O Disable-PSBreakpoint cmdlet desabilita o novo ponto de interrupção. Ele usa um operador de pipeline (|) para enviar o objeto $B de ponto de interrupção para o Disable-PSBreakpoint cmdlet.

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

Exemplo 2: Desativar um ponto de interrupção

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

Disable-PSBreakpoint -Id 0

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

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

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

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

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 .

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

Este comando desativa todos os pontos de interrupção no console atual.

`Get-PSBreakpoint` | Disable-PSBreakpoint

Exemplo 5: Desativar um ponto de interrupção em um espaço de execução

Neste exemplo, um trabalho é iniciado e um ponto de interrupção é definido para quebrar quando o Set-PSBreakPoint é executado. O runspace é armazenado em uma variável e passado para o Get-PSBreakPoint comando com o parâmetro Runspace . A saída de é canalizada para Disable-PSBreakpoint desativar o ponto de interrupção no espaço de Get-PSBreakPoint execução.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakPoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace

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 obtenha objetos de ponto de interrupção, como um Get-PSBreakpoint comando. Você também pode canalizar objetos de ponto de interrupção para o Disable-PSBreakpoint cmdlet.

Tipo:Breakpoint[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Id

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

Tipo:Int32[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PassThru

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Runspace

Especifica a Id de um objeto Runspace para que você possa interagir com pontos de interrupção no espaço de execução especificado.

Esse parâmetro foi adicionado no PowerShell 7.2.

Tipo:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

Breakpoint

Você pode canalizar um objeto de ponto de interrupção para este cmdlet.

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

Breakpoint

Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto de ponto de interrupção que representa o ponto de interrupção desabilitado.

Notas

O PowerShell inclui os seguintes aliases para Disable-PSBreakpoint:

  • Todas as plataformas:
    • dbp