如何：使用命令行通过探查器启动独立 .NET Framework 应用程序以收集内存数据
本主题介绍如何使用 Visual Studio 分析工具命令行工具启动 .NET Framework 独立（客户端）应用程序以及收集内存数据。
分析会话有三个部分：
使用探查器启动应用程序。
收集分析数据。
结束分析会话。
提示
分析工具的命令行工具位于 Visual Studio 安装目录的 \Team Tools\Performance Tools 子目录中。 在 64 位计算机上，64 位和 32 位版本的工具都可用。 若要使用探查器命令行工具，必须将该工具路径添加到命令提示符窗口的 PATH 环境变量或添加到命令本身。 有关更多信息，请参见指定分析工具命令行工具的路径。
将应用程序与探查器一起启动
若要使用探查器来启动目标应用程序，请使用 VSPerfCmd.exe /start 和 /launch 选项初始化探查器并启动应用程序。 可以在一个命令行上指定 /start 和 /launch 及其各自的选项。
还可以添加 /globaloff 选项，以在目标应用程序启动时暂停数据收集。 然后，可以使用 /globalon 开始收集数据。
使用探查器启动应用程序
打开命令提示符窗口。
启动探查器。 键入：
**VSPerfCmd /start:sample /output:**OutputFile [Options]
可以将下列任意选项与 /start:sample 选项一起使用。
选项
说明
/wincounter:WinCounterPath
指定要在分析过程中收集的 Windows 性能计数器。
/automark:Interval
仅与 /wincounter 一起使用。 指定 Windows 性能计数器收集事件之间间隔的毫秒数。 默认值为 500 毫秒。
启动目标应用程序。 键入：
VSPerfCmd /launch**:**appName /gc:{allocation|lifetime}[Options]
需要 /gc**:**Keyword 选项才能收集 .NET Framework 内存数据。 关键字参数指定是收集内存分配数据，还是同时收集内存分配数据和对象生存期数据。
关键字
说明
allocation
仅收集内存分配数据。
lifetime
同时收集内存分配数据和对象生存期数据。
可以将以下任意选项与 /launch 选项一起使用。
选项
说明
/args:Arguments
指定一个字符串，该字符串包含要传递给目标应用程序的命令行参数。
在单独的窗口中启动目标命令行应用程序。
/events:Config
指定要在分析过程中收集的 Windows 事件跟踪 (ETW) 事件。 将在单独的 (.etl) 文件中收集 ETW 事件。
/targetclr:Version
指定在应用程序中加载了多个版本的公共语言运行时 (CLR) 时要分析的运行时的版本。
控制数据收集
在目标应用程序运行期间，通过使用 VSPerfCmd.exe 选项开始和停止向文件写入数据，可以控制数据收集。 通过控制数据收集，可以收集程序执行的特定阶段（如启动或关闭应用程序阶段）的数据。
开始和停止数据收集
以下选项对可开始和停止数据收集。 在单独的命令行上指定每个选项。 您可以多次打开和关闭数据收集。
选项
说明
开始 (/globalon) 或停止 (/globaloff) 所有进程的数据收集。
/processon:PID processoff:PID
开始 (/processon) 或停止由进程 ID (PID) 指定的进程的 (/processoff) 数据收集。
/attach 开始收集由 PID（进程 ID）指定的进程的数据。 /detach 停止对所有进程的数据收集。
还可以使用 VSPerfCmd.exe /mark 选项在数据文件中插入分析标记。 /mark 命令添加一个标识符、一个时间戳和一个可选的用户定义的文本字符串。 可以使用标记筛选数据。
结束分析会话
若要结束分析会话，必须将探查器与所有被分析进程分离，并且必须显式关闭探查器。 通过关闭应用程序或调用 VSPerfCmd /detach 选项，可以从使用采样方法分析的应用程序分离探查器。 然后，可以调用 VSPerfCmd /shutdown 选项，关闭探查器和分析数据文件。 VSPerfClrEnv /off 命令清除分析环境变量。
结束分析会话
执行以下步骤之一从目标应用程序分离探查器：
关闭目标应用程序。
- 或 -
键入 VSPerfCmd /detach
关闭探查器。 键入：
VSPerfCmd /shutdown