Delen via

Set-TraceSource

Module:
Microsoft.PowerShell.Utility Module

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

Syntaxis

optionsSet (Standaard) 

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

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, de parameter Option op te geven om de ExecutionFlow tracerings gebeurtenissen te selecteren en de parameter PSHost- om de PowerShell-hostlistener te selecteren, waarmee de uitvoer naar de console wordt verzonden. De parameter ListenerOption voegt de ProcessId- en TimeStamp-waarden toe aan het traceringsberichtvoorvoegsel.

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.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

optionsSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:PSPath, Path

Parametersets

optionsSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Force

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

optionsSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ListenerOption

Hiermee geeft u optionele gegevens aan het voorvoegsel van elk traceringsbericht in de uitvoer. De acceptabele 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 parameter ListenerOption 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.

Parametereigenschappen

Type:TraceOptions
Default value:None
Geaccepteerde waarden:None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Ondersteunt jokertekens:False
DontShow:False

Parametersets

optionsSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Option

Hiermee geeft u het type gebeurtenissen dat wordt getraceerd. De acceptabele 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

None 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.

Parametereigenschappen

Type:PSTraceSourceOptions
Default value:None
Geaccepteerde waarden:None, Constructor, Dispose, Finalizer, Method, Property, Delegates, Events, Exception, Lock, Error, Errors, Warning, Verbose, WriteLine, Data, Scope, ExecutionFlow, Assert, All
Ondersteunt jokertekens:False
DontShow:False

Parametersets

optionsSet
Position:1
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-PassThru

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

optionsSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PSHost

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

optionsSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

removeFileListenersSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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 u Host.
  • Als u het foutopsporingsprogramma wilt verwijderen, typt u Debug.
  • Als u alle traceringslisteners wilt verwijderen, typt u *.

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

removeAllListenersSet
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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.TraceListen er.

  • Als u een tracering wilt starten, gebruikt u de parameter Name om een traceringsbron en de FilePath-op te geven, Foutopsporingsprogrammaof PSHost- parameters om een listener (een bestemming voor de uitvoer) op te geven. Gebruik de parameter Options 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 behulp van 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.