Remove-PSBreakpoint

Artigo
10/30/2009

Exclui os pontos de interrupção do console atual.

Sintaxe

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

Remove-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-Confirm] [-WhatIf] [<CommonParameters>]

Descrição

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.

Ao remover um ponto de interrupção, o objeto de ponto de interrupção não fica 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 de vários cmdlets criados para depurar scripts do Windows PowerShell. Para obter mais informações sobre o depurador do Windows PowerShell, consulte about_Debuggers.

Parâmetros

-Breakpoint <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 os objetos de ponto de interrupção, como o comando Get-PSBreakpoint. Também é possível canalizar objetos de ponto de interrupção para Remove-PSBreakpoint.

Necessário?	true
Posição?	1
Valor padrão	Nenhum
Aceitar entrada do pipeline?	true (ByValue)
Aceitar caracteres curinga?	false

-Id <Int32[]>

Exclui os pontos de interrupção com as IDs de ponto de interrupção especificadas.

Necessário?	true
Posição?	1
Valor padrão	Nenhum
Aceitar entrada do pipeline?	true (ByPropertyName)
Aceitar caracteres curinga?	false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?	false
Posição?	named
Valor padrão
Aceitar entrada do pipeline?	false
Aceitar caracteres curinga?	false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Management.Automation.Breakpoint

Você pode canalizar objetos de ponto de interrupção para Remove-PSBreakpoint.

Saídas

Nenhum

O cmdlet não gera saída.

Exemplo 1

C:\PS>get-breakpoint | remove-breakpoint

Descrição
-----------
Esse comando exclui todos os pontos de interrupção do console atual.

Exemplo 2

C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable Name

C:\PS> $b | remove-psbreakpoint

Descrição
-----------
Este 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 o operador de pipeline (|) para enviar o objeto de ponto de interrupção na variável $b para o cmdlet Remove-PSBreakpoint.

Como resultado deste comando, se você executar o script, ele será executado sem parar até ser concluído. Além disso, o cmdlet Get-PSBreakpoint não retorna este ponto de interrupção.

Exemplo 3

C:\PS>remove-psbreakpoint -id 2

Descrição
-----------
Esse comando exclui o ponto de interrupção com ID de ponto de interrupção 2.

Exemplo 4

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

Descrição
-----------
Essa função simples exclui todos os pontos de interrupção do 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.

Consulte também

Conceitos

about_Debuggers
Set-PSBreakpoint
Get-PSBreakpoint
Enable-PSBreakpoint
Disable-PSBreakpoint
Get-PSCallStack

Compartilhar via