Get-PSBreakpoint

Module:

Microsoft.PowerShell.Utility Module

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

Syntaxe

Line (Par défaut)

Get-PSBreakpoint
    [[-Script] <String[]>]
    [-Runspace <Runspace>]
    [<CommonParameters>]

Command

Get-PSBreakpoint
    [[-Script] <String[]>]
    -Command <String[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Variable

Get-PSBreakpoint
    [[-Script] <String[]>]
    -Variable <String[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Type

Get-PSBreakpoint
    [[-Script] <String[]>]
    [-Type] <BreakpointType[]>
    [-Runspace <Runspace>]
    [<CommonParameters>]

Id

Get-PSBreakpoint
    [-Id] <Int32[]>
    [-Runspace <Runspace>]
    [<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"

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 lorsque le Set-PSBreakpoint est exécuté. L’espace d’exécution est stocké dans une variable et transmis à 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 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

-Runspace

Spécifie l’ID d’un objet Runspace afin de pouvoir 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.

Propriétés du paramètre

Type:	Runspace
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
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 (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.

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:	Named
Obligatoire:	False
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Variable

Position:	Named
Obligatoire:	False
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Command

Position:	Named
Obligatoire:	False
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Type

Position:	Named
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

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

Liens associés

• Disable-PSBreakpoint
• Enable-PSBreakpoint
• Get-PSCallStack
• Remove-PSBreakpoint
• Set-PSBreakpoint