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

Executable Path

Required — Default: $PackageRoot\Setup.exe

Remember to include the [Download Content] PowerBrick when using $PackageRoot. Ex. $PackageRoot\setup.exe

Executable Arguments

Optional

The arguments to be used during the installation

Working Directory Path

Optional

The full path of the working directory

Await Executable

Required — Default: True

Wait for the executable to terminate before proceeding

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

Required — Default: False

Check if the executable exists before starting the installation

Return Code Handles

Required

Specify return codes and their status. Unlisted return codes will cause failure. Allowed values: Success, Retry Execution Later.

Details

• Category: Installer
• Brick ID: Install-Exe

Raw JSON definition

• JSON

{
  "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": [
    {
      "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
    },
    {
      "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
    },
    {
      "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
    },
    {
      "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
    },
    {
      "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"
        }
      ]
    },
    {
      "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
    },
    {
      "defaultValue": [
        {
          "code": 0,
          "option": {
            "name": "Success",
            "id": "success"
          }
        },
        {
          "code": 3010,
          "option": {
            "name": "Success",
            "id": "success"
          }
        }
      ],
      "defaultValueObject": null,
      "description": "Specify return codes and their status. Unlisted return codes will cause failure.",
      "id": "Codehandle",
      "name": "Return Code Handles",
      "regExValidation": "",
      "required": true,
      "type": "CodeHandles",
      "value": null,
      "values": [],
      "valuesObject": [
        {
          "id": "success",
          "name": "Success"
        },
        {
          "id": "retrylater",
          "name": "Retry Execution Later"
        }
      ]
    }
  ],
  "powershell": {
    "base64Encoded": true,
    "function": "RnVuY3Rpb2..."
  },
  "type": "powerbrick",
  "version": "2026.7.2.1"
}