Get-PSCallStack
現在の呼び出し履歴を表示します。
構文
Get-PSCallStack []
説明
コマンドレットは Get-PSCallStack
、現在の呼び出し履歴を表示します。
このコマンドレットは Windows PowerShell デバッガーで使用するよう設計されていますが、デバッガー外部のスクリプトまたは関数で呼び出し履歴を表示するために使用できます。
デバッガーでコマンドを Get-PSCallStack
実行するには、 または と入力 k
します Get-PSCallStack
。
例
例 1: 関数の呼び出し履歴を取得する
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
このコマンドでは、 コマンドレットを Get-PSCallStack
使用して の呼び出し履歴 My-Alias
を表示します。これは、コマンドレット名のエイリアスを取得する単純な関数です。
最初のコマンドは、Windows PowerShell プロンプトで関数を入力します。 2 番目のコマンドでは、 コマンドレットを Set-PSBreakpoint
使用して関数にブレークポイントを My-Alias
設定します。 3 番目のコマンドでは、 関数を My-Alias
使用して、 コマンドレットの現在のセッションのすべてのエイリアスを Get-Content
取得します。
デバッガーは関数呼び出しに割り込みます。 2 つの連続する step-into
(s
) コマンドによって、関数が 1 行ずつ実行されます。 次に、コマンドを Get-PSCallStack
使用して呼び出し履歴を取得します。
最後のコマンドは、デバッガーを Step-Out
終了し、スクリプトの実行を続行して完了するコマンド (o
) です。
入力
None
オブジェクトをこのコマンドレットにパイプすることはできません。
出力
このコマンドレットは、呼び出し履歴内の項目を表す オブジェクトを返します。
メモ
PowerShell には、 の次のエイリアスが Get-PSCallStack
含まれています。
- すべてのプラットフォーム:
gcs