Remove-PSBreakpoint

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

Exclui pontos de interrupção do console atual.

Sintaxe

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

Description

O Remove-PSBreakpoint cmdlet exclui um ponto de interrupção. Insira um objeto de ponto de interrupção ou uma ID de ponto de interrupção.

Quando você remove um ponto de interrupção, o objeto de ponto de interrupção não está mais disponível ou funcional. Se você salvou um objeto de ponto de interrupção em uma variável, a referência ainda existe, mas o ponto de interrupção não funciona.

Remove-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: Remover todos os pontos de interrupção

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

Get-PSBreakpoint | Remove-PSBreakpoint

Exemplo 2: Remover um ponto de interrupção especificado

Este comando exclui um ponto de interrupção.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
$B | Remove-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 Remove-PSBreakpoint cmdlet exclui o novo ponto de interrupção. Ele usa um operador de pipeline (|) para enviar o objeto de ponto de interrupção na $B variável para o Remove-PSBreakpoint cmdlet.

Como resultado desse comando, se você executar o script, ele será executado até a conclusão sem parar. Além disso, o Get-PSBreakpoint cmdlet não retorna esse ponto de interrupção.

Exemplo 3: Remover um ponto de interrupção por ID

Este comando exclui o ponto de interrupção com ID de ponto de interrupção 2.

Remove-PSBreakpoint -Id 2

Exemplo 4: Usar uma função para remover todos os pontos de interrupção

Esta função simples exclui todos os pontos de interrupção na sessão atual.

function del-psb { Get-PSBreakpoint | Remove-PSBreakpoint }

Ele usa o Get-PSBreakpoint cmdlet para obter os pontos de interrupção. Em seguida, ele usa um operador de pipeline (|) para enviar os pontos de interrupção para o Remove-PSBreakpoint cmdlet, que os exclui.

Exemplo 5: Remover 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 do é canalizada para Remove-PSBreakpoint remover o ponto de Get-PSBreakPoint interrupção no espaço de execução.

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

$runspace = Get-Runspace -Id 1

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

Parâmetros

-Breakpoint

Especifica os pontos de interrupção a serem excluídos. 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 Remove-PSBreakpoint.

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

Especifica IDs de ponto de interrupção para as quais este cmdlet exclui pontos de interrupção.

Tipo:Int32[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
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 objetos de ponto de interrupção para este cmdlet.

Int32[]

Runspace

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

O PowerShell inclui os seguintes aliases para Remove-PSBreakpoint:

  • Todas as plataformas:
    • rbp