Megosztás a következőn keresztül:

Trace-Command

Modul:
Microsoft.PowerShell.Utility Module

Konfigurálja és elindítja a megadott kifejezés vagy parancs nyomkövetését.

Syntax

expressionSet (Alapértelmezett) 

Trace-Command
    [-Name] <String[]>
    [-Expression] <ScriptBlock>
    [[-Option] <PSTraceSourceOptions>]
    [-InputObject <PSObject>]
    [-ListenerOption <TraceOptions>]
    [-FilePath <String>]
    [-Force]
    [-Debugger]
    [-PSHost]
    [<CommonParameters>]

commandSet 

Trace-Command
    [-Name] <String[]>
    [-Command] <String>
    [[-Option] <PSTraceSourceOptions>]
    [-InputObject <PSObject>]
    [-ArgumentList <Object[]>]
    [-ListenerOption <TraceOptions>]
    [-FilePath <String>]
    [-Force]
    [-Debugger]
    [-PSHost]
    [<CommonParameters>]

Description

A Trace-Command parancsmag konfigurálja és elindítja a megadott kifejezés vagy parancs nyomkövetését. Úgy működik, mint a Set-TraceSource, azzal a kivételrel, hogy csak a megadott parancsra vonatkozik.

Példák

1. példa: Metaadatok feldolgozásának nyomon követése, paraméterkötés és kifejezés

PS C:\> Trace-Command -Name metadata,parameterbinding,cmdlet -Expression {Get-Process Notepad} -PSHost

Ez a parancs elindítja a metaadatok feldolgozásának, a paraméterkötésnek, valamint a parancsmagok létrehozásának és megsemmisítésének nyomon követését a Get-Process Notepad kifejezéshez. A Name paramétert használja a nyomkövetési források megadásához, a parancs megadásához a Expression paramétert, a PSHost paramétert pedig a kimenet konzolra küldéséhez. Mivel nem ad meg nyomkövetési beállításokat vagy figyelőbeállításokat, a parancs az alapértelmezett értékeket használja – Az összes a nyomkövetési beállításokhoz, a Nincs a figyelő beállításaihoz.

2. példa: A ParameterBinding műveletek nyomon követése

PS C:\> $A = "i*"
PS C:\> Trace-Command ParameterBinding {Get-Alias $Input} -PSHost -InputObject $A

Ezek a parancsok nyomon követik a Windows PowerShell ParameterBinding műveleteinek műveleteit, miközben egy Get-Alias kifejezést dolgoznak fel, amely bemenetet vesz fel a folyamatból.

A nyomkövetési parancsInputObject paraméter átad egy objektumot a nyomkövetés során feldolgozott kifejezésnek.

Az első parancs az "i*" sztringet tárolja a $A változóban. A második parancs a Trace-Command parancsmagot használja a ParameterBinding nyomkövetési forrással. A PSHost paraméter elküldi a kimenetet a konzolnak.

A feldolgozandó kifejezés Get-Alias $Input, ahol a $Input változó az InputObject paraméterhez van társítva. Az InputObject paraméter átadja a $A változót a kifejezésnek. A nyomkövetés során feldolgozott parancs valójában Get-Alias -InputObject $A" or "$A | Get-Alias.

Paraméterek

-ArgumentList

Megadja a nyomkövetés alatt álló parancs paramétereit és paraméterértékeit. Az ArgumentList aliasa Args. Ez a funkció különösen hasznos a dinamikus paraméterek hibakereséséhez.

Paramétertulajdonságok

Típus:

Object[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Argumentumok

Paraméterkészletek

commandSet
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Command

A nyomkövetés során feldolgozott parancsot adja meg.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

commandSet
Position:1
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Debugger

Azt jelzi, hogy a parancsmag elküldi a nyomkövetési kimenetet a hibakeresőnek. A kimenetet bármely felhasználói vagy kernel módú hibakeresőben vagy a Visual Studióban tekintheti meg. Ez a paraméter az alapértelmezett nyomkövetési figyelőt is kiválasztja.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Expression

A nyomkövetés során feldolgozott kifejezést adja meg. A kifejezést kapcsos zárójelekbe ({}) csatolja.

Paramétertulajdonságok

Típus:ScriptBlock
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

expressionSet
Position:1
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-FilePath

Megadja azt a fájlt, amelybe a parancsmag elküldi a nyomkövetési kimenetet. Ez a paraméter a fájlkövetés-figyelőt is kiválasztja.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:PSPath

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Force

Kényszeríti a parancs futtatását anélkül, hogy felhasználói megerősítést kérne. A FilePath paraméterrel használható. A parancsmag még a Force paraméter használatával sem tudja felülbírálni a biztonsági korlátozásokat.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-InputObject

Megadja a nyomkövetés során feldolgozott kifejezés bemenetét.

Megadhat egy változót, amely a kifejezés által elfogadott bemenetet jelöli, vagy átadhat egy objektumot a folyamaton keresztül.

Paramétertulajdonságok

Típus:PSObject
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:True
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ListenerOption

Opcionális adatokat ad meg a kimenetben lévő nyomkövetési üzenetek előtagjára. A paraméter elfogadható értékei a következők:

  • Egyik sem
  • Logikai műveleti verem
  • Dátum/idő
  • Időbélyeg
  • ProcessId
  • Szálazonosító
  • Híváshívás

Egyik sem az alapértelmezett.

Több beállítás megadásához válassza el őket vesszőkkel, szóközök nélkül, és idézőjelek közé , például "ProcessID,ThreadID" (Folyamatazonosító, Szálazonosító) közé zárja őket.

Paramétertulajdonságok

Típus:TraceOptions
Alapértelmezett érték:None
Elfogadott értékek:None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Name

A nyomon követhető Windows PowerShell-összetevők tömbjét adja meg. Adja meg az egyes összetevők nyomkövetési forrásának nevét. Helyettesítő karakterek használata engedélyezett. A számítógépen található nyomkövetési források megkereséséhez írja be a Get-TraceSource.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:0
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Option

A nyomon követhető események típusát adja meg. A paraméter elfogadható értékei a következők:

  • Egyik sem
  • Konstruktor
  • Eltávolít
  • Finalizer
  • Metódus
  • Ingatlan
  • Delegáltak
  • Események
  • Kivétel
  • Lock
  • Hiba
  • Hibák
  • Figyelmeztetés
  • Részletezés
  • WriteLine
  • Adat
  • Hatókör
  • Végrehajtás
  • Állít
  • Összes

Minden az alapértelmezett.

A következő értékek más értékek kombinációi:

  • ExecutionFlow: (konstruktor, megsemmisítés, véglegesítő, metódus, meghatalmazottak, események és hatókör)
  • Adatok: (Konstruktor, Megsemmisítés, Finalizer, Tulajdonság, Részletes és WriteLine)
  • Hibák: (Hiba és kivétel).

Ha több lehetőséget szeretne megadni, vesszővel, szóközök nélkül elválaszthatja őket, és idézőjelekbe ( például "Konstruktor, Elidegenítés" ) csatolhatja őket.

Paramétertulajdonságok

Típus:PSTraceSourceOptions
Alapértelmezett érték:None
Elfogadott értékek:None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:2
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-PSHost

Azt jelzi, hogy a parancsmag elküldi a nyomkövetési kimenetet a Windows PowerShell-gazdagépnek. Ez a paraméter a PSHost nyomkövetési figyelőt is kiválasztja.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

PSObject

A kifejezés bemenetét jelző objektumokat a Trace-Command.

Kimenetek

PSObject

A hibakeresési adatfolyam parancskövetését adja vissza.

Jegyzetek

  • A nyomkövetés olyan módszer, amelyet a fejlesztők a programok hibakeresésére és finomítására használnak. A nyomkövetés során a program részletes üzeneteket hoz létre a belső feldolgozás egyes lépéseiről.

  • A Windows PowerShell nyomkövetési parancsmagjai úgy vannak kialakítva, hogy segítsenek a Windows PowerShell-fejlesztőknek, de minden felhasználó számára elérhetők. A rendszerhéj funkcióinak szinte minden aspektusát figyelheti.

  • A nyomkövetéshez engedélyezett Windows PowerShell-összetevők megkereséséhez írja be a Get-Help Get-TraceSource.

    A nyomkövetési forrás minden Olyan Windows PowerShell-összetevő része, amely kezeli a nyomkövetést, és nyomkövetési üzeneteket hoz létre az összetevőhöz. Egy összetevő nyomon követéséhez azonosítsa annak nyomkövetési forrását.

    A nyomkövetési figyelő megkapja a nyomkövetés kimenetét, és megjeleníti azt a felhasználónak. Dönthet úgy, hogy a nyomkövetési adatokat elküldi egy felhasználói módú vagy kernel módú hibakeresőnek, a gazdagépnek vagy a konzolnak, egy fájlnak vagy egy System.Diagnostics.TraceListener osztályból származó egyéni figyelőnek.

  • A commandSet paraméterkészlet használatakor a Windows PowerShell ugyanúgy dolgozza fel a parancsot, ahogyan azt egy folyamat feldolgozza. A parancsfelderítés például nem ismétlődik meg minden bejövő objektum esetében.

  • A Név, Kifejezés, Optionés Command paraméterek neve nem kötelező. Ha kihagyja a paraméterneveket, a meg nem nevezett paraméterértékek a következő sorrendben jelennek meg: Név, Kifejezés, Beállítás vagy Név, Parancs, Beállítás. Ha a paraméterneveket is tartalmazza, a paraméterek bármilyen sorrendben megjelenhetnek.