Delen via

Set-TraceSource

  • Referentie
Module:
Microsoft.PowerShell.Utility

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

Syntaxis

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

PS C:\> 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 uitvoeringsstroomtracerings 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 waarden ProcessID en TimeStamp toe aan het traceringsberichtvoorvoegsel.

Voorbeeld 2: Een tracering stoppen

PS C:\> 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:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Aliassen:PSPath
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ListenerOption

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

  • Geen
  • LogicalOperationStack
  • Datum/tijd
  • Tijdstempel
  • ProcessId
  • ThreadId
  • Callstack

Geen is de standaardinstelling.

Als u meerdere opties wilt opgeven, scheidt u deze met komma's, maar zonder spaties en plaatst u deze tussen aanhalingstekens, zoals 'ProcessID,ThreadID'.

Type:TraceOptions
Geaccepteerde waarden:None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

-Option

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

  • Geen
  • Bouwer
  • Beschikken
  • Finalizer
  • Methode
  • Eigenschap
  • Afgevaardigden
  • Gebeurtenissen
  • Uitzondering
  • Slot
  • Fout
  • Fouten
  • Waarschuwing
  • Breedsprakig
  • WriteLine
  • Gegevens
  • Draagwijdte
  • ExecutionFlow
  • Beweren
  • Alle

Alles is de standaardinstelling.

De volgende waarden zijn combinaties van andere waarden:

  • ExecutionFlow: (constructor, verwijdering, finalizer, methode, gemachtigden, gebeurtenissen en bereik)
  • Gegevens: (Constructor, Verwijderen, Finalizer, Eigenschap, Uitgebreid en WriteLine)
  • Fouten: (fout en uitzondering).

Als u meerdere opties wilt opgeven, scheidt u deze met komma's, maar zonder spaties en plaatst u deze tussen aanhalingstekens, zoals 'Constructor, Verwijderen'.

Type:PSTraceSourceOptions
Geaccepteerde waarden: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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks met een naam doorsluisen naar Set-TraceSource-.

Uitvoerwaarden

None or System.Management.Automation.PSTraceSource

Wanneer u de parameter PassThru gebruikt, genereert Set-TraceSource- een System.Management.Automation.PSTraceSource-object dat de traceringssessie vertegenwoordigt. Anders genereert deze cmdlet geen uitvoer.

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