Of the 4 Process methods, browser sessions serve 0, phone sessions 0 and computer sessions 4. A method marked not served answers StrategyUnavailable on that kind of session; check the handshake’s capabilities before relying on one.

Process.run

Browser: not served Phone: not served Computer: served Run a command to completion as the session’s user, in the desktop session, with no window, and return its exit code and output. The process is killed when timeoutMs runs out. Computer sessions only.
{"id": 1, "method": "Process.run", "params": {"command": "Get-Date"}}
ParamTypeRequiredDescription
commandstringYes
argsstring[]No
shellstringNopowershell runs command as a PowerShell script, cmd as a cmd.exe line, none runs command as a program with args. One of powershell, cmd, none.
cwdstringNoDefaults to the user’s home folder.
envobjectNo
stdinstringNo
timeoutMsintegerNoDefault 30000. From 0 to 600000.
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
exitCodeinteger-1 when the run timed out.
stdoutstring
stderrstring
stdoutTruncatedboolean
stderrTruncatedboolean
timedOutboolean
durationMsinteger

Process.start

Browser: not served Phone: not served Computer: served Start a program and return at once; a GUI program opens its window on the desktop. Computer sessions only.
{"id": 1, "method": "Process.start", "params": {"command": "Get-Date"}}
ParamTypeRequiredDescription
commandstringYes
argsstring[]No
shellstringNopowershell runs command as a PowerShell script, cmd as a cmd.exe line, none runs command as a program with args. One of powershell, cmd, none.
cwdstringNo
envobjectNo
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
pidinteger

Process.list

Browser: not served Phone: not served Computer: served The running processes. Computer sessions only.
{"id": 1, "method": "Process.list", "params": {}}
ParamTypeRequiredDescription
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result
FieldTypeDescription
processesProcessInfo[]

Process.kill

Browser: not served Phone: not served Computer: served End a process. Windows’ own processes and the session’s agent and streamer can’t be killed (InvalidArgs). Computer sessions only.
{"id": 1, "method": "Process.kill", "params": {"pid": 4321}}
ParamTypeRequiredDescription
pidintegerYes
idempotencyKeystringNoMakes a re-send after a reconnect safe: a repeated key returns the recorded response without acting again. See Idempotency keys.
Result: an empty object {}.