Remove-PSBreakpoint
Exclui pontos de interrupção do console atual.
Sintaxe
Breakpoint (Predefinição)
Remove-PSBreakpoint
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Id
Remove-PSBreakpoint
[-Id] <Int32[]>
[-Runspace <Runspace>]
[-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
Este comando exclui todos os pontos de interrupção no console atual.
Get-PSBreakpoint | Remove-PSBreakpoint
Exemplo 2: Remover um ponto de interrupção especificado
Este 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
Este comando exclui o ponto de interrupção com ID de 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 na sessão 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.
Exemplo 5: Remover um ponto de interrupção em um espaço de execução
Neste exemplo, um trabalho é iniciado e um ponto de interrupção é definido para quebrar quando o Set-PSBreakPoint é executado. O runspace é armazenado em uma variável e passado para o comando Get-PSBreakPoint com o parâmetro Runspace. A saída de Get-PSBreakPoint é canalizada para Remove-PSBreakpoint remover o ponto de interrupção no espaço de execução.
Start-Job -ScriptBlock {
Set-PSBreakpoint -Command Start-Sleep
Start-Sleep -Seconds 10
}
$runspace = Get-Runspace -Id 1
Get-PSBreakPoint -Runspace $runspace | Remove-Breakpoint -Runspace $runspace
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 obtenha 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 dos parâmetros
| Tipo: | |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Breakpoint
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Id
Especifica IDs de ponto de interrupção para as quais este cmdlet exclui pontos de interrupção.
Propriedades dos parâmetros
| Tipo: | Int32[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Id
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Runspace
Especifica a Id de um objeto Runspace para que você possa interagir com pontos de interrupção no espaço de execução especificado.
Esse parâmetro foi adicionado no PowerShell 7.2.
Propriedades dos parâmetros
| Tipo: | Runspace |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | RunspaceId |
Conjuntos de parâmetros
Id
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 canalizar objetos de ponto de interrupção para este cmdlet.
Int32
Runspace
Saídas
None
Este cmdlet não retorna nenhuma saída.
Notas
O PowerShell inclui os seguintes aliases para Remove-PSBreakpoint:
- Todas as plataformas:
rbp