Partager via

Remove-PSBreakpoint

Module:
Microsoft.PowerShell.Utility Module

Supprime les points d’arrêt de la console active.

Syntaxe

Breakpoint (Par défaut) 

Remove-PSBreakpoint
    [-Breakpoint] <Breakpoint[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Id 

Remove-PSBreakpoint
    [-Id] <Int32[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

L’applet de commande Remove-PSBreakpoint supprime un point d’arrêt. Entrez un objet de point d’arrêt ou un ID de point d’arrêt.

Lorsque vous supprimez un point d’arrêt, l’objet de point d’arrêt n’est plus disponible ou fonctionnel. Si vous avez enregistré un objet de point d’arrêt dans une variable, la référence existe toujours, mais le point d’arrêt ne fonctionne pas.

remove-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 : Supprimer tous les points d’arrêt

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

Cette commande supprime tous les points d’arrêt de la console active.

Exemple 2 : Supprimer un point d’arrêt spécifié

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

Cette commande supprime un point d’arrêt.

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 Remove-PSBreakpoint pour supprimer le nouveau point d’arrêt. Il utilise un opérateur de pipeline (|) pour envoyer l’objet de point d’arrêt dans la variable $B à l’applet de commande Remove-PSBreakpoint.

À la suite de cette commande, si vous exécutez le script, elle s’exécute jusqu’à la fin sans s’arrêter. En outre, l’applet de commande Get-PSBreakpoint ne retourne pas ce point d’arrêt.

Exemple 3 : Supprimer un point d’arrêt par ID

PS C:\> Remove-PSBreakpoint -Id 2

Cette commande supprime le point d’arrêt avec l’ID de point d’arrêt 2.

Exemple 4 : Utiliser une fonction pour supprimer tous les points d’arrêt

PS C:\> function del-psb { get-psbreakpoint | remove-psbreakpoint }

Cette fonction simple supprime tous les points d’arrêt de la console actuelle. Il utilise l’applet de commande Get-PSBreakpoint pour obtenir les points d’arrêt. Ensuite, il utilise un opérateur de pipeline (|) pour envoyer les points d’arrêt au Remove-PSBreakpoint cmdlet, qui les supprime.

Par conséquent, vous pouvez taper del-psb au lieu de la commande plus longue.

Pour enregistrer la fonction, ajoutez-la à votre profil Windows PowerShell.

Paramètres

-Breakpoint

Spécifie les points d’arrêt à supprimer. Entrez une variable qui contient des objets de point d’arrêt ou une commande qui obtient des objets de point d’arrêt, tels qu’un Get-PSBreakpoint commande. Vous pouvez également diriger des objets de point d’arrêt vers Remove-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

Spécifie les ID de point d’arrêt pour lesquels cette applet de commande supprime les points d’arrêt.

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

-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 des objets de point d’arrêt vers remove-PSBreakpoint.

Sorties

None

L’applet de commande ne génère aucune sortie.