Trace-Command

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

Belirtilen ifadenin veya komutun bir izlemesini yapılandırıp başlatır.

Syntax

Trace-Command
     [-InputObject <PSObject>]
     [-Name] <String[]>
     [[-Option] <PSTraceSourceOptions>]
     [-Expression] <ScriptBlock>
     [-ListenerOption <TraceOptions>]
     [-FilePath <String>]
     [-Force]
     [-Debugger]
     [-PSHost]
     [<CommonParameters>]
Trace-Command
     [-InputObject <PSObject>]
     [-Name] <String[]>
     [[-Option] <PSTraceSourceOptions>]
     [-Command] <String>
     [-ArgumentList <Object[]>]
     [-ListenerOption <TraceOptions>]
     [-FilePath <String>]
     [-Force]
     [-Debugger]
     [-PSHost]
     [<CommonParameters>]

Description

cmdlet'i Trace-Command , belirtilen ifade veya komutu yapılandırıp izler. Yalnızca belirtilen komut için geçerli olması dışında Set-TraceSource gibi çalışır.

Örnekler

Örnek 1: Meta veri işlemeyi, parametre bağlamayı ve ifadeyi izleme

Bu örnek, meta veri işleme, parametre bağlama ve cmdlet oluşturma ve yok etme işlemlerinin bir izlemesini Get-Process Notepad başlatır.

Trace-Command -Name metadata,parameterbinding,cmdlet -Expression {Get-Process Notepad} -PSHost

İzleme kaynaklarını belirtmek için Name parametresini, komutu belirtmek için expression parametresini ve çıkışı konsola göndermek için PSHost parametresini kullanır. herhangi bir izleme seçeneği veya dinleyici seçeneği belirtmediğinden, komut varsayılan değerleri kullanır:

  • İzleme seçenekleri için tümü
  • Dinleyici seçenekleri için yok

Örnek 2: ParameterBinding işlemlerinin eylemlerini izleme

Bu örnek, işlem hattından giriş alan bir Get-Alias ifadeyi işlerken PowerShell'in ParameterBinding işlemlerinin eylemlerini izler.

$A = "i*"
Trace-Command ParameterBinding {Get-Alias $Input} -PSHost -InputObject $A

içindeTrace-Command, InputObject parametresi izleme sırasında işlenen ifadeye bir nesne geçirir.

İlk komut dizeyi i* değişkeninde $A depolar. İkinci komut, ParameterBinding izleme kaynağıyla cmdlet'ini kullanır Trace-Command . PSHost parametresi çıkışı konsola gönderir.

İşlenen ifade, Get-Alias $Inputdeğişkenin $Input InputObject parametresiyle ilişkilendirildiği ifadesidir. InputObject parametresi değişkeni $A ifadeye geçirir. Sonuç olarak, izleme sırasında işlenen komut olur Get-Alias -InputObject $A" or "$A | Get-Alias.

Örnek 3: Yerel komutlar için Trace ParameterBinding işlemleri

PowerShell 7.3, yerel komutlar için parametre bağlamasını izleme özelliğini ekledi. Aşağıdaki örnekte PowerShell'in yerel TestExekomutu için komut satırı bağımsız değişkenlerini nasıl ayrıştırıyor olduğu gösterilmektedir.

$a = 'a" "b'
Trace-Command -PSHOST -Name ParameterBinding { TestExe -echoargs $a 'c" "d' e" "f }

DEBUG: 2023-02-27 14:20:45.3975 ParameterBinding Information: 0 : BIND NAMED native application line args [C:\Public\Toolbox\TestExe\testexe.exe]
DEBUG: 2023-02-27 14:20:45.3978 ParameterBinding Information: 0 :     BIND cmd line arg [-echoargs] to position [0]
DEBUG: 2023-02-27 14:20:45.3979 ParameterBinding Information: 0 :     BIND cmd line arg [a" "b] to position [1]
DEBUG: 2023-02-27 14:20:45.3980 ParameterBinding Information: 0 :     BIND cmd line arg [c" "d] to position [2]
DEBUG: 2023-02-27 14:20:45.3982 ParameterBinding Information: 0 :     BIND cmd line arg [e f] to position [3]
DEBUG: 2023-02-27 14:20:47.6092 ParameterBinding Information: 0 : CALLING BeginProcessing

Parametreler

-ArgumentList

İzlenen komut için parametreleri ve parametre değerlerini belirtir. ArgumentList diğer adı Args'dir. Bu özellik, dinamik parametrelerin hatalarını ayıklamak için kullanışlıdır.

ArgumentList'in davranışı hakkında daha fazla bilgi için bkz. about_Splatting.

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

-Command

İzleme sırasında işlenen bir komutu belirtir.

Bu parametreyi kullandığınızda, PowerShell komutu bir işlem hattında işlendiği gibi işler. Örneğin, gelen her nesne için komut bulma işlemi yinelenemez.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

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

-Expression

İzleme sırasında işlenen ifadeyi belirtir. İfadeyi ayraç ( içine alın{}).

Type:ScriptBlock
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-FilePath

cmdlet'in izleme çıkışını gönderdiği bir dosyayı belirtir. Bu parametre ayrıca dosya izleme dinleyicisini seçer.

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

-Force

Komutu, kullanıcı onayı istemeden çalışmaya zorlar. FilePath parametresiyle kullanılır. Zorla parametresi kullanıldığında bile cmdlet güvenlik kısıtlamalarını geçersiz kılamaz.

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

-InputObject

İzleme sırasında işlenen ifadenin girişini belirtir. İfadenin kabul ettiği girişi temsil eden bir değişken girebilir veya bir nesneyi işlem hattından geçirebilirsiniz.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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 bir PowerShell bileşenleri dizisini belirtir. Her bileşenin izleme kaynağının adını girin. Joker karakterlere izin verilir. Bilgisayarınızda izleme kaynaklarını bulmak için yazın Get-TraceSource.

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

-Option

İzlenen olayların türünü belirler. 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:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PSHost

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

Girişler

PSObject

İfadenin girişini temsil eden nesneleri bu cmdlet'e aktarabilirsiniz.

Çıkışlar

PSObject

Bu cmdlet kendi çıkışını döndürmez. İzlenen komut çıkış döndürebilir. Bu cmdlet, komut izlemesini hata ayıklama akışına yazar.

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. Kabuğun 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 için etkinleştirilmiş PowerShell bileşenlerinin listesini görmek için kullanın Get-TraceSource .

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