Get-PSBreakpoint
Obtient les points d’arrêt définis dans la session active.
Syntaxe
Script (Par défaut)
Get-PSBreakpoint
[[-Script] <String[]>]
[<CommonParameters>]
Type
Get-PSBreakpoint
[[-Script] <String[]>]
[-Type] <BreakpointType[]>
[<CommonParameters>]
Command
Get-PSBreakpoint
[[-Script] <String[]>]
-Command <String[]>
[<CommonParameters>]
Variable
Get-PSBreakpoint
[[-Script] <String[]>]
-Variable <String[]>
[<CommonParameters>]
Id
Get-PSBreakpoint
[-Id] <Int32[]>
[<CommonParameters>]
Description
L’applet de commande get-PSBreakPoint
Un point d’arrêt est un point dans une commande ou un script où l’exécution s’arrête temporairement afin de pouvoir examiner les instructions. get-PSBreakpoint est l’une des applets de commande conçues pour le débogage de scripts et de commandes Windows PowerShell. Pour plus d’informations sur le débogueur Windows PowerShell, consultez about_Debuggers.
Exemples
Exemple 1 : Obtenir tous les points d’arrêt pour tous les scripts et fonctions
PS C:\> Get-PSBreakpoint
Cette commande obtient tous les points d’arrêt définis sur tous les scripts et fonctions de la session active.
Exemple 2 : Obtenir des points d’arrêt par ID
PS C:\> Get-PSBreakpoint -Id 2
Function :
IncrementAction :
Enabled :
TrueHitCount : 0
Id : 2
Script : C:\ps-test\sample.ps1
ScriptName : C:\ps-test\sample.ps1
Cette commande obtient le point d’arrêt avec l’ID de point d’arrêt 2.
Exemple 3 : diriger un ID vers Get-PSBreakpoint
PS C:\> $B = Set-PSBreakpoint -Script "sample.ps1" -Command "Increment"
PS C:\> $B.Id | Get-PSBreakpoint
Ces commandes montrent comment obtenir un point d’arrêt en pipant un ID de point d’arrêt pour get-PSBreakpoint.
La première commande utilise l’applet de commande Set-PSBreakpoint pour créer un point d’arrêt sur la fonction Incrément dans le script Sample.ps1. Il enregistre l’objet de 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 dans la variable $B. Il utilise un opérateur de pipeline (|) pour envoyer l’ID à l’applet de commande Get-PSBreakpoint
Par conséquent, Get-PSBreakpoint obtient le point d’arrêt avec l’ID spécifié.
Exemple 4 : Obtenir des points d’arrêt dans les fichiers de script spécifiés
PS C:\> Get-PSBreakpoint -Script "Sample.ps1, SupportScript.ps1"
Cette commande obtient tous les points d’arrêt dans les fichiers Sample.ps1 et 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
PS C:\> Get-PSBreakpoint -Command "Read-Host, Write-Host" -Script "Sample.ps1"
Cette commande obtient tous les points d’arrêt de commande définis sur des commandes Read-Host ou Write-Host dans le fichier Sample.ps1.
Exemple 6 : Obtenir des points d’arrêt de commande dans un fichier spécifié
PS C:\> Get-PSBreakpoint -Type Command -Script "Sample.ps1"
Cette commande obtient tous les points d’arrêt de commande dans le fichier Sample.ps1.
Exemple 7 : Obtenir des points d’arrêt par variable
PS C:\> Get-PSBreakpoint -Variable "Index, Swap"
Cette commande obtient des points d’arrêt définis sur les variables $Index et $Swap dans la session active.
Exemple 8 : Obtenir tous les points d’arrêt de ligne et de variable dans un fichier
PS C:\> Get-PSBreakpoint -Type Line, Variable -Script "Sample.ps1"
Cette commande obtient tous les points d’arrêt de ligne et de variable dans le script Sample.ps1.
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 commandes, tels que le nom d’une applet de commande ou d’une fonction.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Command
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | Int32[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Id
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Script
Spécifie un tableau de scripts qui contiennent les points d’arrêt. Entrez le chemin d’accès 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.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Script
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
Type
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
Command
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
Variable
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 acceptables pour ce paramètre sont les suivantes :
- Lignes
- Commande
- Variable
Vous pouvez également diriger les types de points d’arrêt vers Get-PSBreakPoint .
Propriétés du paramètre
| Type: | BreakpointType[] |
| Valeur par défaut: | None |
| Valeurs acceptées: | Line, Variable, Command |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Type
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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 variables sans signe dollar.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
Variable
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
System.Int32, Microsoft.PowerShell.Commands.BreakpointType
Vous pouvez diriger les ID de point d’arrêt et les types de points d’arrêt pour Obtenir-PSBreakPoint.
Sorties
Breakpoint
Get-PSBreakPoint retourne des objets qui représentent les points d’arrêt de la session.
Notes
- Vous pouvez utiliser Get-PSBreakpoint ou son alias, « gbit/s ».