Remove-PSBreakpoint

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

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

Syntax

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

Description

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

Quand 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 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 Remove-PSBreakpoint de commande 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 $B variable à l’applet Remove-PSBreakpoint de commande.

Si vous exécutez le script, cette commande s'exécute jusqu'à son achèvement sans interruption. En outre, l’applet Get-PSBreakpoint de commande 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 ayant 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 session active.

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

Il utilise l’applet Get-PSBreakpoint de commande pour obtenir les points d’arrêt. Ensuite, il utilise un opérateur de pipeline (|) pour envoyer les points d’arrêt à l’applet Remove-PSBreakpoint de commande, ce qui les supprime.

Exemple 5 : Supprimer 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 Remove-PSBreakpoint supprimer 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 | Remove-Breakpoint -Runspace $runspace

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 Get-PSBreakpoint commande. Vous pouvez également diriger des objets de point d’arrêt vers Remove-PSBreakpoint.

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

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
Default value:None
Required:True
Accept pipeline input:True
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 des objets de point d’arrêt vers cette applet de commande.

Int32[]

Runspace

Sorties

None

Cette applet de commande ne retourne pas de sortie.

Notes

PowerShell inclut les alias suivants pour Remove-PSBreakpoint:

  • Toutes les plateformes :
    • rbp