Enable-PSBreakpoint
Active les points d'arrêt dans la console active.
Syntax
Enable-PSBreakpoint
[-PassThru]
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Enable-PSBreakpoint
[-PassThru]
[-Id] <Int32[]>
[-Runspace <Runspace>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet Enable-PSBreakpoint
de commande 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 Disable-PSBreakpoint
de .
Techniquement, cette applet de commande modifie la valeur de la propriété Enabled d’un objet de point d’arrêt sur 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
Set-PSBreakpoint
crée un point d’arrêt sur la variable Name dans le Sample.ps1
script qui enregistre l’objet de point d’arrêt dans la $B
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 $B
variable. À l’aide du paramètre Point d’arrêt, Enable-PSBreakpoint
active les points d’arrêt.
Cet exemple équivaut à l’exécution 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’instance d’exécution est stockée dans une variable et passée à 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
.
Type: | Breakpoint[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Spécifie les numéros d’ID des points d’arrêt à activer. La valeur par défaut est tous les points d'arrêt.
Indiquez l’ID par numéro ou dans une variable. Vous ne pouvez pas diriger les numéros d’ID vers Enable-PSBreakpoint
. Pour rechercher l’ID d’un point d’arrêt, utilisez l’applet Get-PSBreakpoint
de commande.
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Runspace
Spécifie l’ID d’un objet Runspace afin que vous puissiez 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.
Type: | Runspace |
Aliases: | RunspaceId |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
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.
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
Enable-PSBreakpoint
de commande 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
Set-PSBreakpoint
commande. Vous n’avez pas besoin d’activer les points d’arrêt nouvellement créés.
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour