Run command-line app console with Surface Diagnostic Toolkit for Business
Running the Surface Diagnostic Toolkit (SDT) at a command prompt requires downloading the SDT app console. After it's installed, you can run SDT at a command prompt via the Windows command console (cmd.exe) or using Windows PowerShell, including PowerShell Integrated Scripting Environment (ISE), which provides support for autocompletion of commands, copy/paste, and other features. For a list of supported Surface devices in SDT, refer to Deploy Surface Diagnostic Toolkit for Business.
To run SDT using commands, you must be signed in to the Administrator account or signed in to an account that is a member of the Administrator group on your Surface device.
Running SDT app console
- Download and install SDT app console from the Surface Tools for IT download page.
- For Intel/AMD devices, download: Microsoft.Surface.Diagnostics.App.Console.v126.96.36.199.exe
- For ARM devices, download: Microsoft.Surface.Diagnostics.App.Console.v188.8.131.52_x86.exe
- Use the Windows command prompt (cmd.exe) or Windows PowerShell to:
- Collect all log files
- Run health diagnostics using Best Practice Analyzer
- Check update for missing firmware or driver updates
In this release, the SDT app console supports single commands only. Running multiple command line options requires running the console exe separately for each command.
By default, output files are saved in the same location as the console app. Refer to the following table for a complete list of commands.
|-DataCollector "output file"||Collects system details into a zip file. "output file" is the file path to create system details zip file.
|-bpa "output file"||Checks several settings and health indicators in the device. “output file" is the file path to create the HTML report.
|-windowsupdate||Checks Windows Update online servers for missing firmware and/or driver updates.
|-warranty "output file"||Checks warranty information on the device (valid or invalid). The optional “output file” is the file path to create the xml file.
Microsoft.Surface.Diagnostics.App.Console.exe –warranty “warranty.xml”
To run the SDT app console remotely on target devices, you can use a configuration management tool such as Microsoft Endpoint Configuration Manager. Alternatively, you can create a .zip file containing the console app and appropriate console commands and deploy per your organization’s software distribution processes.
Running Best Practice Analyzer
You can run BPA tests across key components such as BitLocker, Secure Boot, and Trusted Platform Module (TPM) and then output the results to a shareable file. The tool generates a series of tables with color-coded headings and condition descriptors along with guidance about how to approach resolving the issue.
- Green indicates the component is running in an optimal condition (optimal).
- Orange indicates the component is not running in an optimal condition (not optimal).
- Red indicates the component is in an abnormal state.
Sample BPA results output
|Description:||Checks if BitLocker is enabled on the system drive.|
|Guidance:||It is highly recommended to enable BitLocker to protect your data.|
|Description:||Checks if Secure Boot is enabled.|
|Guidance:||It is highly recommended to enable Secure Boot to protect your PC.|
|Trusted Platform Module|
|Description:||Ensures that the TPM is functional.|
|Guidance:||Without a functional TPM, security-based functions such as BitLocker may not work properly.|
|Description:||Checks if Connected Standby is enabled.|
|Guidance:||Connected Standby allows a Surface device to receive updates and notifications while not being used. For best experience, Connected Standby should be enabled.|
|Description:||Checks if Bluetooth is enabled.|
|Description:||Checks if the operating system is in Debug mode.|
|Guidance:||The debug boot option enables or disables kernel debugging of the Windows operating system. Enabling this option can cause system instability and can prevent DRM (digital rights managemend) protected media from playing.|
|Description:||Checks if Test Signing is enabled.|
|Guidance:||Test Signing is a Windows startup setting that should only be used to test pre-release drivers.|
|Active Power Plan|
|Description:||Checks that the correct power plan is active.|
|Guidance:||It is highly recommended to use the "Balanced" power plan to maximize productivity and battery life.|
|Description:||Checks if the device is up to date with Windows updates.|
|Value:||Microsoft Silverlight (KB4023307), Definition Update for Windows Defender Antivirus - KB2267602 (Definition 1.279.1433.0)|
|Guidance:||Updating to the latest windows makes sure you are on the latest firmware and drivers. It is recommended to always keep your device up to date|
|Free Hard Drive Space|
|Description:||Checks for low free hard drive space.|
|Guidance:||For best performance, your hard drive should have at least 10% of its capacity as free space.|
|Description:||List of non-functioning devices in Device Manager.|
|Guidance:||Non-functioning devices in Device Manager may cause unpredictable problems with Surface devices such as, but not limited to, no power savings for the respective hardware component.|
|Description:||Checks for an external monitor that may have compatibility issues.|
|Guidance:||Check with the original equipment manufacturer for compatibility with your Surface device.|
Submit and view feedback for