Export (0) Print
Expand All

Using DTM from a Command Line

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:

QueryLogicalUser

AddLogicalUser

DeleteLogicalUser

CleanLogicalUser

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

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

QuerySysparseReg

AddSysparseReg

DeleteSysparseReg

SignalGatherer

To manipulate policies, use the following WttCmd parameters:

GetPolicy

GetPolicies

SetPolicy

ResetPolicy

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:

Ping

HelpMsg

SetAutoLogon

Report

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

Community Additions

ADD
Show:
© 2014 Microsoft