Compartilhar via

Disable-PSBreakpoint

Módulo:
Microsoft.PowerShell.Utility Module

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

Exemplos

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

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

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

O cmdlet Set-PSBreakpoint cria um ponto de interrupção na variável $Name no script Sample.ps1 e salva o objeto de ponto de interrupção na variável $B. O cmdlet Disable-PSBreakpoint desabilita 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

Esse 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

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

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

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.

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 do ponto de interrupção.

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

Esse 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

Neste exemplo, um trabalho é iniciado e um ponto de interrupção é definido para ser interrompido quando o Set-PSBreakPoint é executado. O runspace é armazenado em uma variável e passado para o comando Get-PSBreakPoint com o parâmetro Runspace. A saída de Get-PSBreakPoint é canalizada para Disable-PSBreakpoint para 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 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

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 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 os pontos de interrupção habilitados. 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

-Runspace

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

Esse parâmetro foi adicionado ao PowerShell 7.2.

Propriedades do parâmetro

Tipo:Runspace
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:RunspaceId

Conjuntos de parâmetros

Id
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
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 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.

Observações

O PowerShell inclui os seguintes aliases para Disable-PSBreakpoint:

  • Todas as plataformas:
    • dbp