Condividi tramite

Enable-PSBreakpoint

Modulo:
Microsoft.PowerShell.Utility Module

Abilita i punti di interruzione nella console corrente.

Sintassi

Breakpoint (impostazione predefinita). 

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

Id 

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

Descrizione

Il Enable-PSBreakpoint cmdlet riabilita i punti di interruzione disabilitati. È possibile utilizzarlo per abilitare tutti i punti di interruzione o punti di interruzione specifici fornendo oggetti o ID punto di interruzione.

Un punto di interruzione è un punto in cui l'esecuzione si interrompe temporaneamente in modo che sia possibile esaminare lo stato dello script. I punti di interruzione appena creati vengono abilitati automaticamente, ma possono essere disabilitati utilizzando Disable-PSBreakpoint.

Tecnicamente, questo cmdlet modifica il valore della proprietà Enabled di un oggetto punto di interruzione in True.

Enable-PSBreakpoint è uno dei diversi cmdlet progettati per il debug di script di PowerShell. Per altre informazioni sul debugger di PowerShell, vedere about_Debuggers.

Esempio

Esempio 1: Abilitare tutti i punti di interruzione

In questo esempio vengono abilitati tutti i punti di interruzione nella sessione corrente.

Get-PSBreakpoint | Enable-PSBreakpoint

Utilizzando gli alias, questo esempio può essere abbreviato come gbp | ebp.

Esempio 2: Abilitare i punti di interruzione in base all'ID

In questo esempio vengono abilitati più punti di interruzione utilizzando i relativi ID punto di interruzione.

Enable-PSBreakpoint -Id 0, 1, 5

Esempio 3: Abilitare un punto di interruzione disabilitato

In questo esempio viene riabilitato un punto di interruzione che è stato disabilitato.

$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 crea un punto di interruzione sulla variabile Name nello Sample.ps1 script salvando l'oggetto punto di interruzione nella $B variabile. Il parametro PassThru visualizza il valore della proprietà Enabled del punto di interruzione è False.

Enable-PSBreakpoint Riattiva il punto di interruzione. Anche in questo caso, utilizzando il parametro PassThru si nota che il valore della proprietà Enabled è True.

Esempio 4: Abilitare i punti di interruzione utilizzando una variabile

In questo esempio viene abilitato un set di punti di interruzione utilizzando gli oggetti punto di interruzione.

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

Get-PSBreakpoint Ottiene i punti di interruzione e li salva nella $B variabile. Utilizzando il parametro Punto di interruzione , Enable-PSBreakpoint vengono attivati i punti di interruzione.

Questo esempio equivale all'esecuzione Enable-PSBreakpoint -Id 3, 5di .

Esempio 5: Abilitare un punto di interruzione in uno spazio di esecuzione

In questo esempio, un processo viene avviato con un punto di interruzione è impostato su break e quindi disabilitato. Lo spazio di esecuzione viene memorizzato in una variabile e passato al comando Get-PSBreakpoint con il parametro Runspace. L'output di viene inviato tramite pipe a Enable-PSBreakpoint per abilitare il punto di Get-PSBreakpoint interruzione nello spazio di esecuzione.

Start-Job -ScriptBlock {
    $bp = Set-PSBreakpoint -Command Start-Sleep
    Disable-PSBreakpoint $bp
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakpoint -Runspace $runspace | Enable-Breakpoint -Runspace $runspace

Parametri

-Breakpoint

Specifica i punti di interruzione da abilitare. Fornisci una variabile contenente punti di interruzione o un comando che ottiene oggetti punto di interruzione, ad esempio Get-PSBreakpoint. È anche possibile trasmettere oggetti di punto di interruzione a Enable-PSBreakpoint.

Proprietà dei parametri

Tipo:

Breakpoint[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Breakpoint
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Id

Specifica i numeri ID dei punti di interruzione da abilitare. Il valore predefinito è tutti i punti di interruzione. Fornisci l'ID per numero o in una variabile. Non è possibile reindirizzare i numeri ID a Enable-PSBreakpoint. Per trovare l'ID di un punto di interruzione, usare il Get-PSBreakpoint cmdlet.

Proprietà dei parametri

Tipo:

Int32[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Id
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-PassThru

Restituisce un oggetto che rappresenta il punto di interruzione abilitato. Per impostazione predefinita, questo cmdlet non genera alcun output.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Runspace

Specifica l'ID di un oggetto Runspace in modo da poter interagire con i punti di interruzione nello spazio di esecuzione specificato.

Questo parametro è stato aggiunto in PowerShell 7.2.

Proprietà dei parametri

Tipo:Runspace
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:RunspaceId

Set di parametri

Id
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

Breakpoint

È possibile inviare tramite pipe un oggetto punto di interruzione a questo cmdlet.

Output

None

Per impostazione predefinita, questo cmdlet non restituisce alcun output.

Breakpoint

Quando si usa il parametro PassThru , questo cmdlet restituisce un oggetto punto di interruzione che rappresenta il punto di interruzione abilitato.

Note

PowerShell include gli alias seguenti per Enable-PSBreakpoint:

  • Tutte le piattaforme:

    • ebp

  • Il Enable-PSBreakpoint cmdlet non genera un errore se si tenta di abilitare un punto di interruzione già abilitato. Di conseguenza, è possibile abilitare tutti i punti di interruzione senza errori, anche quando solo alcuni sono disabilitati.

  • I punti di interruzione vengono abilitati quando vengono creati utilizzando il Set-PSBreakpoint cmdlet. Non è necessario abilitare i punti di interruzione appena creati.