Disable-PSBreakpoint

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

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

Syntax

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

Description

L’applet Disable-PSBreakpoint de commande 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 vous pouvez 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 affecte la valeur False à la propriété Enabled d'un objet de point d'arrêt. Pour réactiver un point d’arrêt, utilisez l’applet de Enable-PSBreakpoint commande. Les points d’arrêt sont activés par défaut lorsque vous les créez à l’aide de l’applet de Set-PSBreakpoint commande.

Un point d'arrêt est un point dans un script auquel l'exécution s'arrête temporairement afin que vous puissiez examiner les instructions comprises dans le 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 Set-PSBreakpoint de commande crée un point d’arrêt sur la $Name variable dans le Sample.ps1 script et enregistre l’objet de point d’arrêt dans la $B variable. L’applet Disable-PSBreakpoint de commande désactive le nouveau point d’arrêt. Il utilise un opérateur de pipeline (|) pour envoyer l’objet de point d’arrêt à $B l’applet Disable-PSBreakpoint de commande.

À la suite de cette commande, la valeur de la propriété Enabled de l’objet point d’arrêt est $BFalse.

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 nouveau point d'arrêt qui est désactivé jusqu'à ce que vous l'activiez.

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

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

Les paramètres d'applet de commande qui acceptent 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 lors de l’exécution du Set-PSBreakPoint. L’instance d’exécution est stockée dans une variable et passée à la commande Get-PSBreakPoint avec le paramètre Runspace. La sortie est Get-PSBreakPoint redirigée pour Disable-PSBreakpoint 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 Get-PSBreakpoint commande. Vous pouvez également diriger des objets de point d’arrêt vers l’applet Disable-PSBreakpoint de commande.

Type:Breakpoint[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Retourne un objet qui représente les points d'arrêt activés. Par défaut, cette applet de commande ne génère aucun résultat.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Runspace

Spécifie l’ID d’un objet Runspace afin que vous puissiez 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.

Type:Runspace
Aliases:RunspaceId
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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