AttachAttach

L’option Attach de VSPerfCmd.exe démarre le profilage par échantillonnage du processus en cours d’exécution spécifié par l’ID de processus (PID).The VSPerfCmd.exe Attach option begins sample profiling of the running process specified by the process ID (PID).

Pour utiliser l’option Attach, vous devez spécifier la méthode Sample dans l’option Start.To use the Attach option, you must specify the Sample method in the Start option.

Note

Si l’option Start a été spécifiée avec l’option Crosssession, les appels à VSPerfCmd /Attach ou VSPerfCmd /Detach doivent également spécifier Crosssession.If the Start option was specified with the Crosssession option, any calls to VSPerfCmd /Attach or to VSPerfCmd /Detach must also specify Crosssession.

SyntaxeSyntax

VSPerfCmd.exe /Attach:ProcessID [Options]  

ParamètresParameters

ProcessID
ID de processus (PID) du processus en cours d’exécution.The process ID (PID) of the running process. Le PID d’un processus en cours d’exécution est répertorié sous l’onglet Processus du Gestionnaire des tâches de Windows.The PID of a running process is listed on the Processes tab of Windows Task Manager.

Options validesValid Options

Les options suivantes de VSPerfCmd peuvent être combinées avec l’option Attach sur une même ligne de commande.The following VSPerfCmd options can be combined with the Attach option on a single command line.

CrosssessionCrosssession
Active le profilage d’applications dans des sessions autres que la session d’ouverture de session.Enables profiling applications in sessions other than the logon session. Obligatoire si l’option Start a été spécifiée avec l’option Crosssession.Required if the Start option was specified with the Crosssession option.

Start: MethodStart: Method
Initialise la session de profileur en ligne de commande et définit la méthode de profilage spécifiée.Initializes the command-line profiler session and sets the specified profiling method.

TargetCLRTargetCLR
Spécifie la version du CLR de .NET Framework à profiler quand plusieurs versions sont chargées dans une session de profilage.Specifies the version of the .NET Framework Common Language Runtime (CLR) to profile when more than one version is loaded in a profiling session. Par défaut, la première version chargée est profilée.By default, the first loaded version is profiled.

GlobalOn GlobalOffGlobalOn GlobalOff
Reprend (GlobalOn) ou interrompt (GlobalOff) le profilage, mais ne met pas fin à la session de profilage.Resumes (GlobalOn) or pauses (GlobalOff) profiling, but does not end the profiling session.

ProcessOn: PID ProcessOff: PIDProcessOn: PID ProcessOff: PID
Reprend (ProcessOn) ou interrompt (ProcessOff) le profilage pour le processus spécifié.Resumes (ProcessOn) or pauses (ProcessOff) profiling for the specified process.

Options pour l’intervalleInterval Options

Une des options d’intervalle d’échantillonnage suivantes peut être spécifiée sur la ligne de commande d’Attach.One of the following sampling interval options can be specified on the Attach command line. L’intervalle d’échantillonnage par défaut est de 10 000 000 de cycles d’horloge du processeur.The default sampling interval is 10,000,000 processor clock cycles.

Timer[:Cycles]PF[:Events]Sys[: Events]Counter[:Name,Reload,FriendlyName]Timer[:Cycles]PF[:Events]Sys[: Events]Counter[:Name,Reload,FriendlyName]
Spécifie le nombre et le type de l’intervalle d’échantillonnage.Specifies the number and type of the sampling interval.

  • Timer : échantillonne tous les Cycles cycles d’horloge du processeur.Timer - Samples every Cycles processor clock cycles. Si Cycles n’est pas spécifié, la valeur utilisée est de 10 000 000 cycles.If Cycles is not specified, 10,000,000 cycles are used.

  • PF : échantillonne tous les Events défauts de page.PF - Samples every Events page faults. Si Events n’est pas spécifié, la valeur utilisée est de 10 défauts de page.If Events is not specified, 10 page faults are used.

  • Sys : échantillonne tous les Events appels au système d’exploitation.Sys - Samples every Events calls to the operating system. Si Events n’est pas spécifié, la valeur utilisée est de 10 appels système.If Events is not specified, 10 system calls are used.

  • Counter : échantillonne tous les nombres de Reload du compteur de performance de l’UC spécifié par Name.Counter - Samples every Reload number of the CPU performance counter specified by Name. En option, FriendlyName peut spécifier une chaîne à utiliser comme en-tête de colonne dans les rapports du profileur.Optionally, FriendlyName can specify a string to use as the column header in profiler reports.

ExempleExample

Cet exemple montre comment s’attacher à une instance en cours d’exécution d’une application avec l’ID de processus 12345.This example demonstrates how to attach to a running instance of an application with the process ID of 12345.

VSPerfCmd.exe /Start:Sample /Output:TestApp.exe.vsp  
VSPerfCmd.exe /Attach:12345  

Voir aussiSee Also

VSPerfCmd VSPerfCmd
Profilage d’applications autonomes Profiling Stand-Alone Applications
Profilage d’applications web ASP.NET Profiling ASP.NET Web Applications
Profilage de servicesProfiling Services