Set-TraceSource

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

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

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

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:PSPath, Path
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:TraceOptions
Accepted values:None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:PSTraceSourceOptions
Accepted values: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
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemoveFileListener

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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 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-TraceSourcegörüntülenir.