Partager via

Get-PSBreakpoint

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

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
   -Variable <string[]>
   [-Script <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   [-Type] <BreakpointType[]>
   [-Script <string[]>]
   [<CommonParameters>]
Get-PSBreakpoint
   [-Id] <int[]>
   [<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 d’applet de commande pour obtenir des points d’arrêt particuliers.

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 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 avec 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 pour Get-PSBreakpoint.

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

L’applet de commande Set-PSBreakpoint crée un point d’arrêt sur la fonction Incrément dans le script Sample.ps1 et enregistre l’objet de point d’arrêt dans la variable $B. La propriété ID de l’objet point d’arrêt dans la variable $B est redirigée vers l’applet de commande Get-PSBreakpoint 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 Sample.ps1 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 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 sur des commandes Read-Host ou Write-Host dans le fichier Sample.ps1.

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 dans le 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 $Index 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 script Sample.ps1.

Get-PSBreakpoint -Type Line, Variable -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.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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 :

  • Ligne
  • Commander
  • Variable

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

Type:BreakpointType[]
Valeurs acceptées:Line, Variable, Command
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Int32

BreakpointType

Vous pouvez diriger les ID de point d’arrêt et les types de points d’arrêt vers Get-PSBreakPoint.

Sorties

CommandBreakpoint

LineBreakpoint

VariableBreakpoint

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 ».