參考：vcperf 命令

本文列出並描述 中 vcperf.exe 可用的命令，以及如何使用這些命令。

啟動和停止追蹤的命令

重要

除非您指定 /noadmin ，否則下列命令需要系統管理許可權。

選項	引數和描述
/start	[/noadmin] [/nocpusampling] [/level1 | /level2 | /level3] <sessionName>
	在指定的會話名稱下啟動追蹤。 此選項 /noadmin 會執行 vcperf.exe 而沒有系統管理員許可權，而且會忽略 /nocpusampling 選項。 當您在沒有系統管理員許可權的情況下執行 vcperf 時，指定的電腦上可能會有多個使用中的會話。 選項 /nocpusampling 指定 vcperf.exe 不會收集 CPU 範例。 它可防止在 Windows 效能分析器中使用 CPU 使用量 （Sampled） 檢視，但會使收集的追蹤較小。 /level1、 /level2 或 /level3 選項會指定要收集哪些 MSVC 事件，以增加資訊層級。 層級 3 包含所有事件。 層級 2 包含範本具現化事件以外的所有事件。 層級 1 包含範本具現化、函式和檔案事件以外的所有事件。 如果未指定， /level2 預設會選取 。 一旦 vcperf.exe 啟動追蹤，就會立即傳回。 追蹤會針對電腦上執行的所有進程收集全系統的事件。 這表示您不需要在與用來執行 vcperf.exe 的專案相同的命令提示字元視窗中建置專案。 例如，您可以在 Visual Studio 中建置專案。
/stop	（1） [ /templates ] <sessionName> <outputFile.etl> （2） [ /templates ] <sessionName> /timetrace <outputFile.json>
	停止指定會話名稱所識別的追蹤。 在追蹤上執行後處理步驟，以產生 參數指定的 <outputFile> 檔案。 選項 /templates 包含檔案中的範本具現化事件。 （1） 在 Windows 效能分析器 （WPA） 中產生可檢視的檔案。 輸出檔案需要副檔名 .etl 。 （2） 在 Microsoft Edge 追蹤檢視器中產生可檢視的檔案（ edge://tracing ）。 輸出檔案需要副檔名 .json 。
/stopnoanalyze	<sessionName> <rawOutputFile.etl>
	停止指定會話名稱所識別的追蹤，並在指定的輸出檔中寫入未經處理的原始資料。 產生的檔案不適用於在 WPA 中檢視。 命令中 /stop 涉及的後續處理步驟有時可能相當冗長。 您可以使用 /stopnoanalyze 命令來延遲這個後續處理步驟。 /analyze當您準備好在 Windows 效能分析器 或 Microsoft Edge 追蹤檢視器中產生可檢視的檔案時，請使用 命令。

其他命令

選項	引數和描述
/analyze	（1） [ /templates ] <rawInputFile.etl> <outputFile.etl> （2） [ /templates ] <rawInputFile.etl> /timetrace <outputFile.json>
	接受命令所產生的 /stopnoanalyze 原始追蹤檔案。 在此追蹤上執行後處理步驟，以產生 參數所 <outputFile> 指定的檔案。 選項 /templates 包含檔案中的範本具現化事件。 （1） 在 Windows 效能分析器 （WPA） 中產生可檢視的檔案。 輸出檔案需要副檔名 .etl 。 （2） 在 Microsoft Edge 追蹤檢視器中產生可檢視的檔案（ edge://tracing ）。 輸出檔案需要副檔名 .json 。

另請參閱

開始使用 C++ Build Insights
教學課程：Windows 效能分析器基本概念
參考：Windows 效能分析器檢視
Windows Performance Analyzer