VSPerf

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at VSPerf.

Use the VsPerf command line tool to:

  1. Profile Windows Store apps from the command line when Visual Studio is not installed on the device.

  2. Profile Windows 8 desktop applications and Windows Server 2012 applications using the sampling profiling method.

For more information about your profiling options, see Performance Tools on Windows 8 and Windows Server 2012 applications.

This topic describes the options that you can use with the vsperf.exe command line tool. The topic contains the following sections:

Windows Store apps only

Windows 8 desktop applications and Windows Server 2012 applications only

All applications

These options apply only to Windows Store apps.

/app:{AppName}Starts the profiler and waits for the specified app to be launched from the Start menu.

Run vsperf /listapps to view the app Name and PackageFullName of installed apps.
/package:{PackageFullName}Starts the profiler and waits for the specified app to be launched from the Start menu.

Run vsperf /listapps to view the app Name and PackageFullName of installed apps.
/jsRequired for profiling JavaScript apps.

Collect performance data from JavaScript apps.

Use only with /package or /attach.
/noclrOptional. Do not collect CLR data.

Use only with /package or /attach.

Optimization, no managed symbols will resolve.
/listappsList installed app Names and PackageFullNames.

These options do not work on Windows Store apps.

/launch:{Executable}Starts and begins profiling the specified executable file.
/args:{ExecutableArguments}Specifies command line arguments to pass the the /launch target.
/consoleRuns the /launch target in a new command window.

These option apply to any Windows 8 or Windows Server 2012 application.

/attach:{PID|ProcessName}[,PID|ProcessName]...Collects data from the specified processes.

Use Task Manager to view the process id (PID) and process names of running apps.
/file:{ReportName}Optional. Specifies output file (overwrites existing file).

Use only with /package or /attach.
/pausePause data collection.
/resumeResume data collection.
/stopStop data collection and terminate target processes.
/detachStop data collection, but let target processes continue to run.
/statusShow profiler status.

Performance Tools on Windows 8 and Windows Server 2012 applications
Profiling from the Command-Line

Show: