Set-TraceSource (Microsoft.PowerShell.Utility)

Set-TraceSource

Modül:

Microsoft.PowerShell.Utility

PowerShell bileşenlerinin izini yapılandırır, 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>]

Tanım

Set-TraceSource cmdlet'i bir PowerShell bileşeninin izini yapılandırır, başlatır ve durdurur. Hangi bileşenlerin izleneceğini ve izleme çıktısının nereye gönderileceğini belirlemek 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şenini izlemeyi başlatır. İzleme kaynağını belirtmek için Ad parametresini, ExecutionFlow izleme olaylarını seçmek için Option parametresini ve PSHost'u kullanır. Çıktıyı konsola gönderen PowerShell ana bilgisayar dinleyicisini seçmek için parametresi. ListenerOption parametresi, ProcessID ve TimeStamp değerlerini izleme mesajı önekine 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 Ad parametresini ve izleme dinleyicisini tanımlamak için RemoveListener parametresini kullanır.

Parametreler

-Debugger

Cmdlet'in izleme çıktısını hata ayıklayıcıya gönderdiğini belirtir. Çıktıyı herhangi bir kullanıcı modunda veya çekirdek modunda hata ayıklayıcıda veya Microsoft Visual Studio'da görüntüleyebilirsiniz. Bu parametre aynı zamanda varsayılan izleme dinleyicisini de seçer.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-FilePath

Bu cmdlet'in izleme çıktısını gönderdiği dosyayı belirtir. Bu parametre aynı zamanda dosya izleme dinleyicisini de seçer. İzlemeyi başlatmak için bu parametreyi kullanırsanız izlemeyi durdurmak için RemoveFileListener parametresini kullanın.

Tip :

String

Takma adlar:

PSPath, Path

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Force

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

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ListenerOption

Çıktıdaki her izleme iletisinin önekine isteğe bağlı verileri belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

None

LogicalOperationStack

DateTime

Timestamp

ProcessId

ThreadId

Callstack

Yok varsayılandır.

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 bir araya getirebilirsiniz. Değerler, ListenerOption parametresine bir değerler dizisi veya bu değerlerin virgülle ayrılmış dizesi olarak aktarılabilir. Cmdlet, ikili VEYA işlemini kullanarak değerleri birleştirir. Değerleri bir dizi olarak iletmek en basit seçenektir ve aynı zamanda değerler üzerinde sekme tamamlamayı kullanmanıza da olanak tanır.

Tip :

TraceOptions

Kabul edilen değerler:

Yok, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Name

Hangi bileşenlerin izleneceğini belirtir. Her bileşenin izleme kaynağının adını girin. Joker karakterlere izin verilir.

Tip :

String[]

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

True

-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

Tümü varsayılandır.

Aşağıdaki değerler diğer değerlerin birleşimidir:

• ExecutionFlow: Oluşturucu, Dispose, Sonlandırıcı, Yöntem, Temsilciler, Etkinlikler, Kapsam
• Veri: Oluşturucu, Dispose, Sonlandırıcı, Özellik, Verbose, WriteLine
• Hatalar: Hata, İstisna

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 bir araya getirebilirsiniz. Değerler, Option parametresine bir değerler dizisi veya bu değerlerin virgülle ayrılmış dizesi olarak aktarılabilir. Cmdlet, ikili VEYA işlemini kullanarak değerleri birleştirir. Değerleri bir dizi olarak iletmek en basit seçenektir ve aynı zamanda değerler üzerinde sekme tamamlamayı kullanmanıza da olanak tanır.

Tip :

PSTraceSourceSeçenekleri

Kabul edilen değerler:

Yok, Oluşturucu, Atma, Sonlandırıcı, Yöntem, Özellik, Temsilciler, Olaylar, İstisna, Kilit, Hata, Hatalar, Uyarı, Ayrıntılı, WriteLine, Veri, Kapsam, ExecutionFlow, Assert, Tümü

Konum:

1

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

False

-PassThru

Üzerinde çalıştığınız öğeyi temsil eden bir nesneyi döndürür. Varsayılan olarak bu cmdlet herhangi bir çıktı oluşturmaz.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-PSHost

Bu cmdlet'in izleme çıktısını PowerShell ana bilgisayarına gönderdiğini belirtir. Bu parametre aynı zamanda PSHost izleme dinleyicisini de seçer.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

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.

Tip :

String[]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-RemoveListener

İzleme dinleyicisini kaldırarak izlemeyi durdurur.

RemoveListener ile aşağıdaki değerleri kullanın:

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

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

Tip :

String[]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Dize

Bu cmdlet'e ad içeren bir dize aktarabilirsiniz.

Çıkışlar

Yok

Varsayılan olarak bu cmdlet hiçbir çıktı 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 hassaslaştırmak için kullandıkları bir yöntemdir. İzleme sırasında program, dahili işleminin her adımı hakkında ayrıntılı mesajlar üretir.

  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 tanırlar.

  İzleme kaynağı, her PowerShell bileşeninin izlemeyi yöneten ve bileşen için izleme mesajları oluşturan parçasıdır. Bir bileşeni izlemek için izleme kaynağını tanımlarsınız.

  İzleme dinleyicisi izlemenin çıktısını alır ve kullanıcıya görüntüler. İzleme verilerini bir kullanıcı modu veya çekirdek modu hata ayıklayıcıya, konsola, bir dosyaya veya System.Diagnostics.TraceListener sınıfından türetilen özel bir dinleyiciye göndermeyi seçebilirsiniz.

• Bir izleme başlatmak için, bir izleme kaynağı belirtmek üzere Ad parametresini ve DosyaPath, Hata Ayıklayıcı veya PSHost'u kullanın. Bir dinleyiciyi (çıkış için bir hedef) belirtmek için parametreler. İzlenen etkinlik türlerini belirlemek için Options parametresini ve izleme çıktısını yapılandırmak için ListenerOption parametresini kullanın.

• Bir izlemenin yapılandırmasını değiştirmek için, izleme başlatırken yaptığınız gibi bir Set-TraceSource komutunu girin. PowerShell, izleme kaynağının zaten izlenmekte olduğunu algılar. İzlemeyi durdurur, yeni konfigürasyonu ekler ve izlemeyi başlatır veya yeniden başlatır.

• Bir izlemeyi durdurmak için RemoveListener parametresini kullanın. Dosya dinleyicisini kullanan bir izlemeyi (FilePath parametresi kullanılarak başlatılan bir izleme) durdurmak için RemoveFileListener parametresini kullanın. Dinleyiciyi kaldırdığınızda iz durur.

• Hangi bileşenlerin izlenebileceğini belirlemek için Get-TraceSource'u kullanın. Her modülün izleme kaynakları, bileşen kullanımdayken otomatik olarak yüklenir ve Get-TraceSource çıktısında görünürler.