Get-PSCallStack

NOM
    Get-PSCallStack

RÉSUMÉ
    Affiche la pile des appels actuelle.

SYNTAXE
    Get-PSCallStack [<CommonParameters>]


DESCRIPTION
    L'applet de commande Get-PSCallStack affiche la pile des appels actuelle.

    Bien qu'elle soit conçue pour être utilisée avec le débogueur Windows PowerShell, vous pouvez utiliser cette applet de commande pour afficher la pile des appels d'un script ou d'une fonction en dehors du débogueur.

    Pour exécuter une commande Get-PSCallStack à partir du débogueur, tapez « k » ou « get-pscallstack ».


PARAMÈTRES
    <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
    Aucun
        Vous ne pouvez pas diriger des objets vers cette applet de commande.


SORTIES
    System.Management.Automation.CallStackFrame
        Get-PSCallStack retourne un objet qui représente les éléments figurant dans la pile des appels.


NOTES





    -------------------------- EXEMPLE 1 --------------------------

    C:\PS>function my-alias {
       $p = $args[0]
       get-alias | where {$_.definition -like "*$p"} | ft definition, name -auto
    }

    PS C:\ps-test> set-psbreakpoint -command my-alias

    Command    : my-alias
    Action     :
    Enabled    : True
    HitCount   : 0
    Id         : 0
    Script     : prompt


    PS C:\ps-test> my-alias get-content
    Entering debug mode. Use h or ? for help.

    Hit Command breakpoint on 'prompt:my-alias'

    my-alias get-content

    [DBG]: PS C:\ps-test> s
    $p = $args[0]

    DEBUG: Stepped to ':    $p = $args[0]    '

    [DBG]: PS C:\ps-test> s
    get-alias | Where {$_.Definition -like "*$p*"} | ft Definition,

    [DBG]: PS C:\ps-test>get-pscallstack

    Name        CommandLineParameters         UnboundArguments              Location
    ----        ---------------------         ----------------              --------
    prompt      {}                            {}                            prompt
    my-alias    {}                            {get-content}                 prompt
    prompt      {}                            {}                            prompt


    [DBG]: PS C:\ps-test> o

    Definition  Name
    ----------  ----
    Get-Content gc
    Get-Content cat
    Get-Content type


    Description
    -----------
    Cette commande utilise l'applet de commande Get-PSCallStack pour afficher la pile des appels de My-Alias, une fonction simple qui obtient les alias d'un nom d'applet de commande.

    La première commande entre la fonction à l'invite de Windows PowerShell. La deuxième commande utilise l'applet de commande Set-PSBreakpoint pour définir un point d'arrêt sur la fonction My-Alias. La troisième commande utilise la fonction My-Alias pour obtenir tous les alias de la session active pour l'applet de commande Get-Content.

    Le débogueur entre à l'appel de la fonction. Deux commandes step-into (s) consécutives commencent à exécuter la fonction ligne par ligne. Ensuite, une commande Get-PSCallStack est utilisée pour récupérer la pile des appels.

    La dernière commande est la commande Step-Out (o) qui permet de quitter le débogueur et de continuer à exécuter le script jusqu'à son achèvement.






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