Get-PSCallStack

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Exibe a pilha de chamadas atual.

Sintaxe

Get-PSCallStack []

Description

O Get-PSCallStack cmdlet exibe a pilha de chamadas atual.

Embora tenha sido criado para ser usado com o depurador do Windows PowerShell, você pode usar este cmdlet para exibir a pilha de chamadas em um script ou função fora do depurador.

Para executar um Get-PSCallStack comando enquanto estiver no depurador, digite k ou Get-PSCallStack.

Exemplos

Exemplo 1: Obter a pilha de chamadas para uma função

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

Esse comando usa o Get-PSCallStack cmdlet para exibir a pilha de chamadas para My-Alias, uma função simples que obtém os aliases para um nome de cmdlet.

O primeiro comando insere a função no prompt do Windows PowerShell. O segundo comando usa o Set-PSBreakpoint cmdlet para definir um ponto de interrupção na My-Alias função. O terceiro comando usa a My-Alias função para obter todos os aliases na sessão atual para o Get-Content cmdlet.

O depurador interrompe na chamada de função. Dois comandos consecutivos step-into (s) começam a executar a função linha por linha. Em seguida, um Get-PSCallStack comando é usado para recuperar a pilha de chamadas.

O comando final é um Step-Out comando (o) que sai do depurador e continua executando o script até a conclusão.

Entradas

None

Você não pode canalizar objetos para esse cmdlet.

Saídas

CallStackFrame

Esse cmdlet retorna um objeto que representa os itens na pilha de chamadas.

Observações

O PowerShell inclui os seguintes aliases para Get-PSCallStack:

  • Todas as plataformas:
    • gcs