Thank you for your feedback.
Form temporarily unavailable. Please try again or contact to submit your comments.

Install Windows App activity

Log in to subscribe to topics and get notified when content changes.

Install Windows App activity

The Install Windows App activity installs an application from an MSI package on a Windows target machine.

Note: This activity replaces a Powershell activity by the same name available in releases prior to Geneva. If you have a workflow created in a previous version that uses the deprecated activity, your workflow will continue to work normally after upgrading to Geneva. However, all new workflows must use the custom version of this activity. This activity was built with the PowerShell activity designer, which gives workflow administrators the ability to store input and output variables in the databus.

Input variables

Table 1. Install Windows App input variables
Variable Description
hostname Hostname or IP address of the target Windows machine on which the service is installed. Use the Resolve DNS MID Server capability to resolve hostnames into IP addresses.
installerpath Path to the installer. The installer can be on any machine that is visible to both the MID Server and the target machine (local drive, UNC path, mapped drive, etc.).
installer Name of the installer file, such as winzip150.msi. The installer must be an MSI package.
arguments The parameter that contains the command line arguments to the MSI package. These are name=value pairs, separated by a space. For example, the argument might appear as: INSTALLDIR=c:\myinstallfolder ADDDESKTOPICON=0. These arguments are dependent on the what the actual MSI being installed defines. If there are no arguments, leave the field empty.

Output variables

Table 2. Install Windows App output variables
Variable Description
result Either success or failure.
errorMessage The executionResult.errorMessages from the Activity designer parsing sources.


The activity state tells the workflow engine what to do with the activity.
Table 3. Install Windows App conditions
Name Description
Success The Windows application was successfully installed on the target machine.
Failure The Windows application failed to install on the target machine

Enable WMI Windows Installer provider

To install software on Windows machines using the Install Windows App activity, enable WMI Windows Installer provider on all target machines.

Before you begin

  • It is recommended that the MID Server, the target machine, and the installer source machine be on the same Active Directory domain. However, if these computers are on separate domains, those domains must have a trust relationship established between them.
  • If the installer path is a UNC file sharing machine, the Active Directory account of the target computer must be trusted for delegation. For instructions on this configuration, see the posting on the community for installing and uninstalling Windows applications.

About this task

Note: See WMI Providers for a list of Windows operating systems that provide this tool by default.


  1. Open the Control Panel.
  2. Go to Add or Remove Programs.
  3. Select Add/Remove Windows Components.
  4. Double-click Management and Monitoring Tools.

    This action opens a secondary window displaying additional selections.

  5. Select WMI Windows Installer Provider check box.
  6. Click OK to return to the Windows Components Wizard window.
  7. Click Next.
    You might be asked for the Windows installation CD to complete this process.