Set-TraceSource
PowerShell bileşenlerinin bir izlemesini yapılandırıp başlatır ve durdurur.
Sözdizimi
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
Set-TraceSource
Cmdlet bir PowerShell bileşenini yapılandırıyor, başlatıyor ve durduruyor. Hangi bileşenlerin izleneceğini ve izleme çıkışının nereye gönderileceğini belirtmek için bunu kullanabilirsiniz.
Örnekler
Örnek 1: ParameterBinding bileşenini izleme
Set-TraceSource -Name "ParameterBinding" -Option ExecutionFlow -PSHost -ListenerOption "ProcessId,TimeStamp"
Bu komut, PowerShell'in ParameterBinding bileşeni için izlemeyi başlatır. İzleme kaynağını belirtmek için Name parametresini, izleme olaylarını seçmek ExecutionFlow
için Option parametresini ve çıkışı konsola gönderen PowerShell konak dinleyicisini seçmek için PSHost parametresini kullanır. ListenerOption parametresi, izleme iletisi ön ekine ve TimeStamp
değerlerini eklerProcessID
.
Örnek 2: İzlemeyi durdurma
Set-TraceSource -Name "ParameterBinding" -RemoveListener "Host"
Bu komut, PowerShell'in ParameterBinding bileşeninin izlemesini durdurur. İzlenen bileşeni tanımlamak için Name parametresini ve izleme dinleyicisini tanımlamak için RemoveListener parametresini kullanır.
Parametreler
-Debugger
Cmdlet'in izleme çıkışını hata ayıklayıcıya gönderdiğini gösterir. Çıkışı herhangi bir kullanıcı modunda veya çekirdek modu hata ayıklayıcısında veya Microsoft Visual Studio'da görüntüleyebilirsiniz. Bu parametre ayrıca varsayılan izleme dinleyicisini seçer.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-FilePath
Bu cmdlet'in izleme çıkışını gönderdiği dosyayı belirtir. Bu parametre ayrıca dosya izleme dinleyicisini seçer. İzlemeyi başlatmak için bu parametreyi kullanırsanız, izlemeyi durdurmak için RemoveFileListener parametresini kullanın.
Tür: | String |
Diğer adlar: | PSPath |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Force
Cmdlet'in salt okunur bir dosyanın üzerine yazdığını gösterir. FilePath parametresiyle kullanın.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ListenerOption
Çıktıdaki her izleme iletisinin ön ekine isteğe bağlı verileri belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
None
LogicalOperationStack
DateTime
Timestamp
ProcessId
ThreadId
Callstack
None
varsayılan değerdir.
Bu değerler, bayrak tabanlı bir numaralandırma olarak tanımlanır. Bu parametreyi kullanarak birden çok bayrak ayarlamak için birden çok değeri birlikte birleştirebilirsiniz. Değerler, ListenerOption parametresine bir değer dizisi veya bu değerlerin virgülle ayrılmış dizesi olarak geçirilebilir. cmdlet'i bir ikili OR işlemi kullanarak değerleri birleştirir. Değerleri dizi olarak geçirmek en basit seçenektir ve değerler üzerinde sekme tamamlama özelliğini kullanmanıza da olanak tanır.
Tür: | TraceOptions |
Kabul edilen değerler: | None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Name
İzlenen bileşenleri belirtir. Her bileşenin izleme kaynağının adını girin. Joker karakterlere izin verilir.
Tür: | String[] |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | True |
-Option
İzlenen olayların türünü belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:
None
Constructor
Dispose
Finalizer
Method
Property
Delegates
Events
Exception
Lock
Error
Errors
Warning
Verbose
WriteLine
Data
Scope
ExecutionFlow
Assert
All
All
varsayılan değerdir.
Aşağıdaki değerler diğer değerlerin birleşimleridir:
ExecutionFlow
:Constructor
,Dispose
,Finalizer
,Method
,Delegates
,Events
,Scope
Data
:Constructor
,Dispose
,Finalizer
,Property
,Verbose
,WriteLine
Errors
:Error
,Exception
Bu değerler, bayrak tabanlı bir numaralandırma olarak tanımlanır. Bu parametreyi kullanarak birden çok bayrak ayarlamak için birden çok değeri birlikte birleştirebilirsiniz. Değerler Option parametresine bir değer dizisi veya bu değerlerin virgülle ayrılmış dizesi olarak geçirilebilir. cmdlet'i bir ikili OR işlemi kullanarak değerleri birleştirir. Değerleri dizi olarak geçirmek en basit seçenektir ve değerler üzerinde sekme tamamlama özelliğini kullanmanıza da olanak tanır.
Tür: | PSTraceSourceOptions |
Kabul edilen değerler: | None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All |
Position: | 1 |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | True |
Joker karakterleri kabul et: | False |
-PassThru
Üzerinde çalıştığınız öğeyi temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-PSHost
Bu cmdlet'in izleme çıkışını PowerShell konağına gönderdiğini gösterir. Bu parametre ayrıca PSHost izleme dinleyicisini seçer.
Tür: | SwitchParameter |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-RemoveFileListener
Belirtilen dosyayla ilişkili dosya izleme dinleyicisini kaldırarak izlemeyi durdurur. İzleme çıktı dosyasının yolunu ve dosya adını girin.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-RemoveListener
İzleme dinleyicisini kaldırarak izlemeyi durdurur.
RemoveListener ile aşağıdaki değerleri kullanın:
- PSHost'ı (konsol) kaldırmak için yazın
Host
. - Hata Ayıklayıcı'yı kaldırmak için yazın
Debug
. - Tüm izleme dinleyicilerini kaldırmak için yazın
*
.
Dosya izleme dinleyicisini kaldırmak için RemoveFileListener parametresini kullanın.
Tür: | String[] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
Ad içeren bir dizeyi bu cmdlet'e aktarabilirsiniz.
Çıkışlar
None
Varsayılan olarak, bu cmdlet çıkış döndürmez.
PassThru parametresini kullandığınızda, bu cmdlet izleme oturumunu temsil eden bir PSTraceSource nesnesi döndürür.
Notlar
İzleme, geliştiricilerin programlarda hata ayıklamak ve bunları iyileştirmek için kullandığı bir yöntemdir. İzleme sırasında program, iç işlemedeki her adım hakkında ayrıntılı iletiler oluşturur.
PowerShell izleme cmdlet'leri PowerShell geliştiricilerine yardımcı olmak için tasarlanmıştır, ancak tüm kullanıcılar tarafından kullanılabilir. PowerShell'in işlevselliğinin neredeyse her yönünü izlemenize olanak sağlar.
İzleme kaynağı, her PowerShell bileşeninin izlemeyi yöneten ve bileşen için izleme iletileri oluşturan bölümüdür. Bir bileşeni izlemek için izleme kaynağını tanımlarsınız.
İzleme dinleyicisi izlemenin çıkışını alır ve kullanıcıya görüntüler. İzleme verilerini bir kullanıcı moduna veya çekirdek modu hata ayıklayıcısına, konsola, dosyaya veya System.Diagnostics.TraceListener sınıfından türetilmiş özel bir dinleyiciye göndermeyi seçebilirsiniz.
İzleme başlatmak için, bir izleme kaynağı belirtmek için Name parametresini ve bir dinleyici (çıktının hedefi) belirtmek için FilePath, Debugger veya PSHost parametrelerini kullanın. İzlenen olay türlerini belirlemek için Options parametresini ve izleme çıkışını yapılandırmak için ListenerOption parametresini kullanın.
İzlemenin yapılandırmasını değiştirmek için, izleme başlatmak için yaptığınız gibi bir
Set-TraceSource
komut girin. PowerShell, izleme kaynağının zaten izlendiğini algılar. İzlemeyi durdurur, yeni yapılandırmayı ekler ve izlemeyi başlatır veya yeniden başlatır.İzlemeyi durdurmak için RemoveListener parametresini kullanın. Dosya dinleyicisini kullanan bir izlemeyi durdurmak için (FilePath parametresi kullanılarak başlatılan bir izleme), RemoveFileListener parametresini kullanın. Dinleyiciyi kaldırdığınızda izleme durdurulur.
hangi bileşenlerin izleneceğini belirlemek için Get-TraceSource kullanın. Bileşen kullanımda olduğunda her modülün izleme kaynakları otomatik olarak yüklenir ve çıkışında
Get-TraceSource
görüntülenir.
İlişkili Bağlantılar
PowerShell