Skip to main content
Version: v3

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.

ParameterDescription
SuppressAllWarningsOptional boolean parameter.

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

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

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

Specifies that all warnings should be treated as errors. This is equivalent to the -wx switch.
VerboseOutputOptional 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.

ParameterDescription
BundleFileOptional string parameter.

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

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

Specifies the msi package to inscribe.
OutputFileOptional 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.
NoLogoOptional boolean parameter.

Skip printing insignia logo information.