Get-PSBreakpoint
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 nombreuses 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 dirigeant 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 de 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 des fichiers de script spécifiés
Cette commande obtient tous les points d’arrêt dans les Sample.ps1
fichiers et SupportScript.ps1
.
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 de 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 sur Read-Host
les commandes ou Write-Host
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 les points d’arrêt définis sur les $Index
variables et $Swap
dans 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 une instance d’exécution 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 les 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 :
- Courbes
- 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 variable qui sont 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
Vous pouvez diriger des ID de point d’arrêt vers cette applet de commande.
Vous pouvez diriger des types de points d’arrêt vers cette applet de commande.
Sorties
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