Condividi tramite

Get-PSCallStack

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Visualizza lo stack di chiamate corrente.

Sintassi

Get-PSCallStack []

Descrizione

Il cmdlet Get-PSCallStack visualizza lo stack di chiamate corrente.

Sebbene sia progettato per essere usato con il debugger di Windows PowerShell, è possibile usare questo cmdlet per visualizzare lo stack di chiamate in uno script o una funzione all'esterno del debugger.

Per eseguire un comando Get-PSCallStack nel debugger, digitare k o Get-PSCallStack.

Esempio

Esempio 1: Ottenere lo stack di chiamate per una funzione

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

Questo comando usa il cmdlet Get-PSCallStack per visualizzare lo stack di chiamate per My-Alias, una funzione semplice che ottiene gli alias per un nome di cmdlet.

Il primo comando immette la funzione al prompt di Windows PowerShell. Il secondo comando usa il cmdlet Set-PSBreakpoint per impostare un punto di interruzione nella funzione My-Alias. Il terzo comando usa la funzione My-Alias per ottenere tutti gli alias nella sessione corrente per il cmdlet Get-Content.

Il debugger si interrompe in corrispondenza della chiamata di funzione. Due comandi consecutivi step-into (s) iniziano a eseguire la riga della funzione per riga. Viene quindi usato un comando Get-PSCallStack per recuperare lo stack di chiamate.

Il comando finale è un comando Step-Out (o) che esce dal debugger e continua a eseguire lo script fino al completamento.

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

CallStackFrame

Questo cmdlet restituisce un oggetto che rappresenta gli elementi nello stack di chiamate.

Note

PowerShell include gli alias seguenti per Get-PSCallStack:

  • Tutte le piattaforme:
    • gcs