Trace-command

Fiche express
Cmdlet	Trace-Command
Rôle	Débogage bas niveau
Voir aussi	Set-PSDebug

Trace-Command active une trace détaillée du fonctionnement interne d'une expression PowerShell (découverte de commandes, liaison de paramètres, conversion de types…).

Usage

# Tracer la découverte de commandes
Trace-Command -Name CommandDiscovery -Expression { Get-Date > text.txt } -PSHost

# Tracer la liaison de paramètres
Trace-Command -Name ParameterBinding -Expression { Get-Date > text.txt } -PSHost

Options principales

-Name             type d'éléments à tracer (source de trace)
-Expression       expression à exécuter sous trace
-FilePath         envoie la trace dans un fichier
-PSHost           envoie la trace sur la console
-ListenerOption   niveau de détail de chaque ligne de trace

Sources de trace fréquentes :

TypeConversion    mécanique de conversion de types
CommandDiscovery  interprète de commandes
ParameterBinding  association des paramètres lors d'un appel
FormatViewBinding indique si une vue prédéfinie existe

Trace-Command -Name TypeConversion   -Expression { [char]$var = 65 } -PSHost
Trace-Command -Name CommandDiscovery -Expression { c:\monscript.ps1 } -PSHost

Lister les sources disponibles : Get-TraceSource.

Voir aussi

• Set-PSDebug — mode pas à pas et trace globale
• Set-PSBreakpoint — points d'arrêt