Attach
VSPerfCmd.exe 的 Attach 选项开始对进程 ID (PID) 指定的运行过程进行样本分析。
若要使用 Attach 选项,必须在 Start 选项中指定 Sample 方法。
备注
如果同时指定了 Start 选项和 Crosssession 选项,则对 VSPerfCmd /Attach 或 VSPerfCmd /Detach 的任何调用也必须指定 Crosssession。
VSPerfCmd.exe /Attach:ProcessID [Options]
参数
- ProcessID
要运行的进程的进程 ID (PID)。 正在运行的进程的 PID 列在 Windows 任务管理器的“进程”选项卡上。
有效选项
在单个命令行上,可以将以下 VSPerfCmd 选项与 Attach 选项组合使用。
Crosssession
允许分析登录会话之外的会话中的应用程序。 如果同时指定 Start 选项和 Crosssession 选项,则为必需。**Start:**Method
初始化命令行探查器会话并设置指定的分析方法。TargetCLR
指定在分析会话中加载了多个版本的 .NET Framework 公共语言运行时 (CLR) 时,要分析的 .NET Framework CLR 的版本。 默认情况下分析加载的第一个版本。GlobalOnGlobalOff
恢复 (GlobalOn) 或暂停 (GlobalOff) 分析,但不结束分析会话。**ProcessOn:PIDProcessOff:**PID
恢复 (ProcessOn) 或暂停 (ProcessOff) 指定进程的分析。
间隔选项
在 Attach 命令行中可以指定以下采样间隔选项之一。 默认的采样间隔是 10,000,000 个处理器时钟周期。
Timer[**:Cycles]PF[:Events]Sys[:Events]Counter[:**Name,Reload,FriendlyName]
指定采样间隔的数量和类型。Timer - 每 Cycles 个处理器时钟周期采样一次。 如果未指定 Cycles,则使用 10,000,000 个周期。
PF - 每 Events 个页面错误进行一次采样。 如果未指定 Events,则使用 10 个页面错误。
Sys - 每 Events 次操作系统调用进行一次采样。 如果未指定 Events,则使用 10 次系统调用。
Counter - 每 Reload 个 Name 所指定的 CPU 性能计数器进行一次采样。 可以选择使用 FriendlyName 来指定在探查器报告中用作列标题的字符串。
示例
此示例演示如何附加到进程 ID 为 12345 的正在运行的应用程序实例。
VSPerfCmd.exe /Start:Sample /Output:TestApp.exe.vsp
VSPerfCmd.exe /Attach:12345