Condividi tramite

Set-TraceSource

Modulo:
Microsoft.PowerShell.Utility Module

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

Sintassi

optionsSet (impostazione predefinita). 

Set-TraceSource
    [-Name] <String[]>
    [[-Option] <PSTraceSourceOptions>]
    [-ListenerOption <TraceOptions>]
    [-FilePath <String>]
    [-Force]
    [-Debugger]
    [-PSHost]
    [-PassThru]
    [<CommonParameters>]

removeAllListenersSet 

Set-TraceSource
    [-Name] <String[]>
    [-RemoveListener <String[]>]
    [<CommonParameters>]

removeFileListenersSet 

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 ExecutionFlow e il parametro PSHost per selezionare il listener host di PowerShell, che invia l'output alla console. Il parametro ListenerOption aggiunge i valori ProcessId e TimeStamp 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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

optionsSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:PSPath, Percorso

Set di parametri

optionsSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Force

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

optionsSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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 un'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 array è l'opzione più semplice e consente anche di usare il completamento automatico con il tasto tab sui valori.

Proprietà dei parametri

Tipo:TraceOptions
Valore predefinito:None
Valori accettati:None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

optionsSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

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

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-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

None è l'impostazione predefinita.

I valori seguenti sono combinazioni di altri valori:

  • ExecutionFlow: Constructor, Dispose, FinalizerMethod, Delegates, , EventsScope
  • Data: Constructor, Dispose, Finalizer, Property, VerboseWriteLine
  • Errors: Error, Exception

Questi valori sono definiti come un'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 array è l'opzione più semplice e consente anche di usare il completamento automatico con il tasto tab sui valori.

Proprietà dei parametri

Tipo:PSTraceSourceOptions
Valore predefinito:None
Valori accettati:None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

optionsSet
Posizione:1
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-PassThru

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

optionsSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PSHost

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

optionsSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

removeFileListenersSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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 .

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

removeAllListenersSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

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.