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 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 depuração de 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
Esta função 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 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 é executado sem parar até a conclusão. 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 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
Esta função simples exclui todos os pontos de interrupção no console 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.
Parâmetros
-Breakpoint
Especifica os pontos de interrupção a excluir. 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
.
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 IDs de ponto de interrupção para os 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 esse cmdlet.
Int32[]
Saídas
None
Esse cmdlet não retorna nenhuma saída.
Observações
O Windows PowerShell inclui os seguintes aliases para Remove-PSBreakpoint
:
rbp
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de