Get-PSCallStack

  • Referentie
Module:
Microsoft.PowerShell.Utility

Geeft de huidige aanroepstack weer.

Syntax

Get-PSCallStack []

Description

De Get-PSCallStack cmdlet geeft de huidige aanroepstack weer.

Hoewel het is ontworpen voor gebruik met het Windows PowerShell-foutopsporingsprogramma, kunt u deze cmdlet gebruiken om de aanroepstack weer te geven in een script of functie buiten het foutopsporingsprogramma.

Als u een Get-PSCallStack opdracht wilt uitvoeren in het foutopsporingsprogramma, typt k of Get-PSCallStack.

Voorbeelden

Voorbeeld 1: De aanroepstack voor een functie ophalen

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

Met deze opdracht wordt de Get-PSCallStack cmdlet gebruikt om de aanroepstack weer te geven voor My-Alias, een eenvoudige functie waarmee de aliassen voor een cmdlet-naam worden ophaalt.

De eerste opdracht voert de functie in bij de Windows PowerShell-prompt. De tweede opdracht gebruikt de Set-PSBreakpoint cmdlet om een onderbrekingspunt voor de My-Alias functie in te stellen. De derde opdracht gebruikt de My-Alias functie om alle aliassen in de huidige sessie voor de Get-Content cmdlet op te halen.

Het foutopsporingsprogramma breekt in bij de functieaanroep. Twee opeenvolgende step-into (s) opdrachten beginnen met het uitvoeren van de functieregel per regel. Vervolgens wordt een Get-PSCallStack opdracht gebruikt om de aanroepstack op te halen.

De laatste opdracht is een Step-Out opdracht (o) waarmee het foutopsporingsprogramma wordt afgesloten en het script wordt uitgevoerd om het te voltooien.

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

CallStackFrame

Deze cmdlet retourneert een object dat de items in de aanroepstack vertegenwoordigt.

Notities

PowerShell bevat de volgende aliassen voor Get-PSCallStack:

  • Alle platforms:
    • gcs