# Install EXE

> Installs an application using an executable file.

Source: https://docs.capaone.com/capaone/application-manager/powerbricks/install-exe/  
Product: CapaOne — a separate CapaSystems product; do not apply this page to any other.

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**

```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": [
    {
      "allowManualInput": null,
      "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": 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
    },
    {
      "allowManualInput": 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
    },
    {
      "allowManualInput": 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
    },
    {
      "allowManualInput": 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"
        }
      ]
    },
    {
      "allowManualInput": null,
      "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": 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"
}
```