Attach

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

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

备注

如果同时指定了 Start 选项和 Crosssession 选项,则对 VSPerfCmd /AttachVSPerfCmd /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

请参见

参考

VSPerfCmd

概念

从命令行分析独立应用程序

从命令行分析 ASP.NET Web 应用程序

服务的命令行分析