Disable-PSBreakpoint

Module:

Microsoft.PowerShell.Utility Module

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

Syntaxe

Breakpoint (Par défaut)

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

Id

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

Description

L’applet de commande Disable-PSBreakpoint désactive les points d’arrêt, ce qui garantit 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 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 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 de commande Set-PSBreakpoint crée un point d’arrêt sur la variable $Name dans le script Sample.ps1 et enregistre l’objet de point d’arrêt dans la variable $B. L’applet de commande Disable-PSBreakpoint désactive 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 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 : Créer un point d’arrêt désactivé

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

Disable-PSBreakpoint -Breakpoint ($B = Set-PSBreakpoint -Script "sample.ps1" -Line 5)

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.

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

Exemple 5 : Désactiver un point d’arrêt dans un espace d’exécution

Dans cet exemple, un travail est démarré et un point d’arrêt est défini pour s’arrêter lorsque le Set-PSBreakpoint est exécuté. L’espace d’exécution est stocké dans une variable et transmis à la commande Get-PSBreakpoint avec le paramètre Runspace. La sortie de Get-PSBreakpoint est redirigée vers Disable-PSBreakpoint pour désactiver le point d’arrêt dans l’espace d’exécution.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

Get-PSBreakpoint -Runspace $runspace | Disable-Breakpoint -Runspace $runspace

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.

Propriétés du paramètre

Type:	Breakpoint[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Breakpoint

Position:	0
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Confirm

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

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Id

Désactive les points d’arrêt avec les ID de point d’arrêt spécifiés. Entrez les ID ou une variable qui contient les ID. Vous ne pouvez pas diriger les ID vers Disable-PSBreakpoint.

Propriétés du paramètre

Type:	Int32[]
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Id

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-PassThru

Retourne un objet représentant les points d’arrêt activés. Par défaut, cette applet de commande ne génère aucune sortie.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Runspace

Spécifie l’ID d’un objet Runspace afin de pouvoir interagir avec des points d’arrêt dans l’espace d’exécution spécifié.

Ce paramètre a été ajouté dans PowerShell 7.2.

Propriétés du paramètre

Type:	Runspace
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	RunspaceId

Jeux de paramètres

Id

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

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.

Entrées

Breakpoint

Vous pouvez diriger un objet de point d’arrêt vers cette applet de commande.

Sorties

None

Par défaut, cette applet de commande ne retourne aucune sortie.

Breakpoint

Lorsque vous utilisez le paramètre passThru, cette applet de commande retourne un objet de point d’arrêt représentant le point d’arrêt désactivé.

Notes

PowerShell inclut les alias suivants pour Disable-PSBreakpoint:

• Toutes les plateformes :
  • dbp

Liens associés

• Enable-PSBreakpoint
• Get-PSBreakpoint
• Get-PSCallStack
• Remove-PSBreakpoint
• Set-PSBreakpoint