Install EXE
Installs an application using an executable file. This brick allows you to specify the path to the executable, any necessary command-line arguments, and various execution options such as waiting for completion and user context. It also includes the ability to define return code handling to determine the success or failure of the installation based on the process’s exit code.
Parameters
Section titled “Parameters”Executable Path
Section titled “Executable Path”Required — Default: $PackageRoot\Setup.exe
Remember to include the [Download Content] PowerBrick when using $PackageRoot. Ex. $PackageRoot\setup.exe
Executable Arguments
Section titled “Executable Arguments”Optional
The arguments to be used during the installation
Working Directory Path
Section titled “Working Directory Path”Optional
The full path of the working directory
Await Executable
Section titled “Await Executable”Required — Default: True
Wait for the executable to terminate before proceeding
Window Style
Section titled “Window Style”Optional — Default: Hidden
The window style to be used during the installation. Not relevant for installations in System Context Allowed values: Hidden, Normal, Minimized, Maximized.
Check Executable Existence
Section titled “Check Executable Existence”Required — Default: False
Check if the executable exists before starting the installation
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:
Install-Exe
{ "category": "installer", "description": "Installs an application using an executable file. This brick allows you to specify the path to the executable, any necessary command-line arguments, and various execution options such as waiting for completion and user context. It also includes the ability to define return code handling to determine the success or failure of the installation based on the process's exit code.", "developerVendor": "CapaSystems A/S", "displayName": null, "id": "Install-Exe", "name": "Install EXE", "parameters": [ { "allowManualInput": false, "defaultValue": "$PackageRoot\\Setup.exe", "defaultValueObject": null, "description": "Remember to include the [Download Content] PowerBrick when using $PackageRoot. Ex. $PackageRoot\\setup.exe", "id": "ProcessPath", "name": "Executable Path", "regExValidation": "", "required": true, "type": "TextBox", "value": null, "values": [], "valuesObject": null }, { "allowManualInput": false, "defaultValue": "", "defaultValueObject": null, "description": "The arguments to be used during the installation", "id": "ProcessArguments", "name": "Executable Arguments", "regExValidation": "", "required": false, "type": "TextBox", "value": null, "values": [], "valuesObject": null }, { "allowManualInput": false, "defaultValue": "", "defaultValueObject": null, "description": "The full path of the working directory", "id": "WorkingDirectory", "name": "Working Directory Path", "regExValidation": "", "required": false, "type": "TextBox", "value": null, "values": [], "valuesObject": null }, { "allowManualInput": false, "defaultValue": "True", "defaultValueObject": null, "description": "Wait for the executable to terminate before proceeding", "id": "ProcessWait", "name": "Await Executable", "regExValidation": "", "required": true, "type": "Boolean", "value": null, "values": [], "valuesObject": null }, { "allowManualInput": false, "defaultValue": null, "defaultValueObject": { "id": "0", "name": "Hidden" }, "description": "The window style to be used during the installation. Not relevant for installations in System Context", "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": "Check if the executable exists before starting the installation", "id": "CheckProcessExist", "name": "Check Executable Existence", "regExValidation": "", "required": true, "type": "Boolean", "value": null, "values": [], "valuesObject": null }, { "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": "RnVuY3Rpb2..." }, "type": "powerbrick", "version": "2026.10.8.2"}