Set Tracesource - PowerShell

Overview

Set-Tracesource configures settings for tracing in a .NET assembly. It enables or disables tracing, sets the trace level, and enables special tracing options.

Syntax

Set-Tracesource [-Name] <string> [-TraceLevel] <string> [-Enable] [-Disable] [-Filter] <string> [-HighPriority]

Options/Flags

  • -Name: Specifies the name of the tracesource object.
  • -TraceLevel: Sets the tracing level for the tracesource. Use one of the following options:
    • Off: Disables tracing.
    • Error: Traces only error messages.
    • Warning: Traces warnings and errors.
    • Info: Traces informational messages, warnings, and errors.
    • Verbose: Traces performance-related messages, informational messages, warnings, and errors.
  • -Enable: Enables tracing for the specified tracesource.
  • -Disable: Disables tracing for the specified tracesource.
  • -Filter: Specifies a filter to limit the messages traced. This filter uses the standard TraceSource filter syntax.
  • -HighPriority: Specifies that the tracesource should be high priority. This makes the tracesource more likely to be traced.

Examples

Example 1: Enable tracing for an assembly

Set-Tracesource -Name "MyAssembly" -Enable

Example 2: Set the tracing level for an assembly

Set-Tracesource -Name "MyAssembly" -TraceLevel "Verbose"

Example 3: Disable tracing for an assembly

Set-Tracesource -Name "MyAssembly" -Disable

Example 4: Enable high-priority tracing for an assembly

Set-Tracesource -Name "MyAssembly" -Enable -HighPriority

Example 5: Set tracing filter for an assembly

Set-Tracesource -Name "MyAssembly" -Filter "MyClass*"

Common Issues

  • Unable to find the specified tracesource: Ensure that the tracesource exists in the assembly.
  • Tracing is not being output: Check that the trace listener is configured to output messages.

Integration

Set-Tracesource can be used in conjunction with the Get-Tracesource and Remove-Tracesource commands to manage tracing for .NET assemblies.