Partager via

Get-PSCallStack

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

Affiche la pile des appels actuelle.

Syntaxe

Get-PSCallStack []

Description

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

Elle a été conçue pour être utilisée avec le débogueur Windows PowerShell, mais vous pouvez l'utiliser pour afficher la pile des appels dans un script ou une fonction en dehors du débogueur.

Pour exécuter une Get-PSCallStack commande dans le débogueur, tapez k ou Get-PSCallStack.

Exemples

Exemple 1 : Obtenir la pile des appels pour une fonction

PS C:\> function my-alias {
$p = $args[0]
Get-Alias | where {$_.definition -like "*$p"} | format-table 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:\> 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*"} | format-table Definition,
[DBG]: PS C:\ps-test>get-pscallstack

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

PS C:\> [DBG]: PS C:\ps-test> o
Definition  Name
----------  ----
Get-Content gc
Get-Content cat
Get-Content type

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

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

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

La commande finale est une Step-Out commande (o) qui quitte le débogueur et continue d’exécuter le script jusqu’à la fin.

Entrées

None

Vous ne pouvez pas diriger les objets vers cette applet de commande.

Sorties

CallStackFrame

Cette applet de commande retourne un objet représentant les éléments de la pile des appels.

Notes

PowerShell inclut les alias suivants pour Get-PSCallStack:

  • Toutes les plateformes :
    • gcs