Get-PSBreakpoint
Obtient les points d'arrêt définis dans la session active.
Syntaxe
Get-PSBreakpoint [[-Script] <string[]>] [<CommonParameters>]
Get-PSBreakpoint -Command <string[]> [-Script <string[]>] [<CommonParameters>]
Get-PSBreakpoint [-Id] <Int32[]> [<CommonParameters>]
Get-PSBreakpoint [-Type] <BreakpointType[]> [-Script <string[]>] [<CommonParameters>]
Get-PSBreakpoint -Variable <string[]> [-Script <string[]>] [<CommonParameters>]
Description
L'applet de commande Get-PSBreakPoint obtient les points d'arrêt définis dans la session active. Vous pouvez utiliser les paramètres de l'applet de commande pour obtenir des points d'arrêt spécifiques.
Un point d'arrêt est un point au sein d'une commande ou d'un script où 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 des scripts et commandes Windows PowerShell. Pour plus d'informations sur le débogueur Windows PowerShell, consultez about_Debuggers.
Paramètres
-Command <string[]>
Obtient les points d'arrêt de commande définis avec les noms de commande spécifiés. Entrez le nom des commandes, tel que le nom d'une applet de commande ou d'une fonction.
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
All breakpoints |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Id <Int32[]>
Obtient les points d'arrêt possédant les ID spécifiés. Entrez les ID dans une liste séparée par des virgules. Vous pouvez également diriger les ID de points d'arrêt vers l'applet de commande Get-PSBreakpoint.
Obligatoire ? |
true |
Position ? |
1 |
Valeur par défaut |
All breakpoints |
Accepter l'entrée de pipeline ? |
true (ByValue) |
Accepter les caractères génériques ? |
false |
-Script <string[]>
Obtient uniquement les points d'arrêt des scripts spécifiés. Entrez le chemin d'accès (facultatif) et le nom d'un ou plusieurs fichiers de script. L'emplacement par défaut est le répertoire actif.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
All breakpoints |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Type <BreakpointType[]>
Obtient uniquement les points d'arrêt des types spécifiés. Entrez un ou plusieurs types. Les valeurs valides sont Line, Command et Variable. Vous pouvez également diriger les types de points d'arrêt vers l'applet de commande Get-PSBreakpoint.
Obligatoire ? |
true |
Position ? |
1 |
Valeur par défaut |
All breakpoints |
Accepter l'entrée de pipeline ? |
true (ByValue) |
Accepter les caractères génériques ? |
false |
-Variable <string[]>
Obtient des points d'arrêt de variables définis avec les noms de variables spécifiés. Entrez le nom des variables sans le symbole du dollar.
Obligatoire ? |
true |
Position ? |
named |
Valeur par défaut |
All breakpoints |
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.Int32, Microsoft.PowerShell.Commands.BreakpointType Vous pouvez diriger les ID et les types de points d'arrêt vers Get-PSBreakpoint. |
Sorties |
Objet point d'arrêt (System.Management.Automation.LineBreakpoint, System.Management.Automation.VariableBreakpoint, System.Management.Automation.CommandBreakpoint) Get-PSBreakPoint retourne des objets qui représentent les points d'arrêt dans la session. |
Remarques
Vous pouvez utiliser l'applet de commande Get-PSBreakpoint ou son alias, « gbp ».
Exemple 1
C:\PS>get-psbreakpoint
Description
-----------
Cette commande obtient tous les points d'arrêt définis pour tous les scripts et fonctions de la session active.
Exemple 2
C:\PS>get-psbreakpoint -Id 2
Function : Increment
Action :
Enabled : True
HitCount : 0
Id : 2
Script : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1
Description
-----------
Cette commande obtient le point d'arrêt comportant l'ID 2.
Exemple 3
C:\PS>$b = set-psbreakpoint -script sample.ps1 -function increment
C:\PS> $b.Id | get-psbreakpoint
Description
-----------
Ces commandes montrent comment obtenir un point d'arrêt en dirigeant un ID de point d'arrêt vers Get-PSBreakpoint.
La première commande utilise l'applet de commande Set-PSBreakpoint pour créer un point d'arrêt sur la fonction Increment du script Sample.ps1. Elle enregistre l'objet point d'arrêt dans la variable $b.
La deuxième commande utilise l'opérateur point (.) pour obtenir la propriété Id de l'objet point d'arrêt de la variable $b. Elle utilise un opérateur de pipeline (|) pour envoyer l'ID à l'applet de commande Get-PSBreakpoint.
En conséquence, Get-PSBreakpoint obtient le point d'arrêt avec l'ID spécifié.
Exemple 4
C:\PS>get-psbreakpoint -script Sample.ps1, SupportScript.ps1
Description
-----------
Cette commande obtient tous les points d'arrêt des fichiers Sample.ps1 et SupportScript.ps1.
Elle n'obtient pas les autres points d'arrêt qui peuvent être définis dans d'autres scripts ou fonctions de la session.
Exemple 5
C:\PS>get-psbreakpoint -command Read-Host, Write-Host -script Sample.ps1
Description
-----------
Cette commande obtient tous les points d'arrêt de commande définis pour les commandes Read-Host ou Write-Host du fichier Sample.ps1.
Exemple 6
C:\PS>get-psbreakpoint -type Command -script Sample.ps1
Description
-----------
Cette commande obtient tous les points d'arrêt de commande du fichier Sample.ps1.
Exemple 7
C:\PS>get-psbreakpoint -variable Index, Swap
Description
-----------
Cette commande obtient les points d'arrêt définis sur les variables $index et $swap de la session active.
Exemple 8
C:\PS>get-psbreakpoint -type line, variable -script Sample.ps1
Description
-----------
Cette commande obtient tous les points d'arrêt de variable et de ligne du script Sample.ps1.
Voir aussi
Concepts
about_Debuggers
Set-PSBreakpoint
Disable-PSBreakpoint
Enable-PSBreakpoint
Remove-PSBreakpoint
Get-PSCallStack