Partager via

Enable-PSBreakpoint

  • Référence
Module:
Microsoft.PowerShell.Utility

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 de Disable-PSBreakpoint.

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

Enable-PSBreakpoint est l’une des nombreuses 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 de la session active.

Get-PSBreakpoint | Enable-PSBreakpoint

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

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

Cet exemple montre comment activer 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 réactive 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 enregistrant l’objet 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, à l’aide du 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 montre comment activer 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, 5de .

Exemple 5 : Activer un point d’arrêt dans un runspace

Dans cet exemple, un travail démarré avec un point d’arrêt est défini sur l’arrêt, 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 de Get-PSBreakPoint est dirigée vers Enable-PSBreakpoint pour 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 de Get-PSBreakpoint 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 les 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

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 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.