v1

latestOpenAPI 3.1.02026-07-22136108233.0 KB

computer

Execute PowerShell command

Execute PowerShell command on the machine.

post/v1/computer/{machine_id}/shell/powershell/exec

Path parameters

machine_idstring required

Headers

Idempotency-Keystring

Example:550e8400-e29b-41d4-a716-446655440000

Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.

Request body

commandstring required

PowerShell command to execute

same_sessionboolean

Use persistent session

working_directorystring nullable

Working directory for new session

session_idstring nullable

Session ID to use

timeoutnumber nullable

Maximum time in seconds to wait for command completion before returning. Cyberdriver 1.0.2+ continues one-shot commands in the background after timeout (default: 30.0)

Response

Successful Response

object required