Trace-Command
Configureert en start een tracering van de opgegeven expressie of opdracht.
Syntax
expressionSet (Standaard)
Trace-Command
[-Name] <String[]>
[-Expression] <ScriptBlock>
[[-Option] <PSTraceSourceOptions>]
[-InputObject <PSObject>]
[-ListenerOption <TraceOptions>]
[-FilePath <String>]
[-Force]
[-Debugger]
[-PSHost]
[<CommonParameters>]
commandSet
Trace-Command
[-Name] <String[]>
[-Command] <String>
[[-Option] <PSTraceSourceOptions>]
[-InputObject <PSObject>]
[-ArgumentList <Object[]>]
[-ListenerOption <TraceOptions>]
[-FilePath <String>]
[-Force]
[-Debugger]
[-PSHost]
[<CommonParameters>]
Description
De cmdlet Trace-Command configureert en start een tracering van de opgegeven expressie of opdracht. Het werkt net 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
PS C:\> Trace-Command -Name metadata,parameterbinding,cmdlet -Expression {Get-Process Notepad} -PSHost
Met deze opdracht wordt een spoor gestart van metagegevensverwerking, parameterbinding en het maken en vernietigen van cmdlets van de Get-Process Notepad expressie.
Hierbij wordt de parameter Name gebruikt om de traceringsbronnen, de Expression parameter op te geven om de opdracht op te geven en de parameter PSHost om de uitvoer naar de console te verzenden.
Omdat er geen traceringsopties of listeneropties worden opgegeven, gebruikt de opdracht de standaardinstellingen: Alle voor de traceringsopties en Geen voor de listeneropties.
Voorbeeld 2: De acties van ParameterBinding-bewerkingen traceren
PS C:\> $A = "i*"
PS C:\> Trace-Command ParameterBinding {Get-Alias $Input} -PSHost -InputObject $A
Met deze opdrachten worden de acties van de ParameterBinding-bewerkingen van Windows PowerShell getraceerd terwijl er een Get-Alias-expressie wordt verwerkt die invoer uit de pijplijn neemt.
In Trace-Command geeft 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 variabele $A. De tweede opdracht maakt gebruik van de Trace-Command cmdlet met de ParameterBinding trace source. De parameter PSHost verzendt de uitvoer naar de console.
De expressie die wordt verwerkt is Get-Alias $Input, waarbij de variabele $Input is gekoppeld aan de parameter InputObject .
De parameter InputObject geeft de variabele $A door aan de expressie.
In feite wordt de opdracht die tijdens de tracering wordt verwerkt, Get-Alias -InputObject $A" or "$A | Get-Alias.
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.
Parametereigenschappen
| Type: | Object[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Argumenten |
Parametersets
commandSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Command
Hiermee geeft u een opdracht die wordt verwerkt tijdens de tracering.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
commandSet
| Position: | 1 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-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 Visual Studio. Met deze parameter wordt ook de standaardtraceerlistener geselecteerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Expression
Hiermee geeft u de expressie die wordt verwerkt tijdens de tracering. Plaats de expressie tussen accolades ({}).
Parametereigenschappen
| Type: | ScriptBlock |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
expressionSet
| Position: | 1 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-FilePath
Hiermee geeft u een bestand waarnaar de cmdlet de traceringsuitvoer verzendt. Met deze parameter wordt ook de listener voor bestandstracering geselecteerd.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | PSPath |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Force
Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd. Wordt gebruikt met de parameter FilePath. Zelfs als u de parameter Force gebruikt, kan de cmdlet geen beveiligingsbeperkingen overschrijven.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | PSObject |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | True |
| 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:
- Geen
- LogischeOperatieStapel
- Datum/tijd
- Tijdstempel
- ProcessId
- ThreadId
- Aanroepen
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'.
Parametereigenschappen
| Type: | TraceOptions |
| Default value: | None |
| Geaccepteerde waarden: | None, LogicalOperationStack, DateTime, Timestamp, ProcessId, ThreadId, Callstack |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Name
Hiermee geeft u een matrix op van Windows PowerShell-onderdelen die worden getraceerd.
Voer de naam in van de traceringsbron van elk onderdeel.
Wildcards zijn toegestaan.
Als u de traceringsbronnen op uw computer wilt vinden, typt u Get-TraceSource.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Option
Hiermee geeft u het type gebeurtenissen dat wordt getraceerd. De acceptabele waarden voor deze parameter zijn:
- Geen
- Constructeur
- Weggooien
- Eindschutter
- Methode
- Vastgoed
- Gedelegeerden
- Evenementen
- Uitzondering
- Vergrendelen
- Fout
- Fouten
- Waarschuwing
- Uitgebreid
- WriteLine
- Gegevens
- Omvang
- Uitvoering Flow
- Verklaren
- 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'.
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
(All)
| Position: | 2 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-PSHost
Geeft aan dat de cmdlet de trace-uitvoer naar de Windows PowerShell-host verzendt. Met deze parameter wordt ook de PSHost-traceerlistener geselecteerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| 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
PSObject
U kunt objecten die invoer voor de expressie vertegenwoordigen, overlijnen naar Trace-Command.
Uitvoerwaarden
PSObject
Retourneert de opdrachttracering in de foutopsporingsstroom.
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 Windows PowerShell-tracerings-cmdlets zijn ontworpen om Windows PowerShell-ontwikkelaars te helpen, maar ze zijn beschikbaar voor alle gebruikers. Hiermee kunt u vrijwel elk aspect van de functionaliteit van de shell bewaken.
Als u de Windows PowerShell-onderdelen wilt vinden die zijn ingeschakeld voor tracering, typt u
Get-Help Get-TraceSource.Een traceringsbron is het deel van elk Windows PowerShell-onderdeel dat tracering beheert en traceringsberichten voor het onderdeel genereert. 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 host of console, naar een bestand of naar een aangepaste listener die is afgeleid van de System.Diagnostics.TraceListener--klasse.
Wanneer u de parametersset commandSet gebruikt, verwerkt Windows PowerShell de opdracht op dezelfde manier als deze in een pijplijn zou worden verwerkt. Opdrachtdetectie wordt bijvoorbeeld niet herhaald voor elk binnenkomend object.
De namen van de parameters Naam, Expressie, Optie en Opdracht zijn optioneel. Als u de parameternamen weglaat, moeten de naamloze parameterwaarden in deze volgorde worden weergegeven: Naam, Expressie, Optie of Naam, Opdracht, Optie. Als u de parameternamen opneemt, kunnen de parameters in elke volgorde worden weergegeven.