Set-TraceSource

Modul:

Microsoft.PowerShell.Utility Module

Mengonfigurasi, memulai, dan menghentikan jejak komponen PowerShell.

Sintaks

optionsSet (Default)

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

Deskripsi

cmdlet Set-TraceSource mengonfigurasi, memulai, dan menghentikan jejak komponen PowerShell. Anda dapat menggunakannya untuk menentukan komponen mana yang akan dilacak dan di mana output pelacakan dikirim.

Contoh

Contoh 1: Melacak komponen ParameterBinding

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

Perintah ini mulai melacak komponen ParameterBinding PowerShell. Ini menggunakan parameter Nama untuk menentukan sumber pelacakan, parameter Opsi untuk memilih peristiwa pelacakan ExecutionFlow, dan parameter PSHost untuk memilih pendengar host PowerShell, yang mengirim output ke konsol. Parameter ListenerOption menambahkan nilai ProcessId dan TimeStamp ke awalan pesan pelacakan.

Contoh 2: Menghentikan pelacakan

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

Perintah ini menghentikan jejak komponen ParameterBinding PowerShell. Ini menggunakan parameter Nama untuk mengidentifikasi komponen yang sedang dilacak dan parameter RemoveListener untuk mengidentifikasi pendengar jejak.

Parameter

-Debugger

Menunjukkan bahwa cmdlet mengirim output jejak ke debugger. Anda dapat melihat output dalam debugger mode pengguna atau mode kernel atau di Microsoft Visual Studio. Parameter ini juga memilih pendengar jejak default.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

optionsSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-FilePath

Menentukan file tempat cmdlet ini mengirim output pelacakan. Parameter ini juga memilih pendengar pelacakan file. Jika Anda menggunakan parameter ini untuk memulai pelacakan, gunakan parameter RemoveFileListener untuk menghentikan jejak.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	PSPath

Kumpulan parameter

optionsSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Force

Menunjukkan bahwa cmdlet menimpa file baca-saja. Gunakan dengan parameter FilePath .

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

optionsSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ListenerOption

Menentukan data opsional ke awalan setiap pesan jejak dalam output. Nilai yang dapat diterima untuk parameter ini adalah:

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

None adalah default.

Nilai-nilai ini didefinisikan sebagai enumerasi berbasis bendera. Anda dapat menggabungkan beberapa nilai bersama-sama untuk mengatur beberapa bendera menggunakan parameter ini. Nilai dapat diteruskan ke parameter listenerOption sebagai array nilai atau sebagai string yang dipisahkan koma dari nilai tersebut. Cmdlet akan menggabungkan nilai menggunakan operasi biner-OR. Meneruskan nilai sebagai array adalah opsi paling sederhana dan juga memungkinkan Anda menggunakan penyelesaian tab pada nilai.

Properti parameter

Jenis:	TraceOptions
Nilai default:	None
Nilai yang diterima:	None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

optionsSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Name

Menentukan komponen mana yang dilacak. Masukkan nama sumber pelacakan dari setiap komponen. Kartu liar diizinkan.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	True
DontShow:	False

Kumpulan parameter

(All)

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Option

Menentukan jenis peristiwa yang dilacak. Nilai yang dapat diterima untuk parameter ini adalah:

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

None adalah default.

Nilai berikut adalah kombinasi dari nilai lain:

• ExecutionFlow: Constructor, , FinalizerDispose, Method, Delegates, Events,Scope
• Data: Constructor, Dispose, Finalizer, Property, Verbose, , WriteLine
• Errors: Error, Exception

Nilai-nilai ini didefinisikan sebagai enumerasi berbasis bendera. Anda dapat menggabungkan beberapa nilai bersama-sama untuk mengatur beberapa bendera menggunakan parameter ini. Nilai dapat diteruskan ke parameter Opsi sebagai array nilai atau sebagai string yang dipisahkan koma dari nilai tersebut. Cmdlet akan menggabungkan nilai menggunakan operasi biner-OR. Meneruskan nilai sebagai array adalah opsi paling sederhana dan juga memungkinkan Anda menggunakan penyelesaian tab pada nilai.

Properti parameter

Jenis:	PSTraceSourceOptions
Nilai default:	None
Nilai yang diterima:	None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

optionsSet

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-PassThru

Mengembalikan objek yang mewakili item dengan mana Anda bekerja. Secara default, cmdlet ini tidak menghasilkan output apa pun.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

optionsSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-PSHost

Menunjukkan bahwa cmdlet ini mengirim output jejak ke host PowerShell. Parameter ini juga memilih pendengar jejak PSHost.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

optionsSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-RemoveFileListener

Menghentikan jejak dengan menghapus pendengar pelacakan file yang terkait dengan file yang ditentukan. Masukkan jalur dan nama file file output jejak.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

removeFileListenersSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-RemoveListener

Menghentikan jejak dengan menghapus pendengar jejak.

Gunakan nilai berikut dengan RemoveListener:

• Untuk menghapus PSHost (konsol), ketik Host.
• Untuk menghapus Debugger, ketik Debug.
• Untuk menghapus semua pendengar jejak, ketik *.

Untuk menghapus pendengar pelacakan file, gunakan parameter RemoveFileListener .

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

removeAllListenersSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

String

Anda dapat menyalurkan string yang berisi nama ke cmdlet ini.

Output

None

Secara default, cmdlet ini tidak mengembalikan output.

PSTraceSource

Saat Anda menggunakan parameter PassThru, cmdlet ini mengembalikan objek PSTraceSource yang mewakili sesi pelacakan.

Catatan

• Pelacakan adalah metode yang digunakan pengembang untuk men-debug dan menyempurnakan program. Saat melacak, program menghasilkan pesan terperinci tentang setiap langkah dalam pemrosesan internalnya.

  Cmdlet pelacakan PowerShell dirancang untuk membantu pengembang PowerShell, tetapi tersedia untuk semua pengguna. Mereka memungkinkan Anda memantau hampir setiap aspek fungsionalitas PowerShell.

  Sumber pelacakan adalah bagian dari setiap komponen PowerShell yang mengelola pelacakan dan menghasilkan pesan pelacakan untuk komponen. Untuk melacak komponen, Anda mengidentifikasi sumber pelacakannya.

  Pendengar jejak menerima output pelacakan dan menampilkannya kepada pengguna. Anda dapat memilih untuk mengirim data pelacakan ke debugger mode pengguna atau mode kernel, ke konsol, ke file, atau ke pendengar kustom yang berasal dari kelas System.Diagnostics.TraceListener.

• Untuk memulai pelacakan, gunakan parameter Nama untuk menentukan sumber pelacakan dan FilePath, Debugger, atau parameter PSHost untuk menentukan pendengar (tujuan untuk output). Gunakan parameter Opsi untuk menentukan jenis peristiwa yang ditelusuri dan parameter ListenerOption untuk mengonfigurasi output jejak.

• Untuk mengubah konfigurasi pelacakan, masukkan perintah Set-TraceSource seperti yang Anda lakukan untuk memulai pelacakan. PowerShell mengenali bahwa sumber pelacakan sudah dilacak. Ini menghentikan jejak, menambahkan konfigurasi baru, dan memulai atau memulai ulang jejak.

• Untuk menghentikan jejak, gunakan parameter RemoveListener. Untuk menghentikan jejak yang menggunakan pendengar file (jejak yang dimulai dengan menggunakan parameter FilePath), gunakan parameter RemoveFileListener . Saat Anda menghapus pendengar, jejak berhenti.

• Untuk menentukan komponen mana yang dapat dilacak, gunakan Get-TraceSource. Sumber pelacakan untuk setiap modul dimuat secara otomatis ketika komponen sedang digunakan, dan muncul dalam output Get-TraceSource.

Link Terkait

• Get-TraceSource
• Trace-Command