Disable-PSBreakpoint
Desabilita os pontos de interrupção no console atual.
Syntax
Disable-PSBreakpoint
[-PassThru]
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Disable-PSBreakpoint
[-PassThru]
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O Disable-PSBreakpoint
cmdlet desabilita os pontos de interrupção, o que garante que eles não sejam atingidos quando o script for executado. Você pode usá-lo para desabilitar todos os pontos de interrupção ou pode especificar os pontos de interrupção enviando objetos de ponto de interrupção ou IDs de ponto de interrupção.
Tecnicamente, esse cmdlet altera o valor da propriedade Enabled de um objeto de ponto de interrupção para False.
Para reativar um ponto de interrupção, use o Enable-PSBreakpoint
cmdlet. Os pontos de interrupção são habilitados por padrão quando você os cria usando o Set-PSBreakpoint
cmdlet.
Um ponto de interrupção é um ponto em um script onde a execução para temporariamente para que você possa examinar as instruções no script. Disable-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: Definir um ponto de interrupção e desativá-lo
Esses comandos desabilitam um ponto de interrupção recém-criado.
$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-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 Disable-PSBreakpoint
cmdlet desabilita o novo ponto de interrupção. Ele usa um operador de pipeline (|
) para enviar o objeto $B
de ponto de interrupção para o Disable-PSBreakpoint
cmdlet.
Como resultado desse comando, o valor da propriedade Enabled do objeto de ponto de interrupção em $B
é False.
Exemplo 2: Desabilitar um ponto de interrupção
Este comando desabilita o ponto de interrupção com a ID do ponto de interrupção 0.
Disable-PSBreakpoint -Id 0
Exemplo 3: Criar um ponto de interrupção desabilitado
Este comando cria um novo ponto de interrupção que será desabilitado até você habilitá-lo.
Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
Ele usa o Disable-PSBreakpoint
cmdlet para desabilitar o ponto de interrupção. O valor do parâmetro Breakpoint é um Set-PSBreakpoint
comando que define um novo ponto de interrupção, gera um objeto de ponto de interrupção e salva o $B
objeto na variável.
Parâmetros de cmdlet que usam objetos como seus valores podem aceitar uma variável que contém o objeto ou um comando que recebe ou gera o objeto. Nesse caso, como Set-PSBreakpoint
gera um objeto de ponto de interrupção, ele pode ser usado como o valor do parâmetro Breakpoint .
Exemplo 4: Desabilitar todos os pontos de interrupção no console atual
Este comando desabilita todos os pontos de interrupção no console atual.
`Get-PSBreakpoint` | Disable-PSBreakpoint
Parâmetros
-Breakpoint
Especifica os pontos de interrupção para desabilitar. 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 o Disable-PSBreakpoint
cmdlet.
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
Desabilita os pontos de interrupção com as IDs de ponto de interrupção especificados. Insira as IDs ou uma variável que contém as IDs. Não é possível canalizar IDs para Disable-PSBreakpoint
o .
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Retorna um objeto que representa os pontos de interrupção habilitados. Por padrão, este cmdlet não gera saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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 um objeto de ponto de interrupção para esse cmdlet.
Saídas
None
Por padrão, esse cmdlet não retorna nenhuma saída.
Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto de ponto de interrupção que representa o ponto de interrupção desabilitado.
Observações
O Windows PowerShell inclui os seguintes aliases para Disable-PSBreakpoint
:
dbp
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