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[]>
       [-Runspace <Runspace>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

O Disable-PSBreakpoint cmdlet desabilita pontos de interrupção, o que garante que eles não sejam atingidos quando o script é executado. Você pode usá-lo para desabilitar todos os pontos de interrupção ou pode especificar os 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 reabilitar 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 $B objeto de ponto de interrupção na 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: Desabilitar um ponto de interrupção

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

Disable-PSBreakpoint -Id 0

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

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

Parâmetros de cmdlet que usam objetos como seus valores podem aceitar uma variável que contém o objeto ou um comando que recebe ou gera o objeto. Nesse caso, como Set-PSBreakpoint o gera um objeto de ponto de interrupção, ele pode ser usado como o valor do parâmetro Ponto de interrupção.

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

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

`Get-PSBreakpoint` | Disable-PSBreakpoint

Exemplo 5: Desabilitar um ponto de interrupção em um runspace

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

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 para desabilitar. 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[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

Solicita sua 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

Desabilita os pontos de interrupção com as IDs de ponto de interrupção especificados. Insira as IDs ou uma variável que contém as IDs. Não é possível canalizar 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 os pontos de interrupção habilitados. Por padrão, este cmdlet não gera saída.

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

-Runspace

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

Esse parâmetro foi adicionado no PowerShell 7.2.

Tipo:Runspace
Aliases:RunspaceId
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
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 esse 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.

Observações

O PowerShell inclui os seguintes aliases para Disable-PSBreakpoint:

  • Todas as plataformas:
    • dbp