Windows Installer properties are used during the installation process.
You can use the drop-down list in the toolbar to select the current build. Also, all the changes made in this view apply only to the current build.
- Application Folder - in this field you can specify the default path for the installation folder. This path is stored in the APPDIR property and it is represented by the "Application Folder" directory in the Files and Folders Page. During the installation, the user can modify this path by either using the button in the "FolderDlg" (Select Installation Folder) dialog or by manually editing the Path Edit control on the same dialog. The default value of this field points to a sub-folder of the "Program Files" folder.
- Application Shortcut Folder - in this field you can specify the default path of the folder which will contain the application's shortcuts. This path is stored in the SHORTCUTDIR property and it is represented by the "Application Shortcut Folder" directory in the "Files and Folders" page. The default value of this field points to the Windows taskbar's "Start" -> "Programs" menu.
These values are directly editable, with a suggested set of defaults available in the drop-down lists. Click the Edit Formatted Type Dialog.button to change them through the
Select between 32-bit, 64-bit for Intel processors, 64-bit for AMD processors and mixed 32/64 bit packages. You can read more about the difference between those types in the Package Types page.
- Per-user only - the application will be available
only for the user who installed it.
- On Windows Vista or above, with this option set, the logged user will never be elevated to administrative privileges, so if the installation requires such privileges, it will fail.
- Per-user only (with administrator rights required)
- on Windows Vista or above, use this option in order to create a
package which will be installed per user but requires administrator
privileges (e.g. its application files need to be installed in a
privileged location such as "Program Files").
- In this case the user may see an Elevation Prompt dialog that will ask for administrator privileges. If the logged user is member of the "Administrators" user group, he will be asked to allow or deny the installation, otherwise he will be prompted to provide credentials for one of the computer administrators.
- On other Windows versions this option behaves like the previous one.
- Per-machine only (fails if user is not
administrator) - the application will be available for all
the users of that machine.
- On Windows Vista or above the user may see an Elevation Prompt dialog that will ask for administrator privileges when installing the package. If the logged user is member of the "Administrators" user group, he will be asked to allow or deny the installation, otherwise he will be prompted to provide credentials for one of the computer administrators.
- Per-machine if user is administrator, per-user
otherwise - the application will be installed
"Per-machine" if the user has administrative rights and
- To help with the appropriate install location, AI_UserProgramFiles property will be referenced in the application folder path.
- On Windows Vista and above this option has the same installation behavior as the previous one.
- On Windows 7 or above the installation will be per-user with no UAC prompt only if the resources are installed in per-user locations. Besides this, the installation will also require the InstallTypeDlg so the user can choose the per-user option. This option will set the MSIRunningElevated property which can be manually set instead of using the dialog.
A per-user installation cannot upgrade a per-machine installation and a per-machine installation cannot upgrade a per-user installation. However, you can try using a Preserve Install Type of the old version predefined UI custom action.
On Windows Vista or above, it is strongly recommended that you do not alter the value of the ALLUSERS property during install.
When performing a Per User installation the package must respect some rules:
- it creates registry entries only under HKEY_CURRENT_USER
- it creates shortcuts only in the user's profile (not in per-machine locations)
- it writes information only in Per User locations (for example a normal user cannot write in the "Windows" or "Program Files" folders)
Windows Installer can determine when a system reboot is required and automatically prompt the user at the end of the installation. For instance, if the installer needs to replace any files that are in use during the installation it will automatically prompt for a reboot once the installation is finished.
You can change this default behavior by specifying one of the options below in order to always prompt for a reboot or to suppress some or all reboot prompts.
- Prompt for Reboot when required - let Windows Installer decide when a system reboot is necessary (for example, when it needs to replace any files that are in use during the installation).
- Force Reboot after install - always prompt for a reboot at the end of the installation, even if a system reboot is not required.
- Suppress Reboot after install, except for ForceReboot actions - Suppress prompts for a reboot at the end of the installation. If the installer encounters the ForceReboot action, it still prompts the user with an option to reboot during the installation.
- Suppress all Reboots and Reboot prompts - all reboots and reboot prompts at the end of the installation and during the installation (initiated by the ForceReboot action) are suppressed.
A reboot request will discontinue a chained installation. If one of the chained packages requires a reboot you should suppress it by setting the REBOOT property to ReallySuppress. For the main package you can set the REBOOT property to Force. This way a reboot will be performed when the chained installation is complete.
Perform the reboot if required without showing any prompts
This option makes the installer perform any required reboots automatically, without prompting the user.
Limit to basic user interface (simple progress and error handling)
This option directs Windows Installer to display only a dialog with a progress bar showing the evolution of the installation and the message boxes that display error messages. It is used especially for unassisted or automated installs (e.g deployment through Group Policy).
If you select this option, the “Disable Modify” option from “Add/Remove (Control Panel)” will also be selected.
Enable Verbose Logging
By enabling this option, a log file will be generated each time the install package runs. This option sets the Windows Installer MsiLogging property to v value. Windows Installer will automatically set the MsiLogFileLocation property to the path where the log file will be generated. By default, the MsiLogFileLocation will point to:
- CurrentUser\LocalSettings\Temp\MSI*.LOG for Windows XP.
- CurrentUser\AppData\Local\Temp\MSI*.LOG for Windows Vista or later.
Where * is a random set of letters and numbers.
The MsiLogFileLocation is a Read-only property and cannot be changed by the package author or by the user. It's value is automatically set during the run time of the installation package.
This option requires Windows Installer 5.0 on Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista, Windows Installer 4.5 on Windows Server 2003 or Windows XP in order to work properly.
Run as administrator - enabling this option automatically sets the execution level to "Require Administrator". Disabling it will set the execution level back to "As Invoker" default.
Execution level... - this link displays the EXE bootstrapper's Execution Level Settings.
Setting the execution level to "Highest Available" or "Require Administrator" will enable "Create EXE setup file" option from Media Page. If this option is disabled in the Configuration tab, setting the execution level to "No Execution Level" will not enable it.
Minimize Installation Time
This options enables you to drastically reduce the time it takes your application to install by:
- Moving files on the same volume rather than copy
- Suppressing installation progress estimate
- Installation is using the Enhanced User Interface
- The install location selected by the user is on the same drive where the files have been extracted
- Per machine installation is performing
- This is first time the application is installing
- No features are being advertised or installed to run from source
- No isolated components are being installed
The three following options can be used together but are ignored on machines with Windows Installer 4.0 or older. The installation time can be decreased with these options only when Windows Installer 4.5 or higher is found on the target machine.
Don't save system restore points for installation
If this option is set Windows Installer will not longer create system restore points for the install process.
Perform only file costing and skip checking other costs
If this option is set Windows Installer will perform only file costing, ignoring the rest of costs.
Reduce the frequency of progress messages
If this option is set the installation progress is updated less frequently.
You can add new custom Properties to your MSI package. This page is mainly used to give default values to the properties in your package. If your package uses properties initialized by another part of the installation (for example the User Interface), then there is no need to specify that property in this section.
Creating a new property
Use the Insert key while the focus is on the list control. If you specify a property which is already created by another part of the installation package (for example the property of a dialog control), this property will be not be created. Instead, the information you specified in the "New Property" dialog will update the existing information of this property.toolbar button, the “New” list context menu item or press the
Modifying a property's name or value
Use the “Edit” list context menu item or press the Space key while the focus is on the name or value column in the list control.
The properties values are PseudoFormatted Type. The property can be localized from its value field's context menu as described in How do I localize the value of a property based on the OS language? article.
Removing a property
Use the Delete key while the focus is on the list control.toolbar button, the “Delete” list context menu item or press the