Set-TraceSource
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
PS C:\> 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étert használja a nyomkövetési forrás megadásához, 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 a TimeStamp értékeket a nyomkövetési üzenet előtaghoz.
2. példa: Nyomkövetés leállítása
PS C:\> 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: | False |
| 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 |
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:
- 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
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:
- 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
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
ndicates, 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
A Set-TraceSource
Kimenetek
None or System.Management.Automation.PSTraceSource
A PassThru paraméter használatakor Set-TraceSource létrehoz egy System.Management.Automation.PSTraceSource objektumot, amely a nyomkövetési munkamenetet jelöli. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.
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.