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