WPR.exe

Windows Performance Recorder

Record system events for analysis with Windows Performance Analyzer (WPA)
WPR is part of the Windows Assessment and Deployment Kit (Windows ADK) for Windows 10

Syntax
      WPR options...

Key
   -cancel        - Cancel recording initiated via WPR (if any).
   -help          - Provide command line help information.
   -log {enabled|disabled|remove} - Configure debug logging to the event log.

   -marker scenario_name     - Fire an event marker.
   -markerflush scenario_name  - Fire an event marker and flush the working set.

   -profiles      - Enumerate the profile names and descriptions from a profile file.
   -purgecache    - Purges the dynamic symbols cache.
   -profiledetails profile1+profile2..+profilen [-filemode] -onoffscenario OnOff Transition Type
                    Display the detailed information about a set of profiles.
                    The naming convention of the profiles is exactly the same as used
                    in wpr -start, a profile is specified as  profile_name[.{light|verbose}].

   -providers     - Display detailed information about providers.

   -status        - Display status on active recording (if any).
   -start options - Start one or more profiles.
   -stop [recording_filename] [problem_description]
                  - Stop recording initiated via WPR (if any) and save.

   -enablePeriodicSnapshot   Enable Periodic Snapshot for the specified interval and process_id.
   -disablePeriodicSnapshot  Disable Periodic Snapshot for all process.
   -singlesnapshot  Get an on-demand Snapshot for the specified process.

   -disablepagingexecutive {on|off} - Change the Disable Paging Executive settings.
   -heaptracingconfig process_name [Package_full_name Package_relative_app_ID] [{enable|disable}]
                  - Change heap tracing settings for a process.
                    If the {enable|disable} parameter is omitted the current heap tracing
                    configuration for the process or app will be displayed.

   -capturestateondemand   - Capture states for the configured providers in the current recording.
   -pmcsources    - Query the list of hardware counters available on the system.
   -setprofint    - Set the sampled profile interval to n  [1221...10000000].
                    [Default: n = 10000 (1msec)]

   -profint       - Query the current profile interval.
   -resetprofint  - Restore the default profile interval values.

 start options:
   -start [filename.wprp!] profile [-start profile...]
      [-filemode] [-recordtempto temp_folder_path] [-onoffscenario OnOff_Transition_Type]
         [-onoffresultspath  path_to_which_the_trace_files_are_saved]
            [-onoffproblemdescription description_of_the_scenario]
               [-onoffpretracecommand command_to_run_synchronously_each_iteration_before_tracing_starts]
                  [-onoffposttracecommand command_to_run_asynchronously_after_all_the_iterations_complete_or_fail]
                     [-numiterations number_of_iterations_for_OnOff_tracing]

      -start [filename.wprp!] profile is either a built-in profile (if no filename is specified) or a path to
                      (and name of) a user-defined custom profile.
                       The user can specify up to 64 profiles on the command line.  Each profile is specified as:
           profile := [filename.wprp!]profile_name[.{light|verbose}]
                       Each profile can define both light and verbose variants or just one of the two.
                       If neither option is specified, the verbose variant is used unless the profile has only a light variant.

      -filemode        Specifies that recording is done in file mode, the default is memory mode.
      -onoffscenario   Specifies one of the on/off transition types: Boot, FastStartup, Shutdown, RebootCycle, Standby, or Hibernate.
      -numiterations   Set the number of iterations for OnOff recording.

      By default the settings from the built-in or custom profile file are used.

WPR must be run elevated.

Examples

List the available/built in profiles:

C:\> wpr.exe -profiles

Record some registry events to c:\logs\registry

C:\demo> md logs & cd logs
C:\demo\logs\> wpr.exe -start registry
C:\demo\logs\> wpr.exe -stop registry

“The essential matter of history is not what happened but what people thought or said about it” ~ Frederic William Maitland

Related commands

PSR - Windows Problem Steps Recorder.
Microsoft.com - WPR Command-Line Options