Set-TraceSource

Modul:

Microsoft.PowerShell.Utility Module

Konfigurálja, elindítja és leállítja a PowerShell-összetevők nyomkövetését.

Syntax

optionsSet (Alapértelmezett)

Set-TraceSource
    [-Name] <String[]>
    [[-Option] <PSTraceSourceOptions>]
    [-ListenerOption <TraceOptions>]
    [-FilePath <String>]
    [-Force]
    [-Debugger]
    [-PSHost]
    [-PassThru]
    [<CommonParameters>]

removeAllListenersSet

Set-TraceSource
    [-Name] <String[]>
    [-RemoveListener <String[]>]
    [<CommonParameters>]

removeFileListenersSet

Set-TraceSource
    [-Name] <String[]>
    [-RemoveFileListener <String[]>]
    [<CommonParameters>]

Description

A Set-TraceSource parancsmag konfigurálja, elindítja és leállítja egy PowerShell-összetevő nyomkövetését. Ezzel megadhatja, hogy mely összetevők lesznek nyomon követve, és hol küldik el a nyomkövetési kimenetet.

Példák

1. példa: A ParameterBinding összetevő nyomon követése

Set-TraceSource -Name "ParameterBinding" -Option ExecutionFlow -PSHost -ListenerOption "ProcessId,TimeStamp"

Ez a parancs elkezdi nyomon követni a PowerShell ParameterBinding összetevőjét. A Name paraméter használatával adja meg a nyomkövetési forrást, a Option paramétert a ExecutionFlow nyomkövetési események kiválasztásához, a PSHost paramétert pedig a PowerShell-gazdagép figyelőjének kiválasztásához, amely elküldi a kimenetet a konzolnak. A ListenerOption paraméter hozzáadja a ProcessId és TimeStamp értékeket a nyomkövetési üzenet előtaghoz.

2. példa: Nyomkövetés leállítása

Set-TraceSource -Name "ParameterBinding" -RemoveListener "Host"

Ez a parancs leállítja a PowerShell ParameterBinding összetevőjének nyomkövetését. A Name paraméter használatával azonosítja a nyomon követendő összetevőt, és a RemoveListener paramétert a nyomkövetési figyelő azonosításához.

Paraméterek

-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 Microsoft 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

optionsSet

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

-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. Ha ezt a paramétert használja a nyomkövetés elindításához, a nyomkövetés leállításához használja a RemoveFileListener paramétert.

Paramétertulajdonságok

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

Paraméterkészletek

optionsSet

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

Azt jelzi, hogy a parancsmag felülír egy írásvédett fájlt. Használja a FilePath paraméterrel.

Paramétertulajdonságok

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

Paraméterkészletek

optionsSet

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

-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:

• None
• LogicalOperationStack
• DateTime
• Timestamp
• ProcessId
• ThreadId
• Callstack

A None az alapértelmezett.

Ezek az értékek jelölőalapú számbavételként vannak definiálva. Több érték kombinálásával több jelölőt is beállíthat ezzel a paraméterrel. Az értékek átadhatók a ListenerOption paraméternek értéktömbként vagy az értékek vesszővel elválasztott sztringjeként. A parancsmag bináris VAGY művelettel egyesíti az értékeket. Az értékek tömbként való átadása a legegyszerűbb lehetőség, és lehetővé teszi a tabulátorkiegészítés használatát is az értékeken.

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

optionsSet

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

Meghatározza, hogy mely összetevők legyenek nyomon követve. Adja meg az egyes összetevők nyomkövetési forrásának nevét. Helyettesítő karakterek használata engedélyezett.

Paramétertulajdonságok

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

Paraméterkészletek

(All)

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
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:

• None
• Constructor
• Dispose
• Finalizer
• Method
• Property
• Delegates
• Events
• Exception
• Lock
• Error
• Errors
• Warning
• Verbose
• WriteLine
• Data
• Scope
• ExecutionFlow
• Assert
• All

A None az alapértelmezett.

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

• ExecutionFlow: Constructor, Dispose, FinalizerMethod, Delegates, , EventsScope
• Data: Constructor, Dispose, FinalizerProperty, , VerboseWriteLine
• Errors: Error, Exception

Ezek az értékek jelölőalapú számbavételként vannak definiálva. Több érték kombinálásával több jelölőt is beállíthat ezzel a paraméterrel. Az értékek átadhatók a Option paraméternek értéktömbként vagy az értékek vesszővel elválasztott sztringjeként. A parancsmag bináris VAGY művelettel egyesíti az értékeket. Az értékek tömbként való átadása a legegyszerűbb lehetőség, és lehetővé teszi a tabulátorkiegészítés használatát is az értékeken.

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

optionsSet

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

-PassThru

Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Paramétertulajdonságok

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

Paraméterkészletek

optionsSet

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

-PSHost

Azt jelzi, hogy ez a parancsmag elküldi a nyomkövetési kimenetet a 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

optionsSet

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

-RemoveFileListener

A megadott fájlhoz társított fájlkövetés-figyelő eltávolításával leállítja a nyomkövetést. Adja meg a nyomkövetési kimeneti fájl elérési útját és fájlnevét.

Paramétertulajdonságok

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

Paraméterkészletek

removeFileListenersSet

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

-RemoveListener

A nyomkövetési figyelő eltávolításával leállítja a nyomkövetést.

Használja a következő értékeket RemoveListener:

• A PSHost (konzol) eltávolításához írja be a Host.
• A Hibakereső eltávolításához írja be a Debug.
• Az összes nyomkövetési figyelő eltávolításához írja be a *.

A fájlkövetés-figyelő eltávolításához használja a RemoveFileListener paramétert.

Paramétertulajdonságok

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

Paraméterkészletek

removeAllListenersSet

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

String

Erre a parancsmagra egy nevet tartalmazó sztringet is csövezhet.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

PSTraceSource

A PassThru paraméter használatakor ez a parancsmag egy PSTraceSource objektumot ad vissza, amely a nyomkövetési munkamenetet jelöli.

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 PowerShell nyomkövetési parancsmagjait úgy tervezték, hogy segítsenek a PowerShell-fejlesztőknek, de minden felhasználó számára elérhetők. Lehetővé teszik a PowerShell funkcióinak szinte minden aspektusának monitorozását.

  A nyomkövetési forrás minden olyan 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 konzolnak, egy fájlnak vagy egy System.Diagnostics.TraceListener osztályból származó egyéni figyelőnek.

• Nyomkövetés indításához a Név paraméterrel adjon meg egy nyomkövetési forrást és a FilePath, Hibakeresővagy PSHost paramétereket a figyelő (a kimenet célhelye) megadásához. A nyomkövetési kimenet konfigurálásához használja a Beállítások paramétert a nyomon követendő eseménytípusok és a ListenerOption paraméter meghatározásához.

• A nyomkövetés konfigurációjának módosításához adjon meg egy Set-TraceSource parancsot a nyomkövetés indításához. A PowerShell felismeri, hogy a nyomkövetési forrás már nyomon van követve. Leállítja a nyomkövetést, hozzáadja az új konfigurációt, és elindítja vagy újraindítja a nyomkövetést.

• A nyomkövetés leállításához használja a RemoveListener paramétert. A fájlfigyelőt használó nyomkövetés (a FilePath paraméterrel indított nyomkövetés) leállításához használja a RemoveFileListener paramétert. Amikor eltávolítja a figyelőt, a nyomkövetés leáll.

• Annak meghatározásához, hogy mely összetevők követhetők nyomon, használja a Get-TraceSource-t. Az egyes modulok nyomkövetési forrásai automatikusan töltődnek be, amikor az összetevő használatban van, és megjelennek a Get-TraceSourcekimenetében.

Kapcsolódó hivatkozások

• Get-TraceSource
• Trace-Command