Aracılığıyla paylaş

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

cmdlet'i Set-TraceSource bir PowerShell bileşeninin izlemesini yapılandırıp başlatır ve durdurur. 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 ve TimeStamp değerlerini izleme iletisi ön ekine eklerProcessID.

Örnek 2: İzlemeyi durdurma

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

Bu komut, PowerShell'in ParameterBinding bileşeninin izini 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ı sabit listesi olarak tanımlanır. Bu parametreyi kullanarak birden çok bayrağı ayarlamak için birden çok değeri birleştirebilirsiniz. Değerler, bir değer dizisi veya bu değerlerin virgülle ayrılmış dizesi olarak ListenerOption parametresine 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 ayrıca değerlerde sekme tamamlama özelliğini kullanmanıza 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 bileşimleridir:

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

Bu değerler, bayrak tabanlı sabit listesi olarak tanımlanır. Bu parametreyi kullanarak birden çok bayrağı ayarlamak için birden çok değeri 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 ayrıca değerlerde sekme tamamlama özelliğini kullanmanıza 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 çıktı üretmez.

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 adresine aktarabilirsiniz Set-TraceSource.

Çıkışlar

None or System.Management.Automation.PSTraceSource

PassThru parametresini kullandığınızda, Set-TraceSource izleme oturumunu temsil eden bir System.Management.Automation.PSTraceSource nesnesi oluşturur. Aksi takdirde, bu cmdlet herhangi bir çıkış oluşturmaz.

Notlar

  • İzleme, geliştiricilerin programlarda hata ayıklamak ve bunları daraltmak 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 işlevselliğinin neredeyse tüm yönlerini 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ü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ünür.