Get-PSBreakpoint

NOM
    Get-PSBreakpoint

RÉSUMÉ
    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                     Tous les points d'arrêt
        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                     Tous les points d'arrêt
        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                     Tous les points d'arrêt
        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                     Tous les points d'arrêt
        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                     Tous les points d'arrêt
        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, WarningAction, WarningVariable,
        OutBuffer et OutVariable. Pour plus d'informations, tapez
        « get-help about_commonparameters ».

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.


NOTES


        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.






LIENS CONNEXES
    Online version: http://go.microsoft.com/fwlink/?LinkID=113325
    about_Debuggers
    Set-PSBreakpoint
    Disable-PSBreakpoint
    Enable-PSBreakpoint
    Remove-PSBreakpoint
    Get-PSCallStack