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