Compartilhar via

Enable-PSBreakpoint

Módulo:
Microsoft.PowerShell.Utility Module

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

Sintaxe

Id (Default) 

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

Breakpoint 

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

Description

O cmdlet Enable-PSBreakpoint habilita novamente 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 de ponto de interrupção ou IDs.

Um ponto de interrupção é um ponto em um script em que a execução é interrompida temporariamente para que você possa examinar o estado do script. Os pontos de interrupção recém-criados são habilitados automaticamente, mas podem ser desabilitados 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: Habilitar 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: Habilitar pontos de interrupção por ID

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

Enable-PSBreakpoint -Id 0, 1, 5

Exemplo 3: Habilitar um ponto de interrupção desabilitado

Este exemplo habilita novamente 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

cria um ponto de interrupção na variável nome do no script salvando o objeto de ponto de interrupção na variável . O parâmetro PassThru exibe o valor da propriedade habilitada do ponto de interrupção é False.

Enable-PSBreakpoint habilita novamente o ponto de interrupção. Novamente, usando o parâmetro PassThru, vemos que o valor da propriedade habilitada para é 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 do ponto de interrupção , habilita os pontos de interrupção.

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

Parâmetros

-Breakpoint

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

Propriedades do parâmetro

Tipo:

Breakpoint[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Breakpoint
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Id

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

Propriedades do parâmetro

Tipo:

Int32[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Id
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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 do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 Enable-PSBreakpoint.

Saídas

None or System.Management.Automation.Breakpoint

Quando você usa o parâmetro PassThru, Enable-PSBreakpoint retorna um objeto de ponto de interrupção que representa esse ponto de interrupção que foi habilitado. Caso contrário, esse cmdlet não gerará nenhuma saída.

Observações

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

  • Os pontos de interrupção são habilitados quando você os cria usando o cmdlet Set-PSBreakpoint. Você não precisa habilitar pontos de interrupção recém-criados.