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>

Specify a semicolon-delimited list of localized string cultures to load from libraries

-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