Disable-PSBreakpoint
Désactive les points d'arrêt dans la console active.
Syntax
Disable-PSBreakpoint
[-PassThru]
[-Breakpoint] <Breakpoint[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Disable-PSBreakpoint
[-PassThru]
[-Id] <Int32[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet Disable-PSBreakpoint
de commande désactive les points d’arrêt, ce qui garantit qu’ils ne sont pas atteints lors de l’exécution du script. Vous pouvez l'utiliser pour désactiver tous les points d'arrêt, ou vous pouvez spécifier des points d'arrêt en envoyant des objets de point d'arrêt ou des ID de point d'arrêt.
Techniquement, cette applet de commande affecte la valeur False à la propriété Enabled d'un objet de point d'arrêt.
Pour réactiver un point d’arrêt, utilisez l’applet de Enable-PSBreakpoint
commande . Les points d’arrêt sont activés par défaut lorsque vous les créez à l’aide de l’applet de Set-PSBreakpoint
commande.
Un point d'arrêt est un point dans un script auquel l'exécution s'arrête temporairement afin que vous puissiez examiner les instructions comprises dans le script. Disable-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 : Définir un point d’arrêt et le désactiver
Ces commandes désactivent un point d'arrêt nouvellement créé.
$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
$B | Disable-PSBreakpoint
L’applet Set-PSBreakpoint
de commande crée un point d’arrêt sur la $Name
variable dans le Sample.ps1
script et enregistre l’objet point d’arrêt dans la $B
variable. L’applet Disable-PSBreakpoint
de commande désactive le nouveau point d’arrêt. Il utilise un opérateur de pipeline (|
) pour envoyer l’objet point d’arrêt dans $B
à l’applet de Disable-PSBreakpoint
commande.
À la suite de cette commande, la valeur de la propriété Enabled de l’objet point d’arrêt dans $B
est False.
Exemple 2 : Désactiver un point d’arrêt
Cette commande désactive le point d'arrêt avec l'ID de point d'arrêt 0.
Disable-PSBreakpoint -Id 0
Exemple 3 : Create un point d’arrêt désactivé
Cette commande crée un nouveau point d'arrêt qui est désactivé jusqu'à ce que vous l'activiez.
Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
Il utilise l’applet Disable-PSBreakpoint
de commande pour désactiver le point d’arrêt. La valeur du paramètre Point d’arrêt est une Set-PSBreakpoint
commande qui définit un nouveau point d’arrêt, génère un objet de point d’arrêt et enregistre l’objet dans la $B
variable.
Les paramètres d'applet de commande qui acceptent des objets comme valeurs peuvent accepter une variable qui contient l'objet, ou une commande qui obtient ou génère l'objet. Dans ce cas, étant donné que Set-PSBreakpoint
génère un objet point d’arrêt, il peut être utilisé comme valeur du paramètre Point d’arrêt .
Exemple 4 : Désactiver tous les points d’arrêt dans la console actuelle
Cette commande désactive tous les points d'arrêt dans la console active.
`Get-PSBreakpoint` | Disable-PSBreakpoint
Paramètres
-Breakpoint
Spécifie les points d'arrêt à désactiver. Entrez une variable qui contient des objets de point d’arrêt ou une commande qui obtient des objets de point d’arrêt, comme une Get-PSBreakpoint
commande. Vous pouvez également diriger des objets de point d’arrêt vers l’applet de Disable-PSBreakpoint
commande.
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
Désactive les points d'arrêt avec l'ID de point d'arrêt spécifié. Entrez les ID ou une variable qui contient les ID. Vous ne pouvez pas diriger les ID vers Disable-PSBreakpoint
.
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Retourne un objet qui représente les points d'arrêt activés. Par défaut, cette applet de commande ne génère aucun résultat.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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 Disable-PSBreakpoint
.
Sorties
None or System.Management.Automation.Breakpoint
Lorsque vous utilisez le paramètre PassThru , Disable-PSBreakpoint
retourne un objet qui représente le point d’arrêt désactivé. Sinon, cette applet de commande ne génère aucune sortie.