Supprime des points d'arrêt de la console actuelle.

Syntaxe

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

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

Description

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

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

Remove-PSBreakpoint est l'une des applets de commande conçues pour le débogage des scripts Windows PowerShell. Pour plus d'informations sur le débogueur Windows PowerShell, consultez about_Debuggers.

Paramètres

-Breakpoint <Breakpoint[]>

Spécifie les points d'arrêt à supprimer. Entrez une variable contenant les objets points d'arrêt ou une commande permettant d'obtenir ces objets, telle qu'une commande Get-PSBreakpoint. Vous pouvez également diriger les objets points d'arrêt vers Remove-PSBreakpoint.

Obligatoire ?

true

Position ?

1

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

true (ByValue)

Accepter les caractères génériques ?

false

-Id <Int32[]>

Supprime les points d'arrêt possédant les ID spécifiés.

Obligatoire ?

true

Position ?

1

Valeur par défaut

aucun

Accepter l'entrée de pipeline ?

true (ByPropertyName)

Accepter les caractères génériques ?

false

-Confirmer

Vous invite à confirmer l'exécution de la commande.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-WhatIf

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

Obligatoire ?

false

Position ?

named

Valeur par défaut

Accepter l'entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

System.Management.Automation.Breakpoint

Vous pouvez diriger les objets points d'arrêt vers Remove-PSBreakpoint.

Sorties

Aucun

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

Exemple 1

C:\PS>get-breakpoint | remove-breakpoint

Description
-----------
Cette commande supprime tous les points d'arrêt de la console actuelle.






Exemple 2

C:\PS>$b = set-psbreakpoint -script sample.ps1 -variable Name

C:\PS> $b | remove-psbreakpoint

Description
-----------
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 du script Sample.ps1. Elle enregistre ensuite l'objet 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. Elle utilise un opérateur de pipeline (|) pour envoyer l'objet point d'arrêt de la variable $b à l'applet de commande Remove-PSBreakpoint.

Suite à cette commande, si vous exécutez le script, il s'exécute jusqu'à son achèvement sans s'arrêter. De plus, l'applet de commande Get-PSBreakpoint ne retourne pas ce point d'arrêt.






Exemple 3

C:\PS>remove-psbreakpoint -id 2

Description
-----------
Cette commande supprime le point d'arrêt possédant l'ID 2.






Exemple 4

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

Description
-----------
Cette fonction simple supprime tous les points d'arrêt de la console actuelle. Elle utilise l'applet de commande Get-PSBreakpoint pour obtenir les points d'arrêt. Elle utilise ensuite un opérateur de pipeline (|) pour envoyer les points d'arrêt à l'applet de commande Remove-PSBreakpoint, 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.






Voir aussi




Table des matières