Partager via

Disable-PSBreakpoint

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

Désactive les points d’arrêt dans la console active.

Syntaxe

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

Description

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.

Exemples

Exemple 1 : Définir un point d’arrêt et le désactiver

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.

Exemple 2 : Désactiver un point d’arrêt

PS C:\> Disable-PSBreakpoint -Id 0

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

Exemple 3 : Créer un point d’arrêt désactivé

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.

Exemple 4 : Désactiver tous les points d’arrêt dans la console actuelle

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

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 commande Get-PSBreakpoint. Vous pouvez également diriger des objets de point d’arrêt vers l’applet de commande Disable-PSBreakpoint.

Type:Breakpoint[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifie un tableau d’ID ou de variables qui contient les ID de point d’arrêt. Vous ne pouvez pas diriger les ID vers Disable-PSBreakpoint.

Type:Int32[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Retourne un objet représentant l’élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Breakpoint

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.