Set-TraceSource

Modül:

Microsoft.PowerShell.Utility Module

PowerShell bileşenlerinin bir izlemesini yapılandırıp başlatır ve durdurur.

Sözdizimi

optionsSet EnterprisePublishing

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

Set-TraceSource cmdlet'i 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 için ExecutionFlow parametresini ve çıkışı konsola gönderen PowerShell ana bilgisayar dinleyicisini seçmek için pshost parametresini kullanır. ListenerOption parametresi, izleme iletisi ön ekine ProcessId ve TimeStamp değerlerini ekler.

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

optionsSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	PSPath, Yol

Parametre kümeleri

optionsSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Force

Cmdlet'in salt okunur bir dosyanın üzerine yazdığını gösterir. FilePath parametresiyle kullanın.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

optionsSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ListenerOption

Çıktıdaki her izleme iletisinin ön ekine isteğe bağlı verileri belirtir. Bu parametre için kabul edilebilir değerler ş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.

Parametre özellikleri

Tür:	TraceOptions
Default value:	None
Kabul edilen değerler:	None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

optionsSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Name

İzlenen bileşenleri belirtir. Her bileşenin izleme kaynağının adını girin. Joker karakterlere izin verilir.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

(All)

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Option

İzlenen olayların türünü belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

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

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

Parametre özellikleri

Tür:	PSTraceSourceOptions
Default value:	None
Kabul edilen değerler:	None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

optionsSet

Position:	1
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

optionsSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

optionsSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RemoveFileListener

Belirtilen dosyayla ilişkili dosya izleme dinleyicisini kaldırarak izlemeyi durdurur. İzleme çıktı dosyasının yolunu ve dosya adını girin.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

removeFileListenersSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RemoveListener

İzleme dinleyicisini kaldırarak izlemeyi durdurur.

RemoveListenerile aşağıdaki değerleri kullanın:

• PSHost'ı (konsol) kaldırmak için Hostyazın.
• Hata Ayıklayıcı'yı kaldırmak için Debugyazın.
• Tüm izleme dinleyicilerini kaldırmak için *yazın.

Dosya izleme dinleyicisini kaldırmak için RemoveFileListener parametresini kullanın.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

removeAllListenersSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

Ad içeren bir dizeyi bu cmdlet'e aktarabilirsiniz.

Çıkışlar

None

Varsayılan olarak, bu cmdlet çıkış döndürmez.

PSTraceSource

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 kullanıcı modu veya çekirdek modu hata ayıklayıcısına, konsola, dosyaya veya System.Diagnostics.TraceListener sınıfından türetilen özel bir dinleyiciye göndermeyi seçebilirsiniz.

• İzleme başlatmak için Name parametresini kullanarak bir izleme kaynağı ve FilePath, Debuggerveya pshost parametreleri belirterek bir dinleyici (çıkış hedefi) belirtin. İzlenen olay türlerini belirlemek için Seçenekleri 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 komutu 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 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ımdayken her modülün izleme kaynakları otomatik olarak yüklenir ve Get-TraceSourceçıkışında görünür.

İlişkili Bağlantılar

• Get-TraceSource
• İzleme Komutu