Msdt
Updated: April 17, 2012
Applies To: Windows 7, Windows Server 2008 R2
Invokes a troubleshooting pack at the command line or as part of an automated script, and enables additional options without user input.
Syntax
msdt </id <name> | /path <name> | /cab < name>> <</parameter> [options] … <parameter> [options]>>
Parameters
The parameters and options supported by msdt.exe are:
| Parameter | Description |
|---|---|
/id <package name> |
Specifies which diagnostic package to run. For a list of available packages, see the Troubleshooting Pack ID in the “Available troubleshooting packs” section. |
/path <directory | .diagpkg file | .diagcfg file> |
Specifies the full path to a diagnostic package. If you specify a directory, the directory must contain a diagnostic package. You cannot use the /path parameter in conjunction with the /id, /dci, or /cab parameter. |
/dci <passkey> |
Pre-populates the passkey field in msdt. This parameter is only used when a support provider has supplied a passkey. |
/dt <directory> |
Displays the troubleshooting history in the specified directory. Diagnostic results are stored in the user’s %LOCALAPPDATA%\Diagnostics or %LOCALAPPDATA%\ElevatedDiagnostics directories. |
/af <answer file> |
Specifies an answer file in XML format that contains responses to one or more diagnostic interactions. |
/modal <ownerHWND> |
Makes the troubleshooting pack modal to a window designated by the parent Console Window Handle (HWND), in decimal. This parameter is typically used by applications that launch a troubleshooting pack. For more information about obtaining Console Window Handles, see How to Obtain a Console Window Handle (HWND) at https://go.microsoft.com/fwlink/?LinkId=160258. |
/moreoptions <true | false> |
Enables (true) or suppresses (false) the final troubleshooting screen that asks if the user wants to explore additional options. This parameter is typically used when the troubleshooting pack is launched by a troubleshooter that is not part of the operating system. |
/param <parameters> |
Specifies a set of interaction responses at the command line, similar to an answer file. This parameter is not typically used within the context of troubleshooting packs created with TSP Designer. For more information about developing custom parameters, see Windows Troubleshooting Platform at https://go.microsoft.com/fwlink/?LinkId=144215. |
/advanced |
Expands the advanced link on the Welcome page by default when the troubleshooting pack is started. |
/custom |
Prompts the user to confirm each possible resolution before it is applied. |
Return codes
Troubleshooting packs comprise a set of root causes, each of which describes a specific technical problem. After completing the troubleshooting pack tasks, each root cause returns a state of fixed, not fixed, detected (but not fixable), or not found. In addition to specific results reported in the troubleshooter user interface, the troubleshooting engine returns a code in the results describing, in general terms, whether or not the troubleshooter fixed the original problem. The return codes are as follows:
| Return Code | Explanation |
|---|---|
-1 |
Interruption: The troubleshooter was closed before the troubleshooting tasks were completed. |
0 |
Fixed: The troubleshooter identified and fixed at least one root cause, and no root causes remain in a not fixed state. |
1 |
Present, but not fixed: The troubleshooter identified one or more root causes that remain in a not fixed state. This code is returned even if another root cause was fixed. |
2 |
Not found: The troubleshooter did not identify any root causes. |
Available troubleshooting packs
Troubleshooting packs that are used by the Troubleshooting Engine to perform diagnostic tasks are included with all versions of Windows® 7 and Windows Server® 2008 R2 except the Server Core SKU. In addition, some optional operating system features and Microsoft applications include troubleshooting packs. The following table lists troubleshooting packs included with the operating system and with certain features and applications. The Application or Feature Dependency column describes any requirements for the troubleshooting pack to be available; in all cases, Windows 7 or Windows Server 2008 R2 must be installed.
| Troubleshooting Pack ID | Description | Application or Feature Dependency |
|---|---|---|
AeroDiagnostic |
Troubleshoots problems displaying Aero effects like transparency. |
Aero Display Theme installed |
NetworkDiagnosticsDA |
Troubleshoots problems connecting to a workplace network over the Internet using Direct Access. |
Direct Access installed |
DeviceDiagnostic |
Troubleshoots problems using hardware and access devices connected to the computer. |
|
HomeGroupDiagnostic |
Troubleshoots problems viewing computers or shared files in a homegroup. |
HomeGroup installed |
NetworkDiagnosticsInbound |
Troubleshoots problems with allowing other computers to communicate with the target computer through Windows Firewall. |
|
NetworkDiagnosticsWeb |
Troubleshoots problems connecting to the Internet or to a specific Web site. |
|
IEDiagnostic |
Helps the user prevent add-on problems and optimize temporary files and connections. |
Internet Explorer installed |
IESecurityDiagnostic |
Helps the user prevent malware, pop-ups, and online attacks. |
Internet Explorer installed |
NetworkDiagnosticsNetworkAdapter |
Troubleshoots problems with Ethernet, wireless, or other network adapters. |
|
PerformanceDiagnostic |
Helps the user adjust settings to improve operating system speed and performance. |
|
AudioPlaybackDiagnostic |
Troubleshoots problems playing sounds and other audio files. |
Audio output device installed |
PowerDiagnostic |
Helps the user adjust power settings to improve battery life and reduce power consumption. |
|
PrinterDiagnostic |
Troubleshoots problems printing. |
|
PCWDiagnostic |
Helps the user configure older programs so that they can run in the current version of Windows. |
|
AudioRecordingDiagnostic |
Troubleshoots problems recording audio from a microphone or other input source. |
Audio input device installed |
SearchDiagnostic |
Troubleshoots problems with search and indexing using Windows Search. |
Search enabled |
NetworkDiagnosticsFileShare |
Troubleshoots problems accessing shared files and folders on other computers over the network. |
|
MaintenanceDiagnostic |
Helps the user clean up unused files and shortcuts and perform other maintenance tasks. |
|
WindowsMediaPlayerDVDDiagnostic |
Troubleshoots problems playing a DVD using Windows Media Player. |
Windows Media Player installed |
WindowsMediaPlayerLibraryDiagnostic |
Troubleshoots problems with adding media files to the Windows Media Player library. |
Windows Media Player installed |
WindowsMediaPlayerConfigurationDiagnostic |
Helps the user reset Windows Media Player settings to the default configuration. |
Windows Media Player installed |
WindowsUpdateDiagnostic |
Troubleshoots problems that prevent Windows Update from performing update tasks. |
Additional references
For more information about obtaining Console Window Handles, see How to Obtain a Console Window Handle (HWND) at https://go.microsoft.com/fwlink/?LinkId=160258.
For more information about developing custom parameters for use with troubleshooting packs, see Windows Troubleshooting Platform at https://go.microsoft.com/fwlink/?LinkId=144215.