Get-PSBreakpoint

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

Obtient les points d'arrêt définis dans la session active.

Syntax

Get-PSBreakpoint
   [[-Script] <String[]>]
   [-Runspace <Runspace>]
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Command <String[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   -Variable <String[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]
Get-PSBreakpoint
   [[-Script] <String[]>]
   [-Type] <BreakpointType[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]
Get-PSBreakpoint
   [-Id] <Int32[]>
   [-Runspace <Runspace>]
   [<CommonParameters>]

Description

L’applet Get-PSBreakPoint de commande obtient les points d’arrêt définis dans la session active. Vous pouvez utiliser les paramètres d'applet de commande pour obtenir des points d'arrêt spécifiques.

Un point d'arrêt est un point dans une commande ou un script auquel l'exécution s'arrête temporairement afin que vous puissiez examiner les instructions. Get-PSBreakpoint est l’une des applets de commande conçues pour le débogage de scripts et de commandes PowerShell. Pour plus d’informations sur le débogueur PowerShell, consultez about_Debuggers.

Exemples

Exemple 1 : Obtenir tous les points d’arrêt pour tous les scripts et fonctions

Cette commande obtient tous les points d'arrêt définis sur tous les scripts et fonctions de la session active.

Get-PSBreakpoint

Exemple 2 : Obtenir des points d’arrêt par ID

Cette commande obtient le point d'arrêt associé à l'ID de point d'arrêt 2.

Get-PSBreakpoint -Id 2

Function         :
IncrementAction  :
Enabled          :
TrueHitCount     : 0
Id               : 2
Script           : C:\ps-test\sample.ps1
ScriptName       : C:\ps-test\sample.ps1

Exemple 3 : Diriger un ID vers « Get-PSBreakpoint »

Ces commandes montrent comment obtenir un point d’arrêt en pipant un ID de point d’arrêt vers Get-PSBreakpoint.

$B = `Set-PSBreakpoint` -Script "sample.ps1" -Command "Increment"
$B.Id | Get-PSBreakpoint

L’applet Set-PSBreakpoint de commande crée un point d’arrêt sur la fonction Increment dans le Sample.ps1 script et enregistre l’objet de point d’arrêt dans la $B variable. La propriété ID de l’objet point d’arrêt dans la $B variable est redirigée vers l’applet Get-PSBreakpoint de commande pour afficher les informations de point d’arrêt.

Exemple 4 : Obtenir des points d’arrêt dans les fichiers de script spécifiés

Cette commande obtient tous les points d’arrêt dans les fichiers et SupportScript.ps1 les Sample.ps1 fichiers.

Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"

Cette commande n’obtient pas d’autres points d’arrêt qui peuvent être définis dans d’autres scripts ou sur des fonctions dans la session.

Exemple 5 : Obtenir des points d’arrêt dans les applets de commande spécifiées

Cette commande obtient tous les points d’arrêt de commande définis ou Read-HostWrite-Host commandes dans le Sample.ps1 fichier.

Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"

Exemple 6 : Obtenir des points d’arrêt de commande dans un fichier spécifié

Get-PSBreakpoint -Type Command -Script "Sample.ps1"

Cette commande obtient tous les points d'arrêt de commande du fichier Sample.ps1.

Exemple 7 : Obtenir des points d’arrêt par variable

Cette commande obtient des points d’arrêt définis sur les variables et $Swap les $Index variables de la session active.

Get-PSBreakpoint -Variable "Index, Swap"

Exemple 8 : Obtenir tous les points d’arrêt de ligne et de variable dans un fichier

Cette commande obtient tous les points d’arrêt de ligne et de variable dans le Sample.ps1 script.

Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"

Exemple 9 : Obtenir les points d’arrêt définis dans un runspace spécifique

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. Vous pouvez ensuite inspecter le point d’arrêt dans la variable $breakpoint.

Start-Job -ScriptBlock {
    Set-PSBreakpoint -Command Start-Sleep
    Start-Sleep -Seconds 10
}

$runspace = Get-Runspace -Id 1

$breakpoint = Get-PSBreakPoint -Runspace $runspace

Paramètres

-Command

Spécifie un tableau de points d’arrêt de commande définis sur les noms de commandes spécifiés. Entrez les noms de commande, par exemple, le nom d'une applet de commande ou d'une fonction.

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

-Id

Spécifie les ID de point d’arrêt que cette applet de commande obtient. Entrez les ID dans une liste séparée par des virgules. Vous pouvez également diriger les ID de point d’arrêt vers Get-PSBreakpoint.

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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Script

Spécifie un tableau de scripts qui contiennent les points d’arrêt. Entrez le chemin d'accès (facultatif) et les noms d'un ou plusieurs fichiers de script. Si vous omettez le chemin d'accès, l'emplacement par défaut est le répertoire actif.

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

-Type

Spécifie un tableau de types de points d’arrêt que cette applet de commande obtient. Entrez un ou plusieurs types. Les valeurs valides pour ce paramètre sont :

  • Line
  • Commande
  • Variable

Vous pouvez également diriger les types de points d’arrêt vers Get-PSBreakPoint.

Type:BreakpointType[]
Accepted values:Line, Variable, Command
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Variable

Spécifie un tableau de points d’arrêt de variables définis sur les noms de variables spécifiés. Entrez les noms de variable sans le signe dollar.

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

Entrées

Int32

Vous pouvez diriger les ID de point d’arrêt vers cette applet de commande.

BreakpointType

Vous pouvez diriger les types de points d’arrêt vers cette applet de commande.

Sorties

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

Breakpoint

Cette applet de commande retourne des objets qui représentent les points d’arrêt de la session.

Notes

PowerShell inclut les alias suivants pour Get-PSBreakpoint:

  • Toutes les plateformes :
    • gbp