Execute Process
Executes a specified process with given arguments and options. This PowerBrick allows you to run any executable or command-line tool on the target machine, providing flexibility for various use cases such as software installation, system configuration, or running custom scripts.
Parameters
Section titled “Parameters”Process Path
Section titled “Process Path”Required
Specifies the full path to the executable or command to run. This should be the complete path to the executable file or a command that is available in the system PATH.\nSample: C:\Windows\System32\dism.exe
Process Arguments
Section titled “Process Arguments”Optional
Specifies the command-line arguments to pass to the process.\nSample: /Online /Add-Driver /Driver:C:\Drivers\wifidriver\driver.inf
Working directory path
Section titled “Working directory path”Optional
Specifies the working directory for the process. If not specified, the process will use its default working directory. Sample: C:\temp
Wait for process
Section titled “Wait for process”Required — Default: True
Enable to wait for the process to finish before continuing. Disable to continue immediately after process start.
Window Style
Section titled “Window Style”Optional — Default: Hidden
The Window style of the process. (Hidden, Normal, Minimized, Maximized) Allowed values: Hidden, Normal, Minimized, Maximized.
Check if process exist
Section titled “Check if process exist”Required — Default: False
Enable to validate that the process path exists on the endpoint before execution. Disable to skip this validation.
User Context
Section titled “User Context”Optional — Default: SYSTEM
Specifies the user context in which to run the process. SYSTEM (default), LoggedOnUser (runs as currently logged-on user, retries later if no user is logged on), or TempAdministratorUser (runs as temporary admin account with automatic cleanup). Allowed values: Logged On User, Temp Administrator User, SYSTEM.
Return Code Handles
Section titled “Return Code Handles”Required
Specify how each return code from the process is handled. Success continues the job, Failure stops the job as failed with that return code, and Retry Execution Later stops the job and runs it again later. Any return code not in the list stops the job as failed. Allowed values: Success, Failure, Retry Execution Later.
Details
Section titled “Details”- Category: Installer
- Brick ID:
Execute-Process
{ "category": "installer", "description": "Executes a specified process with given arguments and options. This PowerBrick allows you to run any executable or command-line tool on the target machine, providing flexibility for various use cases such as software installation, system configuration, or running custom scripts.", "developerVendor": "CapaSystems A/S", "displayName": null, "id": "Execute-Process", "name": "Execute Process", "parameters": [ { "allowManualInput": false, "defaultValue": "", "defaultValueObject": null, "description": "Specifies the full path to the executable or command to run. This should be the complete path to the executable file or a command that is available in the system PATH.\\nSample: C:\\Windows\\System32\\dism.exe", "id": "ProcessPath", "name": "Process Path", "regExValidation": "", "required": true, "type": "TextBox", "value": null, "values": [], "valuesObject": null }, { "allowManualInput": false, "defaultValue": "", "defaultValueObject": null, "description": "Specifies the command-line arguments to pass to the process.\\nSample: /Online /Add-Driver /Driver:C:\\Drivers\\wifidriver\\driver.inf", "id": "ProcessArguments", "name": "Process Arguments", "regExValidation": "", "required": false, "type": "TextBox", "value": null, "values": [], "valuesObject": null }, { "allowManualInput": false, "defaultValue": "", "defaultValueObject": null, "description": "Specifies the working directory for the process. If not specified, the process will use its default working directory. Sample: C:\\temp", "id": "WorkingDirectory", "name": "Working directory path", "regExValidation": "", "required": false, "type": "TextBox", "value": null, "values": [], "valuesObject": null }, { "allowManualInput": false, "defaultValue": "True", "defaultValueObject": null, "description": "Enable to wait for the process to finish before continuing. Disable to continue immediately after process start.", "id": "ProcessWait", "name": "Wait for process", "regExValidation": "", "required": true, "type": "Boolean", "value": null, "values": [], "valuesObject": null }, { "allowManualInput": false, "defaultValue": null, "defaultValueObject": { "id": "0", "name": "Hidden" }, "description": "The Window style of the process. (Hidden, Normal, Minimized, Maximized)", "id": "WindowStyle", "name": "Window Style", "regExValidation": "", "required": false, "type": "ComboBox", "value": null, "values": [], "valuesObject": [ { "id": "0", "name": "Hidden" }, { "id": "1", "name": "Normal" }, { "id": "2", "name": "Minimized" }, { "id": "3", "name": "Maximized" } ] }, { "allowManualInput": false, "defaultValue": "False", "defaultValueObject": null, "description": "Enable to validate that the process path exists on the endpoint before execution. Disable to skip this validation.", "id": "CheckProcessExist", "name": "Check if process exist", "regExValidation": "", "required": true, "type": "Boolean", "value": null, "values": [], "valuesObject": null }, { "allowManualInput": false, "defaultValue": null, "defaultValueObject": { "id": "SYSTEM", "name": "SYSTEM" }, "description": "Specifies the user context in which to run the process. SYSTEM (default), LoggedOnUser (runs as currently logged-on user, retries later if no user is logged on), or TempAdministratorUser (runs as temporary admin account with automatic cleanup).", "id": "UserContext", "name": "User Context", "regExValidation": "", "required": false, "type": "ComboBox", "value": null, "values": [], "valuesObject": [ { "id": "LoggedOnUser", "name": "Logged On User" }, { "id": "TempAdministratorUser", "name": "Temp Administrator User" }, { "id": "SYSTEM", "name": "SYSTEM" } ] }, { "allowManualInput": false, "defaultValue": [ { "code": 0, "option": { "name": "Success", "id": "success" } }, { "code": 3010, "option": { "name": "Success", "id": "success" } } ], "defaultValueObject": null, "description": "Specify how each return code from the process is handled. Success continues the job, Failure stops the job as failed with that return code, and Retry Execution Later stops the job and runs it again later. Any return code not in the list stops the job as failed.", "id": "Codehandle", "name": "Return Code Handles", "regExValidation": "", "required": true, "type": "CodeHandles", "value": null, "values": [], "valuesObject": [ { "id": "success", "name": "Success" }, { "id": "failure", "name": "Failure" }, { "id": "retrylater", "name": "Retry Execution Later" } ] } ], "powershell": { "base64Encoded": true, "function": "ZnVuY3Rpb2..." }, "type": "powerbrick", "version": "2026.10.8.2"}