Set Property attributes (MSI)

Reference information
Project page Action Sequences, Dialogs and Billboards
Related topics Working with attribute panes
External links External link Windows Installer documentation

Introduction

A Set Property action assigns a new value to a symbolic variable ("property" in MSI terminology). The new value may contain its own symbolic variable references; they are evaluated when the new value is assigned. You can also use this action to assign an installation folder path to a folder alias; simply specify the folder alias as the Property/Folder name (below).

Note: This action combines the functionality of MSI custom actions #35 and #51.

Tarma note The Tarma Installer equivalent is Set Variable.

Attributes

This pane contains the following attributes and options.

Attribute Description
Name

Enter the name of the action. This name must be unique among all actions in the same action sequence and must not be the name of a standard action or dialog box.

Run

Select the action's scheduling option from the drop-down list. The following options are available:

Run Description
Always Action is executed in each action sequence in which it appears.
Once Action is executed only in the first action sequence in which it appears.
Once per process Action is executed only in the first action sequence in which it appears, if the action sequences run in the same process.
If UI has run Action is executed only if a user interface action sequence has already been run.
Property/Folder

Enter the name of the property or the folder alias to set, or click ... (browse) to open the Select Product Variable dialog box that allows you to select the desired property name or folder alias.

Note: Although you can also enter or select registry key aliases, the action will not change a registry key's path. Instead, it will create a new property with the name of the registry key alias, which is probably not what you intend.

Format

Enter the new value for the selected property or folder. This value may contain its own symbolic variable references; they are evaluated when the new value is assigned.

Note: Windows Installer does not support all symbolic references. In particular, it does not support the following:

  • Registry lookup <@registry_path>
  • INI file lookup <#file_path?section?key> (but file path lookup <#file_alias> is supported)
  • Runtime functions <$func(args...)> (but component path lookup <$component> is supported)
Condition

Enter the conditional expression that determines if the action will be executed, or leave empty for unconditional execution.

Note: Windows Installer does not accept the Tarma-specific extended syntax in conditional expressions. In particular, you can not use the symbolic execution context <...> to refer to variables, registry values, INI file values, or to perform runtime functions.