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

Set-TraceSource

  • Referencia
Modul:
Microsoft.PowerShell.Utility

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

Syntax

Set-TraceSource
   [-Name] <String[]>
   [[-Option] <PSTraceSourceOptions>]
   [-ListenerOption <TraceOptions>]
   [-FilePath <String>]
   [-Force]
   [-Debugger]
   [-PSHost]
   [-PassThru]
   [<CommonParameters>]
Set-TraceSource
   [-Name] <String[]>
   [-RemoveListener <String[]>]
   [<CommonParameters>]
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 Név paraméter használatával adja meg a nyomkövetési forrást, az Option paramétert a nyomkövetési ExecutionFlow 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 az és TimeStamp az ProcessID é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 Név paraméter használatával azonosítja a nyomkövetés alatt álló összetevőt, a RemoveListener paramétert pedig 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.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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 RemoveFileListener paraméter használatával állítsa le a nyomkövetést.

Típus:String
Aliasok:PSPath, Path
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

-Force

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

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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 formátum.

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.

Típus:TraceOptions
Elfogadott értékek:None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:String[]
Position:0
Alapértelmezett érték:None
Kötelező:True
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:True

-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 All az alapértelmezett formátum.

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 az 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.

Típus:PSTraceSourceOptions
Elfogadott értékek:None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All
Position:1
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:True
Helyettesítő karakterek elfogadása:False

-PassThru

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

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:SwitchParameter
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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.

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása: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 a RemoveListenerrel:

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

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

Típus:String[]
Position:Named
Alapértelmezett érték:None
Kötelező:False
Folyamatbemenet elfogadása:False
Helyettesítő karakterek elfogadása:False

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 elküldi a nyomkövetési adatokat egy felhasználói módú vagy kernel módú hibakeresőnek, a konzolnak, egy fájlnak vagy a 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 adja meg a FilePath, a Hibakereső vagy a PSHost paramétert egy figyelő (a kimenet célhelye) megadásához. A Beállítások paraméter használatával határozza meg a nyomkövetési események típusait, a FigyelőOption paramétert pedig a nyomkövetési kimenet konfigurálá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 (a FilePath paraméterrel indított nyomkövetést) használó 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 kimenetben Get-TraceSource.