Attach

VSPerfCmd.exe 的 Attach 选项开始对进程 ID (PID) 指定的运行过程进行样本分析。

若要使用 Attach 选项，必须在 Start 选项中指定 Sample 方法。

提示

如果同时指定了 Start 选项和 Crosssession 选项，则对 VSPerfCmd /Attach 或 VSPerfCmd /Detach 的任何调用也必须指定 Crosssession。

VSPerfCmd.exe /Attach:ProcessID [Options]

参数

在单个命令行上，可以将以下 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