Windows Installer XML (WiX) toolset
Search

ExePackage Element

Description
Describes a single exe package to install.
Windows Installer references
None
Parents
Chain, PackageGroup
Inner Text
None
Children
Choice of elements (min: 0, max: unbounded)
  • ExitCode (min: 0, max: unbounded)
  • Payload (min: 0, max: unbounded)
  • PayloadGroupRef (min: 0, max: unbounded)
  • RemotePayload (min: 0, max: unbounded)
  • Any Element (namespace='##other' processContents='Lax') Extensibility point in the WiX XML Schema. Schema extensions can register additional elements at this point in the schema. The extension's CompilerExtension.ParseElement() method will be called with the package identifier as the first value in contextValues.
Attributes
Name Type Description Required
After String The identifier of another package that this one should be installed after. By default the After attribute is set to the previous sibling package in the Chain or PackageGroup element. If this attribute is specified ensure that a cycle is not created explicitly or implicitly.  
Cache YesNoType Whether to cache the package.  
CacheId String The identifier to use when caching the package.  
Compressed YesNoDefaultType Whether the package payload should be embedded in a container or left as an external payload.  
Description String Specifies the description to place in the bootstrapper application data manifest for the package. By default, ExePackages use the FileName field from the version information, MsiPackages use the ARPCOMMENTS property, and MspPackages use the Description patch metadata property. Other package types must use this attribute to define a desciption in the bootstrapper application data manifest.  
DetectCondition String A condition that determines if the package is present on the target system. This condition can use built-in variables and variables returned by searches. This condition is necessary because Windows doesn't provide a method to detect the presence of an ExePackage. Burn uses this condition to determine how to treat this package during a bundle action; for example, if this condition is false or omitted and the bundle is being installed, Burn will install this package.  
DisplayName String Specifies the display name to place in the bootstrapper application data manifest for the package. By default, ExePackages use the ProductName field from the version information, MsiPackages use the ProductName property, and MspPackages use the DisplayName patch metadata property. Other package types must use this attribute to define a display name in the bootstrapper application data manifest.  
DownloadUrl String

The URL to use to download the package. The following substitutions are supported:

  • {0} is replaced by the package Id.
  • {1} is replaced by the payload Id.
  • {2} is replaced by the payload file name.
 
Id String Identifier for this package, for ordering and cross-referencing. The default is the Name attribute modified to be suitable as an identifier (i.e. invalid characters are replaced with underscores).  
InstallCommand String The command-line arguments provided to the ExePackage during install. If this attribute is absent the executable will be launched with no command-line arguments.  
InstallCondition String A condition to evaluate before installing the package. The package will only be installed if the condition evaluates to true. If the condition evaluates to false and the bundle is being installed, repaired, or modified, the package will be uninstalled.  
InstallSize String The size this package will take on disk in bytes after it is installed. By default, the binder will calculate the install size by scanning the package (File table for MSIs, Payloads for EXEs) and use the total for the install size of the package.  
LogPathVariable String Name of a Variable that will hold the path to the log file. An empty value will cause the variable to not be set. The default is "WixBundleLog_[PackageId]" except for MSU packages which default to no logging.  
Name String The destination path and file name for this chain payload. Use this attribute to rename the chain entry point or extract it into a subfolder. The default value is the file name from the SourceFile attribute, if provided. At a minimum, the Name or SourceFile attribute must be specified.  
PerMachine YesNoDefaultType Indicates the package must be executed elevated. The default is "no".  
Permanent YesNoType Specifies whether the package can be uninstalled. The default is "no".  
Protocol BurnExeProtocolType Indicates the communication protocol the package supports for extended progress and error reporting. The default is "none".  
RepairCommand String The command-line arguments to specify to indicate a repair. If the executable package can be repaired but does not require any special command-line arguments to do so then set the attribute's value to blank.  
RollbackLogPathVariable String Name of a Variable that will hold the path to the log file used during rollback. An empty value will cause the variable to not be set. The default is "WixBundleRollbackLog_[PackageId]" except for MSU packages which default to no logging.  
SourceFile String Location of the package to add to the bundle. The default value is the Name attribute, if provided. At a minimum, the SourceFile or Name attribute must be specified.  
SuppressSignatureVerification YesNoType By default, a Bundle will use a package's Authenticode signature to verify the contents. If the package does not have an Authenticode signature then the Bundle will use a hash of the package instead. Set this attribute to "yes" to suppress the default behavior and force the Bundle to always use the hash of the package even when the package is signed.  
UninstallCommand String The command-line arguments provided to the ExePackage during uninstall. If this attribute is absent the executable will be launched with no command-line arguments. To prevent an ExePackage from being uninstalled set the Permanent attribute to "yes".  
Vital YesNoType Specifies whether the package must succeed for the chain to continue. The default "yes" inidicates that if the package fails then the chain will fail and rollback or stop. If "no" is specified then the chain will continue even if the package reports failure.  
Any Attribute (namespace='##other' processContents='lax') Extensibility point in the WiX XML Schema. Schema extensions can register additional attributes at this point in the schema. The extension's CompilerExtension.ParseAttribute() method will be called with the package identifier in contextValues["PackageId"].
See Also
Wix Schema