Set-TraceSource

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

Mit dem Cmdlet Set-TraceSource wird eine Ablaufverfolgung einer PowerShell-Komponente konfiguriert, gestartet und beendet. Sie können sie verwenden, um anzugeben, welche Komponenten nachverfolgt werden und wo die Ablaufverfolgungsausgabe gesendet wird.

PS C:\> Set-TraceSource -Name "ParameterBinding" -Option ExecutionFlow -PSHost -ListenerOption "ProcessId,TimeStamp"

Dieser Befehl startet die Ablaufverfolgung für die ParameterBinding-Komponente von PowerShell. Er verwendet den Name-Parameter, um die Ablaufverfolgungsquelle anzugeben , den Option-Parameter, um die ExecutionFlow-Ablaufverfolgungsereignisse auszuwählen, und den PSHost-Parameter , um den PowerShell-Hostlistener auszuwählen, der die Ausgabe an die Konsole sendet. Der Parameter ListenerOption fügt dem Präfix der Ablaufverfolgungsnachricht die Werte ProcessID und TimeStamp hinzu.

PS C:\> Set-TraceSource -Name "ParameterBinding" -RemoveListener "Host"

Mit diesem Befehl wird die Ablaufverfolgung der ParameterBinding-Komponente von PowerShell beendet. Er verwendet den parameter Name, um die Komponente zu identifizieren, die nachverfolgt wurde, und den RemoveListener Parameter, um den Ablaufverfolgungslistener zu identifizieren.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können eine Zeichenfolge, die einen Namen enthält, über die Pipeline an Set-TraceSource übergeben.

Wenn Sie den PassThru-Parameter verwenden, generiert Set-TraceSource ein System.Management.Automation.PSTraceSource-Objekt , das die Ablaufverfolgungssitzung darstellt. Andernfalls generiert dieses Cmdlet keine Ausgabe.

• Die Ablaufverfolgung ist eine Methode, die Entwickler zum Debuggen und Optimieren von Programmen verwenden. Bei der Ablaufverfolgung erzeugt das Programm ausführliche Meldungen zu den einzelnen Schritten in der internen Verarbeitung.

  Die PowerShell-Ablaufverfolgungs-Cmdlets sollen PowerShell-Entwickler unterstützen, aber sie sind für alle Benutzer verfügbar. Sie ermöglichen es Ihnen, nahezu jeden Aspekt der Funktionalität von PowerShell zu überwachen.

  Eine Ablaufverfolgungsquelle ist der Teil der einzelnen PowerShell-Komponenten, der die Ablaufverfolgung verwaltet und Meldungen zur Ablaufverfolgung für die Komponente generiert. Um eine Komponente zu verfolgen, identifizieren Sie deren Verfolgungsquelle.

  Ein Ablaufverfolgungslistener empfängt die Ausgabe der Ablaufverfolgung und zeigt sie dem Benutzer an. Sie können die Ablaufverfolgungsdaten an einen Benutzermodus- oder Kernelmodusdebugger, an die Konsole, an eine Datei oder an einen von der System.Diagnostics.TraceListener Klasse abgeleiteten benutzerdefinierten Listener senden.

• Verwenden Sie zum Starten einer Ablaufverfolgung den Parameter Name, um eine Ablaufverfolgungsquelle und die FilePath-, Debugger-oder PSHost- parameter anzugeben, um einen Listener (ein Ziel für die Ausgabe) anzugeben. Verwenden Sie den parameter Options, um die Typen von Ereignissen zu bestimmen, die nachverfolgt werden, und den ListenerOption Parameter zum Konfigurieren der Ablaufverfolgungsausgabe.

• Um die Konfiguration einer Ablaufverfolgung zu ändern, geben Sie den Befehl Set-TraceSource ein, wie Sie es zum Starten einer Ablaufverfolgung tun würden. PowerShell erkennt, dass die Ablaufverfolgungsquelle bereits nachverfolgt wird. Die Ablaufverfolgung wird beendet, die neue Konfiguration hinzugefügt und die Ablaufverfolgung gestartet oder neu gestartet.

• Verwenden Sie zum Beenden einer Ablaufverfolgung den parameter RemoveListener. Um eine Ablaufverfolgung zu beenden, die den Dateilistener verwendet (eine Ablaufverfolgung, die mit dem FilePath Parameter gestartet wurde), verwenden Sie den RemoveFileListener Parameter. Wenn Sie den Listener entfernen, wird die Ablaufverfolgung beendet.

• Verwenden Sie Get-TraceSource, um zu bestimmen, welche Komponenten nachverfolgt werden können. Die Ablaufverfolgungsquellen für jedes Modul werden automatisch geladen, wenn die Komponente verwendet wird, und sie werden in der Ausgabe von Get-TraceSource angezeigt.