Setup Command-line Options and Property

When you run Setup you can use command-line options to change some of the parameters that Setup uses to install the application, such as display settings and default values for Setup properties. Setup and Windows Installer use properties to control the applications installation process. The default values for Setup properties are defined in the Windows Installer package (MSI file . !ou can specify new property values on the command line or in the Setup settings file (Setup.ini . Note In most cases, command-line options override duplicate customi"ations in the Setup settings file (Setup.ini or in a transform (MST file . #ommand-line options and properties are not supported $y all MSI files.

%a %f %i %& %l %nore$oot %p %' %settings %( property)value %*

/a [msifile]

#reate an administrative installation point for the specified package (MSI file . The package must $e in the same folder as Setup.e(e, and $oth must $e at the root of the administrative installation point. +(amples, /a My.msi /a "subfolder1\My.msi"

/f[options][msifile]
-orce repair of an application associated with the specified package (MSI file . The package must $e in the same folder as Setup.e(e, and $oth must $e at the root of the administrative installation point. .lternatively, you can specify the product code for the package the product code can $e copied from the /0roduct1 section of the Setup settings file. 2ote !ou must specify the same package that was used to install the application originally. 3alid values for 4i5options4%i5 include the following -orce reinstallation of all files regardless of checksum or version. 6einstall file if missing or corrupt. 6einstall file if missing or a different version is present. 6einstall file if missing or an e'ual or older version is present. 6ewrite all re'uired 78+!9:;#.:9M.#7I2+ registry entries. 6einstall file if missing or an older version is present. 6einstall file only if missing. 6einstall all shortcuts and overwrite e(isting shortcuts. 6ewrite all re'uired 78+!9#<66+2T9<S+6 registry entries. 6etrieve the package from the original source and recache it on the local computer.

a c d e m o p s u

The Detect and Repair command in an applications performs the same function as /focums. 6unning Setup and selecting 6einstall performs the same function as /fecums. When you install, Windows Installer saves the MSI file on the local computer. When you use the /fvm option to force a recache and reinstallation, Windows Installer retrieves the MSI file from the original source and recaches it on the local computer. !ou can use the /fvm option to update client computers after you patch an administrative installation point. Important If a user applies a client ($inary patches to a computer, you cannot use %f to recache and reinstall on that computer from an updated administrative installation point. In this case, users must uninstall and reinstall from the updated administrative image. +(ample, /fpiwae My.msi /fvm {12345678-1234-1234-1234-123456789123}

/i [msifile]
Install applications using the specified package. The package must $e in the same folder as Setup.e(e. Note =y default, Setup.e(e directs Windows Installer to perform the same function as %i. +(amples, /i My.msi /i "subfolder1\My.msi"

/j[option] [msifile] [/t mstfile]

.dvertise the application on the computer and install on first use> you must specify an option to advertise the application to either the computer or the user. !ou can use %& only when running Setup from an administrative installation point or an image of the #? on the network. If no package is specified, Setup uses the package specified in Setup.ini. To apply a transform to the advertised application, use the option %t and specify an MST file. 3alid values for option include the following, m u .dvertise to all users on the computer. .dvertise to the current user.

Note In addition to %t, you can use the following three command-line options when you use %& to advertise the application, %l, %', and %settings. +(ample, /jm My.msi /t Custom.mst

/l[options] logfile
#reate a log of installation actions for Setup and a log file for each Windows Installer task. The %l option overrides default settings specified in the /:ogging1 section of Setup.ini. 3alues for option include the following and capture the corresponding data, a c e i m o p r u v w Start of action notification Initial <I parameters +rror messages Information-only messages ;ut-of-memory messages ;ut-of-disk-space messages 0roperty ta$le list in form property)value .ction data record> contains action-specific information <ser re'uest messages 3er$ose includes de$ug messages Warning messages Turn on all logging options e(cept v ! .ppend to e(isting log file

Logfile signifies the name and path of the log file to create. When you include (@ in the log file name, Setup creates a uni'ue file name for each instance of Setup. +(ample, /lv* "%temp%\MyApp Setup(*).txt" This command line creates the following log files, Setup.e(e log file "%temp%\MyAppSetup(0001).text"

Windows Installer log file for core packages "%temp%\MyApp(0001)_Task(0001).txt"

/nore"oot
?o not restart the computer or display a restart dialog $o( at the end of the installation. The /nore"oot option sets the Windows Installer 6+=;;T property to ReallySuppress for each package included in the installation e(cept the last one.

/p #mspfile]
.pply an administrative update (MS0 file to a client installation. !ou can also use /p to apply an update to an administrative installation $y including the /a option and the name and path of the MSI file on the administrative installation point. To apply the patch 'uietly, include /$" on the command line to generate a log file, include /l. +(amples, msiexec /p [mspfile] /qb /l[options] msiexec /p [mspfile] /a [msifile] /qb /l[options]

/$[option]
Set the Setup user interface display level. 3alid values for options include the following, ?isplay only simple progress indicators and error messages ($asic . ?isplay all dialog $o(es and messages> e'uivalent to omitting the /$ option (full . ?isplay no user interface> e'uivalent to specifying /$ with no options (none . ?isplay all progress indicators and error messages $ut collect no user information (reduced . Suppress all modal dialog $o(es> used only with ". .dd completion message to the n or " option.

"

r !

Note The completion message is displayed only when Setup does not have to restart the computer after the installation.

/settin%s file
Specify a custom Setup settings file for Setup.e(e to use in place of Setup.ini. The settings file must $e in the same folder as Setup.e(e, or the path must $e included on the command line. +(ample, /settings MyApp.ini

/& [msifile]
6emove the application associated with the specified package. The package must $e in the same folder as Setup.e(e, and $oth must $e at the root of the administrative installation point. Note !ou must specify the same package that was used to install the application originally. +(ample, /x My.msi

property'value
Specify a property value on the command line. If the value contains spaces, enclose it in 'uotation marks (A . To specify two or more property-value pairs, separate them with spaces. Install application for all users of the computer or for only the current user. =y default, Windows Installer installs for all users of the computer. Setting .::<S+6S to a null value (AA overrides this default $ehavior and installs per user.

.::<S+6S)/string1

Install for all users of the computer; requires administrative privileges.

B)

2 = Install for all users of the computer. "" = Install only for the user running Setup.
ALLUSER=""

Specify the level of caching. .uto ) cache $ased on availa$le disk space B ) cache only what you install #?#.#7+)/string1 C ) cache entire source D ) cache disa$led CDCACHE=auto Specify an organi"ation name. #;M0.2!2.M+)/string1 COMPANYNAME=My Business Specify the installation location. I2ST.:::;#.TI;2)/string1 INS ALLLOCA ION=C!"P#og#a$ %iles"MyA&& Specify the drive that the installation files will $e cached to. :;#.:#.#7+?6I3+)/string1 LOCALCACHEDRI'E=C +nter a CE-character volume license key on the Setup command line or in the Setup settings file. When you set the 0I?8+! property, users are not re'uired to enter a product key when they install. PID(EY=)*+,-./01)*+,2-./01)*+,2 Specify a transform to apply to the installation. T6.2S-;6MS)/string1 RANS%ORMS=""se#3e#"s4a#e"$yA&&"Custo$5$st Specify a default user name. <S+62.M+)/string1 USERNAME=Don Dun6

0I?8+!)/string1