Compartilhar via

Disable-PSBreakpoint

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

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

Syntax

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

Description

O cmdlet Disable-PSBreakpoint 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 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 cmdlet Enable-PSBreakpoint. Pontos de interrupção estão habilitados por padrão ao criá-los 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. 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

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

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

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

PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B

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

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 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 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: Desabilitar todos os pontos de interrupção no console atual

PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint

Este 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 para desabilitar. Insira uma variável que contém objetos de ponto de interrupção ou um comando que obtém os objetos de ponto de interrupção, como um comando Get-PSBreakpoint. Você também pode canalizar objetos de ponto de interrupção para o cmdlet Disable-PSBreakpoint .

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 redirecionar IDs para Disable-PSBreakpoint.

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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 PassThru , Disable-PSBreakpoint retorna um objeto que representa o ponto de interrupção desabilitado. Caso contrário, este cmdlet não gera nenhuma saída.