Using DTM from a Command Line

Article
09/14/2012

Note This content applies to the Windows Logo Kit (WLK). For the latest information using the new Windows Hardware Certification Kit (HCK), see Windows HCK User's Guide on the Windows Hardware Dev Center.

Note Non-logo use is unsupported.

WttCmd is a command-line tool that performs DTM-related tasks. WttCmd enables users to perform actions equivalent to certain operations they can do from within the DTM Studio user interface. Generally, these operations are aimed at a single test that executes on a single client computer.

You can use WttCmd to:

Create Local Logical User (LLU) contexts for jobs to execute within
Create persistent custom dimensions under the Sysparse registry key
Get and set policies
Create temporary variables to assist with testing
Diagnose communication issues between a DTM client and its controller
Translate error and return codes into messages
Control auto-logon settings
Cancel a job
Reboot a client
Update task progress with comments

Note

The operations discussed in this appendix apply only to DTM clients because WttCmd is not installed on DTM controllers.

WttCmd is not intended for general purpose use.

WttCmd syntax

wttcmd.exe /parameter /parameter_argument
wttcmd.exe /parameter [/optional_argument]
wttcmd.exe [/optional_parameter] /?
wttcmd.exe [/optional_parameter] /help

To manipulate a LLU, use the following WttCmd parameters:

To manipulate Sysparse registry keys and values, use the following WttCmd parameters:

Note The following parameters work only when run from a system context.

To manipulate policies, use the following WttCmd parameters:

To manipulate variables and their values, use the following WttCmd parameters:

Note The following parameters work only when run from a task within a DTM job.

SysInitKey

SysEvalKey

SysExpandStr

Additional WttCmd parameters:

Note The following parameters work only when run from a task within a DTM job.

CancelJob

EaReboot

TaskUpd

WttCmd supports additional parameters. If a parameter is not described in this documentation then DTM does not support it.

Code example to execute WttCmd

Several tasks can execute a WttCmd process from inside their executable code. For example, a task written in C/C++ to delete an LLU on the client computer might implement code similar to the following:

if( TRUE )
{
    exec( "WTTCmd.EXE /deletelogicaluser /localName:Local" );
}

Build date: 9/14/2012

Using DTM from a Command Line

Additional resources