WiX Toolset

Insignia Task

The Insignia task wraps insignia.exe, the WiX inscribing/signing tool. It supports a variety of settings that are described in more detail below. To control these settings in your .wixproj file, you can create a PropertyGroup and specify the settings that you want to use for your process. You can refer to the Candle Task for details about how to set up a PropertyGroup.

The following table describes the common WiX MSBuild parameters that are applicable to the Insignia task.

Parameter Description
SuppressAllWarnings Optional boolean parameter.

Specifies that all warnings should be suppressed. This is equivalent to the -sw switch.
SuppressSpecificWarnings Optional string parameter.

Specifies that certain warnings should be suppressed. This is equivalent to the -sw[N] switch.
TreatSpecificWarningsAsErrors Optional string parameter.

Specifies that certain warnings should be treated as errors. This is equivalent to the -wx[N] switch.
TreatWarningsAsErrors Optional boolean parameter.

Specifies that all warnings should be treated as errors. This is equivalent to the -wx switch.
VerboseOutput Optional boolean parameter.

Specifies that the tool should provide verbose output. This is equivalent to the -v switch.

The following table describes the parameters that are specific to the Insignia task.

Parameter Description
BundleFile Optional string parameter.

Specify the bundle file to be used either to extract the engine from or to sign.
OriginalBundleFile Optional string parameter.

Specify the original bundle file to be used for reattaching an engine bundle.
DatabaseFile Optional string parameter.

Specifies the msi package to inscribe.
OutputFile Optional string parameter.

Specifies the output file in all cases. In the case of singing a bundle, it specifies the signed bundle. In the case of detaching the engine, it specifies the detached engine file. Lastly, when reattaching the engine, it specifies the new bundle with the reattached engine.
NoLogo Optional boolean parameter.

Skip printing insignia logo information.