Compartilhar via

Remove-PSBreakpoint

Módulo:
Microsoft.PowerShell.Utility Module

Exclui pontos de interrupção do console atual.

Sintaxe

Breakpoint (Default) 

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

Id 

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

Exemplos

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

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

Get-PSBreakpoint | Remove-PSBreakpoint

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

Esse comando exclui um ponto de interrupção.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
$B | Remove-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 Remove-PSBreakpoint exclui 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

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

Remove-PSBreakpoint -Id 2

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

Essa função simples exclui todos os pontos de interrupção no console atual.

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

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.

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.

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

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

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

-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 redirecionar objetos de ponto de interrupção para este cmdlet.

Int32

Runspace

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

O Windows PowerShell inclui os seguintes aliases para Remove-PSBreakpoint:

  • rbp