Install-MsiProduct

Installs an MSI-based software.

Note: Starting with version 3.0 of the PPB, the Install-MsiProduct command can also be generated by dragging and Windows Installer files (*.msi) into the script window. If the files are already in the package directory, the source path is referenced relatively with .\, if the source files are outside the package directory, the full path is taken.


Settings:

  • MSI package
    Specifies the Windows Installer package (*.msi file) to be installed, including path. Use the "..." button to select an existing file (on the packaging system) or enter the path manually.
  • Installation
    Specifies the installation type.
    • Machine-Related (for all users of the computer)
      The MSI-based software is installed for this computer. All users can work with the application on this computer.
    • User-Related (only for a specific user)
      The MSI-based software is installed only for this user. Other users cannot work with the application.
  • Advertisement
    MSI offers the option to install an application on first use.
    • Advertising (Install on first use)
      Only shortcuts are created and the product is actually installed the first time it is called by a user.
    • No Advertising (Full install)
      The product is fully installed at package runtime.
  • Log options
    • Enable MSI logging
      If this check box is activated, the Windows Installer creates a log file.
    • Level
      If MSI logging is enabled, this setting determines the level of detail of the Windows Installer log.
      • Debug
        The Windows Installer log file contains maximum detailed entries.
      • Normal
        The Windows Installer log file contains the normal level of detail.
    • Do not log command line parameters
      If this option is enabled, logging of the command line in the log file is prevented. Useful if confidential values (e.g. passwords, license numbers or similar) are to be passed to the call via the parameters.
  • Parameter
    Optional - contains parameters to be passed to the Windows Installer for installation.
  • Variable for MSI exit code
    Optional - Name of a variable that contains the exit code of the Windows Installer. Enter only the name of the variable, not the $ sign and the curly brackets.
  • Exact verification with additional checks
    Performs additional, detailed checks to determine if the MSI-based software has been installed correctly. This option is the only way to ensure that the log as a successful installation actually corresponds to the facts.
  • Transforms
    You can add existing transforms to MSI-based software.
    • Transform
      File name of the transform file.
    • Type
      • Secure: Are cached in a directory in which the user has no write permission.
      • Unsecure: The local copy of the transform is stored in the application directory of the user profile; this makes them accessible to the user.


Example:

The following example installs the MSI-based version of Adobe Reader including Transform:


Corresponds to DSM eScript command:

  • MSIInstallProduct


See also: