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

Sintaxe

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

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

Descrição

O cmdlet Enable-PSBreakpoint reabilita pontos de interrupção desabilitados. É possível usá-lo para habilitar todos os pontos de interrupção ou especificar pontos de interrupção enviando 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 as instruções no script. Pontos de interrupção recém-criados são habilitados automaticamente, mas não é possível desabilitá-los usando o cmdlet Disable-PSBreakpoint.

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

Enable-PSBreakpoint é um de vários cmdlets criados para depurar scripts do Windows PowerShell. Para obter mais informações sobre o depurador do Windows PowerShell, consulte about_Debuggers.

Parâmetros

-Breakpoint <Breakpoint[]>

Especifica os pontos de interrupção a serem habilitados. Insira uma variável que contenha objetos de ponto de interrupção ou um comando que obtenha os objetos de ponto de interrupção, como o comando Get-PSBreakpoint. Também é possível canalizar objetos de ponto de interrupção para Enable-PSBreakpoint.

Necessário?

true

Posição?

1

Valor padrão

None.

Aceitar entrada do pipeline?

true (ByValue)

Aceitar caracteres curinga?

false

-Id <Int32[]>

Habilita pontos de interrupção que têm as IDs de ponto de interrupção especificadas. O valor padrão é todos os pontos de interrupção. Insira as IDs ou uma variável que contenha as IDs. (Não é possível canalizar IDs para o Enable-PSBreakpoint.) Para localizar a ID de um ponto de interrupção, use o cmdlet Get-PSBreakpoint.

Necessário?

true

Posição?

1

Valor padrão

nenhum

Aceitar entrada do pipeline?

true (ByPropertyName)

Aceitar caracteres curinga?

false

-PassThru

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

Necessário?

false

Posição?

named

Valor padrão

No output

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Management.Automation.Breakpoint

É possível canalizar um objeto de ponto de interrupção para o Enable-PSBreakpoint.

Saídas

None ou System.Management.Automation.Breakpoint

Quando você usar o parâmetro PassThru, Enable-PSBreakpoint retornará um objeto de ponto de interrupção que representa o ponto de interrupção habilitado. Caso contrário, esse cmdlet não gera 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á esteja habilitado. Dessa forma, é possível habilitar todos os pontos de interrupção sem erro, mesmo quando apenas alguns estiverem desabilitados.

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

Exemplo 1

C:\PS>get-psbreakpoint | enable-psbreakpoint

Descrição
-----------
Esse comando habilita todos os pontos de interrupção no console atual. É possível abreviar o comando como: "gbp | ebp".






Exemplo 2

C:\PS>enable-psbreakpoint -id 0, 1, 5

Descrição
-----------
Esse comando habilita pontos de interrupção com IDs de ponto de interrupção 0, 1 e 5.






Exemplo 3

C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable Name

C:\PS> $b | disable-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

C:\PS> $b | enable-psbreakpoint -passthru

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

Descrição
-----------
Esses comandos reabilitam um ponto de interrupção que foi desabilitado.

O primeiro comando usa o cmdlet Set-PSBreakpoint para criar um ponto de interrupção na variável "Name" no script Sample.ps1. Em seguida, ele salva o objeto de ponto de interrupção na variável $b.

O segundo comando usa o cmdlet Disable-PSBreakpoint para desabilitar o novo ponto de interrupção. Ele usa um operador de pipeline (|) para enviar o objeto de ponto de interrupção em $b ao cmdlet Disable-PSBreakpoint e usa o parâmetro PassThru do Disable-PSBreakpoint para exibir o objeto de ponto de interrupção desabilitado. Isso permite verificar se o valor da propriedade Enabled do objeto de ponto de interrupção é False.

O terceiro comando usa o cmdlet Enable-PSBreakpoint para reabilitar o ponto de interrupção. Ele usa um operador de pipeline (|) para enviar o objeto de ponto de interrupção em $b ao cmdlet Enable-PSBreakpoint e usa o parâmetro PassThru do Enable-PSBreakpoint para exibir o objeto de ponto de interrupção. Isso permite verificar se o valor da propriedade Enabled do objeto de ponto de interrupção é True.

Os resultados são mostrados na saída de exemplo a seguir.






Exemplo 4

C:\PS>$b = get-psbreakpoint -id 3, 5

C:\PS> enable-psbreakpoint -breakpoint $b

Descrição
-----------
Esses comandos habilitam um conjunto de pontos de interrupção especificando seus objetos de ponto de interrupção. 

O primeiro comando usa o cmdlet Get-PSBreakpoint para obter os pontos de interrupção e os salva na variável $b. 

O segundo comando usa o cmdlet Enable-PSBreakpoint e seu parâmetro Breakpoint para habilitar os pontos de interrupção.
Esse comando é equivalente a "enable-psbreakpoint -id 3, 5".






See Also




Sumário