Partilhar via

Enable-PSBreakpoint

Módulo:
Microsoft.PowerShell.Utility Module

Habilita os pontos de interrupção no console atual.

Sintaxe

Id (Predefinição) 

Enable-PSBreakpoint
    [-Id] <Int32[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Breakpoint 

Enable-PSBreakpoint
    [-Breakpoint] <Breakpoint[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Enable-PSBreakpoint reativa pontos de interrupção desabilitados. Você pode usá-lo para habilitar todos os pontos de interrupção ou pontos de interrupção específicos fornecendo objetos ou IDs de ponto de interrupção.

Um ponto de interrupção é um ponto em um script onde a execução para temporariamente para que você possa examinar o estado do script. Os pontos de interrupção recém-criados são ativados automaticamente, mas podem ser desativados usando Disable-PSBreakpoint.

Tecnicamente, esse cmdlet altera o valor da propriedade Enabled de um objeto de ponto de interrupção para True.

Enable-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: Ativar todos os pontos de interrupção

Este exemplo habilita todos os pontos de interrupção na sessão atual.

Get-PSBreakpoint | Enable-PSBreakpoint

Usando aliases, este exemplo pode ser abreviado como gbp | ebp.

Exemplo 2: Ativar pontos de interrupção por ID

Este exemplo habilita vários pontos de interrupção usando suas IDs de ponto de interrupção.

Enable-PSBreakpoint -Id 0, 1, 5

Exemplo 3: Ativar um ponto de interrupção desativado

Este exemplo reativa um ponto de interrupção que foi desabilitado.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable Name -PassThru
$B | Enable-PSBreakpoint -PassThru

AccessMode : Write
Variable   : Name
Action     :
Enabled    : False
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

AccessMode : Write
Variable   : Name
Action     :
Enabled    : True
HitCount   : 0
Id         : 0
Script     : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1

Set-PSBreakpoint cria um ponto de interrupção na variável Name no script Sample.ps1 salvando o objeto de ponto de interrupção na variável $B. O parâmetro PassThru exibe o valor da propriedade Enabled do ponto de interrupção é False.

Enable-PSBreakpoint reativa o ponto de interrupção. Novamente, usando o parâmetro PassThru, vemos que o valor da propriedade Enabled é True.

Exemplo 4: Habilitar pontos de interrupção usando uma variável

Este exemplo habilita um conjunto de pontos de interrupção usando os objetos de ponto de interrupção.

$B = Get-PSBreakpoint -Id 3, 5
Enable-PSBreakpoint -Breakpoint $B

Get-PSBreakpoint obtém os pontos de interrupção e os salva na variável $B. Usando o parâmetro Breakpoint, Enable-PSBreakpoint habilita os pontos de interrupção.

Este exemplo é equivalente à execução Enable-PSBreakpoint -Id 3, 5.

Parâmetros

-Breakpoint

Especifica os pontos de interrupção a serem habilitados. Forneça uma variável contendo pontos de interrupção ou um comando que obtenha objetos de ponto de interrupção, como Get-PSBreakpoint. Você também pode canalizar objetos de ponto de interrupção para Enable-PSBreakpoint.

Propriedades dos parâmetros

Tipo:

Breakpoint[]

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 os números de de ID de dos pontos de interrupção a serem habilitados. O valor padrão é todos os pontos de interrupção. Forneça o Id por número ou em uma variável. Não é possível canalizar Id números para Enable-PSBreakpoint. Para localizar o de Id de de um ponto de interrupção, use o cmdlet .

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

-PassThru

Retorna um objeto que representa o ponto de interrupção que está sendo habilitado. Por padrão, esse cmdlet não gera nenhuma saída.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

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

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

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

Breakpoint

Quando você usa o parâmetro PassThru, esse cmdlet retorna um objeto de ponto de interrupção que representa o ponto de interrupção habilitado.

Notas

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

  • ebp

  • O cmdlet Enable-PSBreakpoint não gerará um erro se você tentar habilitar um ponto de interrupção que já esteja habilitado. Como tal, pode ativar todos os pontos de interrupção sem erros, mesmo quando apenas alguns estão desativados.

  • Os pontos de interrupção são habilitados quando você os cria usando o cmdlet Set-PSBreakpoint. Não é necessário ativar os pontos de interrupção recém-criados.