Runs a command line at OS level and passes it a command line with options/arguments/switches (if any).
Returns an XML fragment by way of a report. See the "Return value" section at the end of this help topic.
The required cmd is an absolute or relative file path leading to the executable that you want to pass the command line to. If a relative path (including a simple filename, as in the Example) is used, then whether or not the executable can be found depends on path environment variables. You can set environment variables from Blend by calling pc:SetEnvVarDefault or pc:SetEnvVarOverwrite.
The required args is the command line you want to pass to the executable.
The optional waittime specifies in milliseconds how long you want to wait for the command to respond. If the command does not complete within time, you get a return value (see the "Return value" section at the end of this help topic) without output. If you omit this attribute, the default waittime of 1000 milliseconds applies.
This example lists folders and files contained by the working directory. This is a USoft Blend script processed by ublendit.exe from the command line.
This example does the same as Example 1. This is a USoft Blend script processed from a USoft context.
The return value is an XML fragment that has this syntax:
Waittime (in milliseconds) is the waittime passed as an argument of <pc:WinCommand>, or else the default waittime of 1000 milliseconds. The Busy attribute only appears if the command did not complete within the waittime. Busy="true" means that the process was running at the end of the waittime.