Enable-PSBreakpoint

Module:

Microsoft.PowerShell.Utility Module

Active les points d’arrêt dans la console active.

Syntaxe

Breakpoint (Par défaut)

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

Id

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

Description

L’applet de commande Enable-PSBreakpoint réactive les points d’arrêt désactivés. Vous pouvez l’utiliser pour activer tous les points d’arrêt ou des points d’arrêt spécifiques en fournissant des objets de point d’arrêt ou des ID.

Un point d’arrêt est un point dans un script où l’exécution s’arrête temporairement afin que vous puissiez examiner l’état du script. Les points d’arrêt nouvellement créés sont automatiquement activés, mais peuvent être désactivés à l’aide de Disable-PSBreakpoint.

Techniquement, cette applet de commande modifie la valeur de la propriété Enabled d’un objet point d’arrêt en True.

Enable-PSBreakpoint est l’une des applets de commande conçues pour le débogage de scripts PowerShell. Pour plus d’informations sur le débogueur PowerShell, consultez about_Debuggers.

Exemples

Exemple 1 : Activer tous les points d’arrêt

Cet exemple active tous les points d’arrêt dans la session active.

Get-PSBreakpoint | Enable-PSBreakpoint

À l’aide d’alias, cet exemple peut être abrégé en tant que gbp | ebp.

Exemple 2 : Activer les points d’arrêt par ID

Cet exemple active plusieurs points d’arrêt à l’aide de leurs ID de point d’arrêt.

Enable-PSBreakpoint -Id 0, 1, 5

Exemple 3 : Activer un point d’arrêt désactivé

Cet exemple montre comment réactiver un point d’arrêt qui a été désactivé.

$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

crée un point d’arrêt sur la variable Name dans le script enregistrant l’objet de point d’arrêt dans la variable . Le paramètre passThru affiche la valeur de la propriété Enabled du point d’arrêt est False.

Enable-PSBreakpoint réactive le point d’arrêt. Là encore, en utilisant le paramètre PassThru , nous voyons que la valeur de la propriété Enabled est True.

Exemple 4 : Activer les points d’arrêt à l’aide d’une variable

Cet exemple active un ensemble de points d’arrêt à l’aide des objets de point d’arrêt.

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

Get-PSBreakpoint obtient les points d’arrêt et les enregistre dans la variable $B. À l’aide du paramètre point d’arrêt , active les points d’arrêt.

Cet exemple équivaut à exécuter Enable-PSBreakpoint -Id 3, 5.

Exemple 5 : Activer un point d’arrêt dans un espace d’exécution

Dans cet exemple, un travail est démarré avec un point d’arrêt est défini pour arrêter, puis désactivé. L’espace d’exécution est stocké dans une variable et transmis à la commande Get-PSBreakpoint avec le paramètre Runspace. La sortie est Get-PSBreakpoint redirigée pour Enable-PSBreakpoint activer le point d’arrêt dans l’espace d’exécution.

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

Paramètres

-Breakpoint

Spécifie les points d’arrêt à activer. Fournissez une variable contenant des points d’arrêt ou une commande qui obtient des objets de point d’arrêt, tels que Get-PSBreakpoint. Vous pouvez également diriger des objets de point d’arrêt vers Enable-PSBreakpoint.

Propriétés du paramètre

Type:	Breakpoint[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Breakpoint

Position:	0
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Id

Spécifie l’ID nombres des points d’arrêt à activer. La valeur par défaut est tous les points d’arrêt. Indiquez l’ID de par nombre ou dans une variable. Vous ne pouvez pas diriger numéros d’id vers Enable-PSBreakpoint. Pour rechercher l’ID d’un point d’arrêt, utilisez l’applet de commande Get-PSBreakpoint.

Propriétés du paramètre

Type:	Int32[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Id

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-PassThru

Retourne un objet représentant le point d’arrêt activé. Par défaut, cette applet de commande ne génère aucune sortie.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Runspace

Spécifie l’ID d’un objet Runspace afin de pouvoir interagir avec des points d’arrêt dans l’espace d’exécution spécifié.

Ce paramètre a été ajouté dans PowerShell 7.2.

Propriétés du paramètre

Type:	Runspace
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	RunspaceId

Jeux de paramètres

Id

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

Breakpoint

Vous pouvez diriger un objet de point d’arrêt vers cette applet de commande.

Sorties

None

Par défaut, cette applet de commande ne retourne aucune sortie.

Breakpoint

Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne un objet de point d’arrêt représentant le point d’arrêt activé.

Notes

PowerShell inclut les alias suivants pour Enable-PSBreakpoint:

• Toutes les plateformes :

  • ebp

• L’applet de commande Enable-PSBreakpoint ne génère pas d’erreur si vous essayez d’activer un point d’arrêt déjà activé. Par conséquent, vous pouvez activer tous les points d’arrêt sans erreur, même si seuls quelques-uns sont désactivés.

• Les points d’arrêt sont activés lorsque vous les créez à l’aide de l’applet de commande Set-PSBreakpoint. Vous n’avez pas besoin d’activer les points d’arrêt nouvellement créés.

Liens associés

• Disable-PSBreakpoint
• Get-PSBreakpoint
• Get-PSCallStack
• Remove-PSBreakpoint
• Set-PSBreakpoint