Partager via

Remove-PSBreakpoint

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

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

Syntaxe

Remove-PSBreakpoint
      [-Breakpoint] <Breakpoint[]>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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 PowerShell. Pour plus d’informations sur le débogueur PowerShell, consultez about_Debuggers.

Exemples

Exemple 1 : Supprimer tous les points d’arrêt

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

Get-PSBreakpoint | Remove-PSBreakpoint

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

Cette commande supprime un point d’arrêt.

$B = Set-PSBreakpoint -Script "sample.ps1" -Variable "Name"
$B | Remove-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 Remove-PSBreakpoint supprime 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

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

Remove-PSBreakpoint -Id 2

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

Cette fonction simple supprime tous les points d’arrêt de la console actuelle.

function del-psb { Get-PSBreakpoint | Remove-PSBreakpoint }

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 à l’applet de commande Remove-PSBreakpoint, qui les supprime.

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, comme une commande Get-PSBreakpoint. Vous pouvez également diriger des objets de point d’arrêt vers Remove-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 les ID de point d’arrêt pour lesquels cette applet de commande supprime les points d’arrêt.

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

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

Int32[]

Runspace

Sorties

None

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