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, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

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.

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.






Voir aussi




Table des matières