Désactive les points d'arrêt de la console actuelle.
Syntaxe
Disable-PSBreakpoint [-Id] <Int32[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>] Disable-PSBreakpoint [-Breakpoint] <Breakpoint[]> [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande Disable-PSBreakpoint désactive les points d'arrêt, ce qui permet de s'assurer qu'ils ne sont pas atteints lorsque le script s'exécute. 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 points d'arrêt ou des ID de point d'arrêt.
Techniquement, cette applet de commande modifie la valeur de la propriété Enabled d'un objet point d'arrêt en la définissant sur False. Pour réactiver un point d'arrêt, utilisez l'applet de commande Enable-PSBreakpoint. Les points d'arrêt sont activés par défaut lorsque vous les créez à l'aide de l'applet de commande Set-PSBreakpoint.
Un point d'arrêt est un point au sein d'un script où l'exécution s'arrête temporairement afin que vous puissiez examiner les instructions du script. Disable-PSBreakpoint est l'une des applets de commande conçues pour le débogage des scripts Windows PowerShell. Pour plus d'informations sur le débogueur Windows PowerShell, consultez about_Debuggers.
Paramètres
-Breakpoint <Breakpoint[]>
Spécifie les points d'arrêt à désactiver. Entrez une variable contenant les objets points d'arrêt ou une commande permettant d'obtenir ces objets, telle qu'une commande Get-PSBreakpoint. Vous pouvez également diriger des objets points d'arrêt vers l'applet de commande Disable-PSBreakpoint.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
aucun |
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
|
Accepter les caractères génériques ? |
false |
-Id <Int32[]>
Désactive les points d'arrêt possédant les ID spécifiés. Entrez les ID ou une variable contenant les ID. Vous ne pouvez pas diriger d'ID vers Disable-PSBreakpoint.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-PassThru
Retourne un objet représentant les points d'arrêt actifs. Par défaut, cette applet de commande ne génère aucune sortie.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
aucun |
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Confirm
Vous invite à confirmer l'exécution de la commande.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
System.Management.Automation.Breakpoint Vous pouvez diriger un objet point d'arrêt vers Disable-PSBreakpoint. |
|
Sorties |
Aucun ou 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. |
Exemple 1
C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable name C:\PS> $b | disable-psbreakpoint Description ----------- Ces commandes désactivent un point d'arrêt nouvellement créé. La première commande utilise l'applet de commande Set-PSBreakpoint pour créer un point d'arrêt sur la variable Name du script Sample.ps1. Elle enregistre ensuite l'objet point d'arrêt dans la variable $b. La deuxième commande utilise l'applet de commande Disable-PSBreakpoint pour désactiver le nouveau point d'arrêt. Elle utilise un opérateur de pipeline (|) pour envoyer l'objet point d'arrêt de la variable $b à l'applet de commande Disable-PSBreakpoint. Suite à cette commande, la valeur de la propriété Enabled de l'objet point d'arrêt de la variable $b devient False.
Exemple 2
C:\PS>disable-psbreakpoint -id 0 Description ----------- Cette commande désactive le point d'arrêt possédant l'ID 0.
Exemple 3
C:\PS>disable-psbreakpoint -breakpoint ($b = set-psbreakpoint -script sample.ps1 -line 5) C:\PS> $b Description ----------- Cette commande crée un nouveau point d'arrêt qui est désactivé jusqu'à ce que vous l'activiez. Elle utilise l'applet de commande Disable-PSBreakpoint pour désactiver le point d'arrêt. La valeur du paramètre Breakpoint est une commande Set-PSBreakpoint qui définit un nouveau point d'arrêt, génère un objet point d'arrêt et enregistre cet objet dans la variable $b. Les paramètres de l'applet de commande qui acceptent des objets en tant que valeurs peuvent accepter une variable contenant 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é en tant que valeur du paramètre Breakpoint. La deuxième commande affiche l'objet point d'arrêt dans la valeur de la variable $b.
Exemple 4
C:\PS>get-psbreakpoint | disable-psbreakpoint Description ----------- Cette commande désactive tous les points d'arrêt de la console actuelle. Vous pouvez abréger cette commande sous la forme « gbp | dbp ».
Voir aussi