NOM
Disable-PSBreakpoint
RÉSUMÉ
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 [<SwitchParameter>]
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 [<SwitchParameter>]
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 [<SwitchParameter>]
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, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
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.
NOTES
-------------------------- 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 ».
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113294
about_Debuggers
Set-PSBreakpoint
Get-PSBreakpoint
Enable-PSBreakpoint
Remove-PSBreakpoint
Get-PSCallStack
Aucun commentaire:
Enregistrer un commentaire