Disable-PSBreakpoint

Disable-PSBreakpoint
    [-Breakpoint] <Breakpoint[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Disable-PSBreakpoint
    [-Id] <Int32[]>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

La Disable-PSBreakpoint cmdlet 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 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 modifie la valeur de la propriété Enabled d’un objet de point d’arrêt 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 dans un script où l’exécution s’arrête temporairement afin de pouvoir examiner les instructions du script. disable-PSBreakpoint est l’une des applets de commande conçues pour le débogage de scripts Windows PowerShell. Pour plus d’informations sur le débogueur Windows PowerShell, consultez about_Debuggers.

PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Variable "name"
PS C:\> $B | Disable-PSBreakpoint

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 dans le script Sample.ps1. Ensuite, il enregistre l’objet de 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. Il utilise un opérateur de pipeline (|) pour envoyer l’objet de point d’arrêt dans $B à l’applet de commande Disable-PSBreakpoint .

À la suite de cette commande, la valeur de la propriété Enabled de l’objet point d’arrêt dans $B a la valeur False.

PS C:\> Disable-PSBreakpoint -Id 0

Cette commande désactive le point d’arrêt avec l’ID de point d’arrêt 0.

PS C:\> Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)
PS C:\> $B

Cette commande crée un point d’arrêt désactivé jusqu’à ce que vous l’activez.

Il utilise l’applet de commande Disable-PSBreakpoint pour désactiver le point d’arrêt. La valeur du paramètre point d’arrêt est une commande Set-PSBreakpoint 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 variable $B.

Les paramètres d’applet de commande qui prennent 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 de point d’arrêt, il peut être utilisé comme valeur du paramètre point d’arrêt.

La deuxième commande affiche l’objet de point d’arrêt dans la valeur de la variable $B.

PS C:\> Get-PSBreakpoint | Disable-PSBreakpoint

Cette commande désactive tous les points d’arrêt dans la console active. Vous pouvez abbrevier cette commande en tant que : « gbits/s | dbp".

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez diriger un objet de point d’arrêt vers disable-PSBreakpoint.

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.