Windows 7 / Getting Started

Running WinSAT from the Command Line

Although in most cases, WinSAT will not need to be executed manually from a command prompt, the general format of the command line is as follows.

winsat <assessment_name> <assessment_parameters>

The WinSAT command-line options are not case sensitive. The command line does not require a dash or forward slash for the assessment name, but it does support either a leading dash (-) or a leading forward-slash (/) character to designate an assessment parameter. WinSAT can be run from a command shell with administrative privileges. An error may be reported if any options or switches are not supported.

The WinSAT tool also supports several command-line switches in addition to the assessment parameters. These are parsed by WinSAT before it passes control to one or more of the assessments. Some of these parameters are also supported by one or more assessments. The command-line parameters recognized by WinSAT include:

  • -csv This causes WinSAT to save the top-level measured metrics to a Comma- Separated Value (CSV) file.
  • -help or ? Displays the help content.
  • -idiskinfo Information on the disk subsystem (logical volumes and physical disks) is not normally saved as part of the <SystemConfig> section in the XML output.
  • -iguid Generates a GUID in the XML output file. Note that this is not valid with the formal assessment.
  • -iter N Includes the iteration number <n> in the XML output file.
  • -v This specifies that WinSAT should produce verbose output. This output includes progress and status information, and possibly error information. The default is for no verbose output. This switch is passed to all of the specified assessments.
  • -xml file_name This specifies that the XML output from the assessment is to be saved in the specified file name. All assessments support the -xml command-line switch; a pre-existing file with the same name will be overwritten.
[Previous] [Contents] [Next]

In this tutorial:

  1. Windows 7 Desktop Maintenance
  2. Performance Monitoring
  3. Improvements to Performance Monitoring in Windows 7
  4. Using Performance Monitor
  5. Real-Time Performance Monitoring
  6. Performance Monitor Logging
  7. Creating a Data Collector Set
  8. Configuring a Data Collector Set
  9. Using Data Manager to View Performance Data
  10. Starting and Stopping Data Logging
  11. Viewing Performance Data
  12. Comparing Performance Monitor Logs
  13. Performance Monitor User Rights
  14. Remote Data Collection
  15. Using Windows PowerShell for Performance Monitoring
  16. Resource Monitor
  17. Overview Tab
  18. CPU Tab
  19. Memory Tab
  20. Disk Tab
  21. Network Tab
  22. Reliability Monitor
  23. How Reliability Monitor Works
  24. Windows Performance Tools Kit
  25. Event Monitoring
  26. Understanding the Windows Event Architecture
  27. Channels
  28. Improvements to Event Monitoring in Windows 7
  29. Using Event Viewer
  30. Understanding Views
  31. Viewing Event Logs
  32. Saving Event Logs
  33. Configuring Event Subscriptions
  34. Considerations for Workgroup Environments
  35. Creating a New Subscription
  36. Using the Windows Events Command-Line Utility for Event Monitoring
  37. Using Windows PowerShell for Event Monitoring
  38. Using Task Scheduler
  39. Improvements to Task Scheduler in Windows 7
  40. Understanding Tasks
  41. Understanding the Task Scheduler Architecture
  42. Understanding Task Scheduler Security
  43. Credentials Management
  44. Securing Running Tasks
  45. Understanding AT and Task Scheduler v1.0 Compatibility Modes
  46. Understanding the Task Scheduler Snap-in
  47. Understanding Default Tasks
  48. Creating Tasks
  49. Defining Triggers
  50. At Startup Trigger
  51. On Connection To AND Disconnect From User Session Triggers
  52. On Workstation Lock AND Unlock Triggers
  53. Defining Actions
  54. Defining Conditions
  55. Defining Settings
  56. Managing Tasks
  57. Viewing History
  58. Using SchTasks.exe for Creating and Managing Tasks
  59. Task Scheduler Events
  60. Troubleshooting Task Scheduler
  61. Tasks Won't Run If the Service Is Not Started
  62. The Task Will Run Only When a Certain User Is Logged On
  63. The Task Action Failed to Execute
  64. Interpreting Result and Return Codes
  65. Understanding the Windows System Assessment Tool
  66. Understanding WinSAT Assessment Tests
  67. Examining the WinSAT Features Assessment
  68. Running WinSAT from the Command Line
  69. Understanding WinSAT Command Exit Values
  70. Running WinSAT Using Performance Information and Tools
  71. System Capabilities Section
  72. OEM Upsell And Help Section
  73. Understanding Windows Error Reporting
  74. Overview of Windows Error Reporting
  75. How WER Works
  76. Store Management System
  77. ReportArchive Folder
  78. WER Service
  79. Understanding the Error Reporting Cycle
  80. Understanding WER Data
  81. Configuring WER Using Group Policy
  82. Configuring WER Using the Action Center