Condividi tramite

Set-TraceSource

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Configura, avvia e arresta una traccia dei componenti di PowerShell.

Sintassi

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

Descrizione

Il cmdlet Set-TraceSource configura, avvia e arresta una traccia di un componente di PowerShell. È possibile usarlo per specificare quali componenti verranno tracciati e dove viene inviato l'output di traccia.

Esempio

Esempio 1: Tracciare il componente ParameterBinding

Set-TraceSource -Name "ParameterBinding" -Option ExecutionFlow -PSHost -ListenerOption "ProcessId,TimeStamp"

Questo comando avvia la traccia per il componente ParameterBinding di PowerShell. Usa il parametro nome per specificare l'origine di traccia, il parametro Option per selezionare gli eventi di traccia e il parametro PSHost per selezionare il listener host di PowerShell, che invia l'output alla console. Il parametro ListenerOption aggiunge i valori e al prefisso del messaggio di traccia.

Esempio 2: Arrestare una traccia

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

Questo comando arresta la traccia del componente ParameterBinding di PowerShell. Usa il parametro name per identificare il componente che è stato tracciato e il parametro RemoveListener per identificare il listener di traccia.

Parametri

-Debugger

Indica che il cmdlet invia l'output di traccia al debugger. È possibile visualizzare l'output in qualsiasi debugger in modalità utente o in modalità kernel o in Microsoft Visual Studio. Questo parametro seleziona anche il listener di traccia predefinito.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FilePath

Specifica un file a cui questo cmdlet invia l'output di traccia. Questo parametro seleziona anche il listener di traccia file. Se si usa questo parametro per avviare la traccia, usare il parametro RemoveFileListener per arrestare la traccia.

Tipo:String
Alias:PSPath, Path
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Indica che il cmdlet sovrascrive un file di sola lettura. Usare con il parametro FilePath.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ListenerOption

Specifica i dati facoltativi per il prefisso di ogni messaggio di traccia nell'output. I valori accettabili per questo parametro sono:

  • None
  • LogicalOperationStack
  • DateTime
  • Timestamp
  • ProcessId
  • ThreadId
  • Callstack

None è l'impostazione predefinita.

Questi valori sono definiti come enumerazione basata su flag. È possibile combinare più valori per impostare più flag usando questo parametro. I valori possono essere passati al parametro ListenerOption come matrice di valori o come stringa delimitata da virgole di tali valori. Il cmdlet combina i valori usando un'operazione binary-OR. Il passaggio di valori come matrice è l'opzione più semplice e consente anche di usare il completamento tramite tabulazione sui valori.

Tipo:TraceOptions
Valori accettati:None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica quali componenti vengono tracciati. Immettere il nome dell'origine di traccia di ogni componente. Sono consentiti caratteri jolly.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-Option

Specifica il tipo di eventi tracciati. I valori accettabili per questo parametro sono:

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

All è l'impostazione predefinita.

I valori seguenti sono combinazioni di altri valori:

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

Questi valori sono definiti come enumerazione basata su flag. È possibile combinare più valori per impostare più flag usando questo parametro. I valori possono essere passati al parametro option come matrice di valori o come stringa delimitata da virgole di tali valori. Il cmdlet combina i valori usando un'operazione binary-OR. Il passaggio di valori come matrice è l'opzione più semplice e consente anche di usare il completamento tramite tabulazione sui valori.

Tipo:PSTraceSourceOptions
Valori accettati:None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PassThru

Restituisce un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PSHost

Indica che questo cmdlet invia l'output di traccia all'host di PowerShell. Questo parametro seleziona anche il listener di traccia PSHost.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveFileListener

Arresta la traccia rimuovendo il listener di traccia file associato al file specificato. Immettere il percorso e il nome file del file di output della traccia.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveListener

Arresta la traccia rimuovendo il listener di traccia.

Usare i valori seguenti con RemoveListener:

  • Per rimuovere PSHost (console), digitare Host.
  • Per rimuovere Debugger, digitare Debug.
  • Per rimuovere tutti i listener di traccia, digitare *.

Per rimuovere il listener di traccia del file, usare il parametro removeFileListener .

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

È possibile inviare tramite pipe una stringa contenente un nome a questo cmdlet.

Output

None

Per impostazione predefinita, questo cmdlet non restituisce alcun output.

PSTraceSource

Quando si utilizza il parametro PassThru , questo cmdlet restituisce un oggetto PSTraceSource che rappresenta la sessione di traccia.

Note

  • La traccia è un metodo che gli sviluppatori usano per eseguire il debug e perfezionare i programmi. Durante la traccia, il programma genera messaggi dettagliati su ogni passaggio nell'elaborazione interna.

    I cmdlet di traccia di PowerShell sono progettati per aiutare gli sviluppatori di PowerShell, ma sono disponibili per tutti gli utenti. Consentono di monitorare quasi ogni aspetto della funzionalità di PowerShell.

    Un'origine di traccia è la parte di ogni componente di PowerShell che gestisce la traccia e genera messaggi di traccia per il componente. Per tracciare un componente, identificarne l'origine di traccia.

    Un listener di traccia riceve l'output della traccia e lo visualizza all'utente. È possibile scegliere di inviare i dati di traccia a un debugger in modalità utente o in modalità kernel, alla console, a un file o a un listener personalizzato derivato dalla classe System.Diagnostics.TraceListener.

  • Per avviare una traccia, usare il parametro Nome per specificare un'origine di traccia e il FilePath, Debuggero parametri di PSHost per specificare un listener (destinazione per l'output). Usare il parametro Options per determinare i tipi di eventi tracciati e il parametro ListenerOption per configurare l'output della traccia.

  • Per modificare la configurazione di una traccia, immettere un comando Set-TraceSource come si desidera avviare una traccia. PowerShell riconosce che l'origine di traccia è già in corso di traccia. Arresta la traccia, aggiunge la nuova configurazione e avvia o riavvia la traccia.

  • Per arrestare una traccia, usare il parametro RemoveListener. Per arrestare una traccia che usa il listener di file (una traccia avviata usando il parametro FilePath ), usare il parametro RemoveFileListener. Quando si rimuove il listener, la traccia si arresta.

  • Per determinare quali componenti possono essere tracciati, usare Get-TraceSource. Le origini di traccia per ogni modulo vengono caricate automaticamente quando il componente è in uso e vengono visualizzate nell'output di Get-TraceSource.