Set-TraceSource

  • Referentie
Module:
Microsoft.PowerShell.Utility

Configureert, start en stopt een tracering van PowerShell-onderdelen.

Syntax

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

Description

De Set-TraceSource cmdlet configureert, start en stopt een tracering van een PowerShell-onderdeel. U kunt deze gebruiken om op te geven welke onderdelen worden getraceerd en waar de traceringsuitvoer wordt verzonden.

Voorbeelden

Voorbeeld 1: Het parameterbinding-onderdeel traceren

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

Met deze opdracht wordt tracering gestart voor het parameterbinding-onderdeel van PowerShell. Hierbij wordt de parameter Name gebruikt om de traceringsbron op te geven, de optieparameter om de ExecutionFlow tracerings gebeurtenissen te selecteren en de PSHost-parameter om de PowerShell-hostlister te selecteren, waarmee de uitvoer naar de console wordt verzonden. De parameter ListenerOption voegt de ProcessID waarden toe TimeStamp aan het voorvoegsel van het traceringsbericht.

Voorbeeld 2: Een tracering stoppen

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

Met deze opdracht wordt de tracering van het ParameterBinding-onderdeel van PowerShell gestopt. Hierbij wordt de parameter Name gebruikt om het onderdeel te identificeren dat is getraceerd en de parameter RemoveListener om de traceringslistener te identificeren.

Parameters

-Debugger

Geeft aan dat de cmdlet de traceringsuitvoer naar het foutopsporingsprogramma verzendt. U kunt de uitvoer weergeven in elk foutopsporingsprogramma in de gebruikersmodus of kernelmodus of in Microsoft Visual Studio. Met deze parameter wordt ook de standaardtraceerlistener geselecteerd.

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

-FilePath

Hiermee geeft u een bestand op waarnaar deze cmdlet de traceringsuitvoer verzendt. Met deze parameter wordt ook de listener voor bestandstracering geselecteerd. Als u deze parameter gebruikt om de tracering te starten, gebruikt u de parameter RemoveFileListener om de tracering te stoppen.

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

-Force

Geeft aan dat de cmdlet een alleen-lezenbestand overschrijft. Gebruik deze met de FilePath-parameter .

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

-ListenerOption

Hiermee geeft u optionele gegevens aan het voorvoegsel van elk traceringsbericht in de uitvoer. De aanvaardbare waarden voor deze parameter zijn:

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

None is de standaardwaarde.

Deze waarden worden gedefinieerd als een opsomming op basis van vlaggen. U kunt meerdere waarden combineren om meerdere vlaggen in te stellen met behulp van deze parameter. De waarden kunnen worden doorgegeven aan de listenerOption-parameter als een matrix met waarden of als een door komma's gescheiden tekenreeks van deze waarden. De cmdlet combineert de waarden met behulp van een binaire OF-bewerking. Het doorgeven van waarden als een matrix is de eenvoudigste optie en u kunt ook tabvoltooiing gebruiken voor de waarden.

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

Hiermee geeft u op welke onderdelen worden getraceerd. Voer de naam in van de traceringsbron van elk onderdeel. Jokertekens zijn toegestaan.

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

-Option

Hiermee geeft u het type gebeurtenissen dat wordt getraceerd. De aanvaardbare waarden voor deze parameter zijn:

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

All is de standaardwaarde.

De volgende waarden zijn combinaties van andere waarden:

  • ExecutionFlow: Constructor, Dispose, Finalizer, , Method, , DelegatesEventsScope
  • Data: Constructor, Dispose, Finalizer, , VerbosePropertyWriteLine
  • Errors: , ErrorException

Deze waarden worden gedefinieerd als een opsomming op basis van vlaggen. U kunt meerdere waarden combineren om meerdere vlaggen in te stellen met behulp van deze parameter. De waarden kunnen worden doorgegeven aan de parameter Option als een matrix met waarden of als een door komma's gescheiden tekenreeks van deze waarden. De cmdlet combineert de waarden met behulp van een binaire OF-bewerking. Het doorgeven van waarden als een matrix is de eenvoudigste optie en u kunt ook tabvoltooiing gebruiken voor de waarden.

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:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.

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

-PSHost

Geeft aan dat deze cmdlet de traceringsuitvoer naar de PowerShell-host verzendt. Met deze parameter wordt ook de PSHost-traceerlistener geselecteerd.

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

-RemoveFileListener

Hiermee stopt u de tracering door de listener voor bestandstracering te verwijderen die is gekoppeld aan het opgegeven bestand. Voer het pad en de bestandsnaam van het traceringsuitvoerbestand in.

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

-RemoveListener

Hiermee stopt u de tracering door de traceringslistener te verwijderen.

Gebruik de volgende waarden met RemoveListener:

  • Als u PSHost (console) wilt verwijderen, typt Hostu .
  • Als u het foutopsporingsprogramma wilt verwijderen, typt Debugu .
  • Als u alle traceerlisteners wilt verwijderen, typt *u .

Als u de listener voor bestandstracering wilt verwijderen, gebruikt u de parameter RemoveFileListener .

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

Invoerwaarden

String

U kunt een tekenreeks met een naam naar deze cmdlet doorsluisen.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

PSTraceSource

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een PSTraceSource-object dat de traceringssessie vertegenwoordigt.

Notities

  • Tracering is een methode die ontwikkelaars gebruiken om programma's op te sporen en te verfijnen. Bij het traceren genereert het programma gedetailleerde berichten over elke stap in de interne verwerking.

    De PowerShell-tracerings-cmdlets zijn ontworpen om PowerShell-ontwikkelaars te helpen, maar ze zijn beschikbaar voor alle gebruikers. Hiermee kunt u vrijwel elk aspect van de functionaliteit van PowerShell bewaken.

    Een traceringsbron is het onderdeel van elk PowerShell-onderdeel dat tracering beheert en traceringsberichten genereert voor het onderdeel. Als u een onderdeel wilt traceren, identificeert u de bijbehorende traceringsbron.

    Een traceerlistener ontvangt de uitvoer van de tracering en geeft deze weer aan de gebruiker. U kunt ervoor kiezen om de traceringsgegevens te verzenden naar een foutopsporingsprogramma in de gebruikersmodus of kernelmodus, naar de console, naar een bestand of naar een aangepaste listener die is afgeleid van de klasse System.Diagnostics.TraceListener .

  • Als u een tracering wilt starten, gebruikt u de parameter Name om een traceringsbron en de parameters FilePath, Debugger of PSHost op te geven om een listener (een bestemming voor de uitvoer) op te geven. Gebruik de parameter Opties om de typen gebeurtenissen te bepalen die worden getraceerd en de parameter ListenerOption om de traceringsuitvoer te configureren.

  • Als u de configuratie van een tracering wilt wijzigen, voert u een Set-TraceSource opdracht in zoals u een tracering wilt starten. PowerShell herkent dat de traceringsbron al wordt getraceerd. Hiermee wordt de tracering gestopt, wordt de nieuwe configuratie toegevoegd en wordt de trace gestart of opnieuw gestart.

  • Als u een tracering wilt stoppen, gebruikt u de parameter RemoveListener . Als u een tracering wilt stoppen die gebruikmaakt van de bestandslistener (een tracering die is gestart met de parameter FilePath ), gebruikt u de parameter RemoveFileListener . Wanneer u de listener verwijdert, stopt de tracering.

  • Gebruik Get-TraceSource om te bepalen welke onderdelen kunnen worden getraceerd. De traceringsbronnen voor elke module worden automatisch geladen wanneer het onderdeel wordt gebruikt en worden weergegeven in de uitvoer van Get-TraceSource.