Light usage

Light usage:

light.exe [-?] [-b basePath] [-nologo] [-out outputFile] objectFile [objectFile ...]

Light supports the following command line parameters:

Switch

Meaning

-ai

Allow identical rows; identical rows will be treated as a warning

-au

Allow unresolved references; this will cause invalid output to be created

-b

Specify a base path to locate all files; the default value is the current working directory

-bf

Bind files into a wixout; this switch is only valid when also providing the -xo option

-cc

Specify a path to cache built cabinet files; the path will not be deleted after linking

-ct <N>

Specify the number of threads to use when creating cabinets; the default is the %NUMBER_OF_PROCESSORS% environment variable

-cultures:<cultures>

Specifies a semicolon or comma delimited list of localized string cultures to load from .wxl files and libraries. Precedence of cultures is from left to right. For more information see Specifying cultures to build.

-cub

Provide a .cub file containing additional internal consistency evaluators (ICEs) to run

-d<name>=<value>

Define a WiX variable

-ext

Specify an extension assembly

-fv

Add a FileVersion attribute to each assembly in the MsiAssemblyName table (rarely needed)

-loc <loc.wxl>

Provide a .wxl file to read localization strings from

-nologo

Skip printing Light logo information

-notidy

Prevent Light from deleting temporary files after linking is complete (useful for debugging)

-out

Specify an output file; by default, Light will write to the current working directory

-pedantic

Display pedantic output messages

-reusecab

Reuse cabinets from the cabinet cache instead of rebuilding cabinets

-sa

Suppress assemblies: do not get assembly name information for assemblies

-sacl

Suppress resetting ACLs (useful when laying out an image to a network share)

-sadmin

Suppress adding default Admin sequence actions

-sadv

Suppress adding default Advt sequence actions

-sdut

Suppress dropping unreal tables to the output image; this switch is set by default when the -xo switch is provided

-sice:<ICE>

Suppress running internal consistency evaluators (ICEs) with specific IDs

-sma

Suppress processing the data in the MsiAssembly table

-sf

Suppress files: do not get any file information; this switch is equivalent to the combination of the -sa and -sh switches

-sh

Suppress file information: do not get hash, version, language and other file properties

-sl

Suppress layout creation

-ss

Suppress schema validation for documents; this switch provides a performance boost during linking

-sui

Suppress adding default UI sequence actions

-sv

Suppress intermediate file version mismatch checking

-sval

Suppress MSI/MSM validation

-sw<N>

Suppress warnings with specific message IDs

-ts

Tag sectionId attribute on rows; this switch is set by default when the -xo switch is provided

-tsa

Tag sectionId attribute on rows and generate the rows when null; this switch is set by default when the -xo switch is provided

-usf <output.xml>

Specify an unreferenced symbols file

-v

Generate verbose output

-wx

Treat warnings as errors

-xo

Generate XML output instead of an MSI

-?

Display Light help information