# Uninstall Program

> Uninstall software using MSI, EXE or Appx/MSIX uninstallers.

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

Uninstall software using MSI, EXE or Appx/MSIX uninstallers. Appx and MSIX packages are also deprovisioned, so they are not installed again for users who log on to the machine for the first time afterwards. Supports DisplayName with wildcards, optional Publisher/Version filtering, or direct ProductCode uninstallation.

## Parameters

#### Application Display Name
*Optional*

Application name filter. Supports wildcard (*) and is used for registry-based uninstall and Appx/MSIX package matching. Either DisplayName or ProductCode must be provided.

#### Application Version
*Optional*

Version filter for matching applications. Wildcards are supported (example: 23*). Omitting the version will uninstall all versions matching the other filters.

#### Version Operator
*Optional* — Default: `Like`

Version comparison operator used when Version is set. Allowed values: `Like`, `Equal`, `Less Than`, `Less Than Or Equal`, `Greater Than`, `Greater Than Or Equal`.

#### Application Publisher
*Optional*

Optional publisher filter. Wildcards are supported.

#### MSI Product Code
*Optional*

The MSI Product Code (GUID) to uninstall directly. Can be provided with or without braces. Either DisplayName or ProductCode must be provided.

#### Enable Extended MSI Logging
*Optional* — Default: `False`

Enable to include extra MSI debug logging in uninstall MSI log files. This setting currently applies only to MSI uninstall operations.

#### Return Code Handles
*Required*

Specify return codes and their status. Unlisted return codes will cause failure. Supports both MSI and EXE uninstall exit codes. Allowed values: `Success`, `Retry Execution Later`.

## Details

- **Category:** Installer
- **Brick ID:** `Uninstall-Program`

## Raw JSON definition

**JSON**

```json
{
  "category": "installer",
  "description": "Uninstall software using MSI, EXE or Appx/MSIX uninstallers. Appx and MSIX packages are also deprovisioned, so they are not installed again for users who log on to the machine for the first time afterwards. Supports DisplayName with wildcards, optional Publisher/Version filtering, or direct ProductCode uninstallation.",
  "developerVendor": "CapaSystems A/S",
  "displayName": null,
  "id": "Uninstall-Program",
  "name": "Uninstall Program",
  "parameters": [
    {
      "allowManualInput": false,
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "Application name filter. Supports wildcard (*) and is used for registry-based uninstall and Appx/MSIX package matching. Either DisplayName or ProductCode must be provided.",
      "id": "DisplayName",
      "name": "Application Display Name",
      "regExValidation": "",
      "required": false,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "Version filter for matching applications. Wildcards are supported (example: 23*). Omitting the version will uninstall all versions matching the other filters.",
      "id": "Version",
      "name": "Application Version",
      "regExValidation": "",
      "required": false,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": null,
      "defaultValueObject": {
        "id": "Like",
        "name": "Like"
      },
      "description": "Version comparison operator used when Version is set.",
      "id": "VersionOperator",
      "name": "Version Operator",
      "regExValidation": "",
      "required": false,
      "type": "ComboBox",
      "value": null,
      "values": [],
      "valuesObject": [
        {
          "id": "Like",
          "name": "Like"
        },
        {
          "id": "Equal",
          "name": "Equal"
        },
        {
          "id": "LessThan",
          "name": "Less Than"
        },
        {
          "id": "LessThanOrEqual",
          "name": "Less Than Or Equal"
        },
        {
          "id": "GreaterThan",
          "name": "Greater Than"
        },
        {
          "id": "GreaterThanOrEqual",
          "name": "Greater Than Or Equal"
        }
      ]
    },
    {
      "allowManualInput": false,
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "Optional publisher filter. Wildcards are supported.",
      "id": "Publisher",
      "name": "Application Publisher",
      "regExValidation": "",
      "required": false,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "The MSI Product Code (GUID) to uninstall directly. Can be provided with or without braces. Either DisplayName or ProductCode must be provided.",
      "id": "ProductCode",
      "name": "MSI Product Code",
      "regExValidation": "",
      "required": false,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": "False",
      "defaultValueObject": null,
      "description": "Enable to include extra MSI debug logging in uninstall MSI log files. This setting currently applies only to MSI uninstall operations.",
      "id": "IncludeDebugLog",
      "name": "Enable Extended MSI Logging",
      "regExValidation": "",
      "required": false,
      "type": "Boolean",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": [
        {
          "code": 0,
          "option": {
            "name": "Success",
            "id": "success"
          }
        },
        {
          "code": 1605,
          "option": {
            "name": "Success",
            "id": "success"
          }
        },
        {
          "code": 1618,
          "option": {
            "name": "Retry Execution Later",
            "id": "retrylater"
          }
        },
        {
          "code": 3010,
          "option": {
            "name": "Success",
            "id": "success"
          }
        }
      ],
      "defaultValueObject": null,
      "description": "Specify return codes and their status. Unlisted return codes will cause failure. Supports both MSI and EXE uninstall exit codes.",
      "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": "ZnVuY3Rpb2..."
  },
  "type": "powerbrick",
  "version": "2026.9.1.1"
}
```