Remove-PSBreakpoint
Exclui os pontos de interrupção do console atual.
Syntax
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 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
PS C:\> Get-PSBreakpoint | Remove-PSBreakpoint
Esta função 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 é executado sem parar até a conclusão. 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
Este 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 }
Esta 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 PowerShell.
Parâmetros
-Breakpoint
Especifica os pontos de interrupção a excluir. Insira uma variável que contém 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.
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
Especifica as IDs do ponto de interrupção para as quais esse cmdlet exclui pontos de interrupção.
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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
Você pode canalizar objetos de ponto de interrupção para Remove-PSBreakpoint.
Saídas
None
O cmdlet não gera nenhuma saída.