Trace-Command

Referentie

Module:: Microsoft.PowerShell.Utility

Hiermee configureert en start u een tracering van de opgegeven expressie of opdracht.

Syntax

Trace-Command
     [-InputObject <PSObject>]
     [-Name] <String[]>
     [[-Option] <PSTraceSourceOptions>]
     [-Expression] <ScriptBlock>
     [-ListenerOption <TraceOptions>]
     [-FilePath <String>]
     [-Force]
     [-Debugger]
     [-PSHost]
     [<CommonParameters>]

Trace-Command
     [-InputObject <PSObject>]
     [-Name] <String[]>
     [[-Option] <PSTraceSourceOptions>]
     [-Command] <String>
     [-ArgumentList <Object[]>]
     [-ListenerOption <TraceOptions>]
     [-FilePath <String>]
     [-Force]
     [-Debugger]
     [-PSHost]
     [<CommonParameters>]

Description

De Trace-Command cmdlet configureert en start een tracering van de opgegeven expressie of opdracht. Het werkt als Set-TraceSource, behalve dat deze alleen van toepassing is op de opgegeven opdracht.

Voorbeelden

Voorbeeld 1: Verwerking van metagegevens, parameterbinding en een expressie traceren

In dit voorbeeld wordt een tracering gestart van de verwerking van metagegevens, parameterbinding en het maken en vernietigen van de Get-Process Notepad expressie.

Trace-Command -Name metadata,parameterbinding,cmdlet -Expression {Get-Process Notepad} -PSHost

Hierbij wordt de parameter Name gebruikt om de traceringsbronnen op te geven, de expressieparameter om de opdracht op te geven en de PSHost-parameter om de uitvoer naar de console te verzenden. Omdat er geen traceringsopties of listeneropties worden opgegeven, gebruikt de opdracht de standaardinstellingen:

Alles voor de traceringsopties
Geen voor de listeneropties

Voorbeeld 2: De acties van ParameterBinding-bewerkingen traceren

In dit voorbeeld worden de acties van de ParameterBinding-bewerkingen van PowerShell bij het verwerken van een Get-Alias expressie die invoer uit de pijplijn neemt.

$A = "i*"
Trace-Command ParameterBinding {Get-Alias $Input} -PSHost -InputObject $A

In Trace-Commandgeeft de parameter InputObject een object door aan de expressie die tijdens de tracering wordt verwerkt.

Met de eerste opdracht wordt de tekenreeks i* opgeslagen in de $A variabele. De tweede opdracht maakt gebruik van de Trace-Command cmdlet met de ParameterBinding-traceringsbron. De PSHost-parameter verzendt de uitvoer naar de console.

De expressie die wordt verwerkt, is Get-Alias $Input, waarbij de $Input variabele is gekoppeld aan de parameter InputObject . De parameter InputObject geeft de variabele $A door aan de expressie. In feite is Get-Alias -InputObject $A" or "$A | Get-Aliasde opdracht die tijdens de tracering wordt verwerkt.

Parameters

-ArgumentList

Hiermee geeft u de parameters en parameterwaarden voor de opdracht die wordt getraceerd. De alias voor ArgumentList is Args. Deze functie is vooral handig voor het opsporen van fouten in dynamische parameters.

Zie about_Splatting voor meer informatie over het gedrag van ArgumentList.

Type:	Object[]
Aliases:	Args
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Command

Hiermee geeft u een opdracht die wordt verwerkt tijdens de tracering.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Debugger

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

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

-Expression

Hiermee geeft u de expressie op die wordt verwerkt tijdens de tracering. Plaats de expressie tussen accolades ({}).

Type:	ScriptBlock
Position:	1
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-FilePath

Hiermee geeft u een bestand waarnaar de cmdlet de traceringsuitvoer verzendt. Met deze parameter wordt ook de listener voor bestandstracering geselecteerd.

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

-Force

Dwingt de opdracht uit te voeren zonder te vragen om bevestiging van de gebruiker. Wordt gebruikt met de parameter FilePath . Zelfs als u de parameter Force gebruikt, kan de cmdlet geen beveiligingsbeperkingen negeren.

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

-InputObject

Hiermee geeft u invoer op voor de expressie die tijdens de tracering wordt verwerkt. U kunt een variabele invoeren die de invoer vertegenwoordigt die door de expressie wordt geaccepteerd of een object doorgeven via de pijplijn.

Type:	PSObject
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ListenerOption

Hiermee geeft u optionele gegevens op voor 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 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 stelt u ook in staat om tabvoltooiing te gebruiken voor de waarden.

Type:	TraceOptions
Accepted values:	None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Hiermee geeft u een matrix van PowerShell-onderdelen op die worden getraceerd. Voer de naam in van de traceringsbron van elk onderdeel. Jokertekens zijn toegestaan. Als u de traceringsbronnen op uw computer wilt zoeken, typt u Get-TraceSource.

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

-Option

Bepaalt 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, Delegates, Events, Scope
Data: Constructor, Dispose, Finalizer, Property, Verbose, WriteLine
Errors: Error, Exception

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 stelt u ook in staat om tabvoltooiing te 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:	2
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PSHost

Geeft aan dat de cmdlet de traceringsuitvoer naar de PowerShell-host verzendt. Deze parameter selecteert ook de PSHost-tracelistener.

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

Invoerwaarden

PSObject

U kunt objecten doorsluisen die de invoer voor de expressie vertegenwoordigen.Trace-Command

Uitvoerwaarden