(Un)Install MSI Setup

This plug-in provided command installs, re-installs, or uninstalls a Windows Installer setup. A full Windows Installer setup command line may be specified. The progress of the Windows Installer setup will be captured and displayed as part of the installation progress.

Action String

The action string designates whether the Windows Installer setup will be installed, re-installed, or uninstalled. Custom action strings may also be used, for instance to change the installed feature set of an application.

Enter any legal Windows Installer command line parameter here. Click one of the Install, Re-Install or Uninstall buttons to automatically generate a standard command line parameter.

Use Package Guid

Check this field and enter the package guid of the Windows Installer setup to operate on. The package guid option is most useful when you intend to uninstall an already installed Windows Installer setup, and do not wish to include the MSI file for the setup.

Use Package File

Check this field and enter the full path to the Windows Installer setup database file to operate on. The package file option is most useful when you intend to install a Windows Installer setup, and will be distributing the MSI file with your own setup.

Package is InstallAware generated installation

Check this field if the command will be used to operate on an InstallAware setup. This command will fail on InstallAware setups unless this field is checked. Checking this field for non-InstallAware setups is not recommended.

Log File

If you wish to log the result of the (un)installation, enter the full path to the log file to use here.

Return Result in Variable

This variable, if previously defined, will hold one of the following values based on the result of the (un)install operation:

Value	Meaning
SUCCESS	Installation was completed successfully.
ERROR	An error occured during installation.
REBOOT	Installation was completed successfully, however a reboot is required.

Return Last Error in Variable

If an error occured during installation, this variable, were it previously defined, will hold a textual description of that error.

 Notes

• Think of this command as a shell to Windows Installer.
• If you wish to install a Windows Installer setup as part of your application:
  1. Add the MSI database of the setup to your project as a support file.
  2. Use this command with the Use Package File option, and specify the path to the MSI database using the form $SUPPORTDIR$\<setup database>.msi.
• If you wish to uninstall a previous version of your own application using this command:
  1. Check if a previous version of your application exists on the system using the NEEDSUPGRADE variable.
  2. Use this command with the Use Package Guid option, and specify $PRODUCTCODE$ as the package guid.