Compartilhar via

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

Description

O cmdlet Remove-PSBreakpoint 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 existirá, mas o ponto de interrupção não funcionará.

Remove-PSBreakpoint é um dos vários cmdlets projetados para depurar scripts do Windows PowerShell. Para obter mais informações sobre o depurador do Windows PowerShell, consulte about_Debuggers.

Exemplos

Exemplo 1: remover todos os pontos de interrupção

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

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

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

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
PS C:\> $B | Remove-PSBreakpoint

Esse comando exclui um ponto de interrupção.

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 Remove-PSBreakpoint para excluir o novo ponto de interrupção. Ele usa um operador de pipeline (|) para enviar o objeto de ponto de interrupção na variável $B para o cmdlet Remove-PSBreakpoint.

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

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

PS C:\> Remove-PSBreakpoint -Id 2

Esse comando exclui o ponto de interrupção com a ID do ponto de interrupção 2.

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

PS C:\> function del-psb { get-psbreakpoint | remove-psbreakpoint }

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

Como resultado, você pode digitar del-psb em vez do comando mais longo.

Para salvar a função, adicione-a ao seu perfil do Windows PowerShell.

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

Tipo:Breakpoint[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

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

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

Tipo:Int32[]
Cargo:0
Valor padrão:None
Obrigatório:True
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 objetos de ponto de interrupção para Remove-PSBreakpoint.

Saídas

None

O cmdlet não gera nenhuma saída.