Appendix A: Unattended Installation
Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2, Windows Server Update Services
You can use command-line parameters to run WSUS Setup in unattended mode. When running this way, WSUS Setup does not display a user interface (UI). If you need to troubleshoot the setup process, use the log files, which you can find at the following location:
WSUSInstallationDrive:\Program Files\Microsoft Windows Server Update Services\LogFiles\
Use command-line parameters from a command prompt.
Type the following command:
WSUSSetup.exe command-line parameter /v" property="value" "
where command-line parameter is a command-line parameter from the WSUS Setup command-line parameters table, where property is a property from the WSUS Setup properties table, and where value is the actual value of the property being passed to WSUS. Both tables can be found below.
If you need to pass a value to WSUS Setup, use the command-line parameter /v along with a property and its value. Properties are always paired with values. Microsoft Windows Installer requires values passed using a leading and trailing space. For example, if you wanted WSUS Setup to install the WSUS Content Directory to D:\WSUS you would use the following syntax:
WSUSSetup.exe /v" CONTENT_DIR= "D:\WSUS" "
If you need help with WSUSutil.exe, you can use the help command. For example, use the following command to display the list of command-line parameters:
WSUSSetup.exe help
WSUS Setup accepts the following command-line parameters.
WSUS Setup Command-line Parameters
Option | Description |
---|---|
/q |
Perform silent installation. |
/u |
Uninstall the product. Also uninstalls the WMSDE instance if it is installed. |
/d |
Use the existing database server (the SQL_INSTANCE property will define the instance to use). |
/o |
Overwrite the existing database. |
/? |
Display command-line Help |
/v |
Passes specified values to the Windows Installer package (.msi file). The property Name value pairs should conform to the format specified by Windows Installer. The properties should be enclosed in quotation marks with a leading and trailing space. |
/f |
Install WSUS in a special mode designed to be used with remote SQL. This option is used to set up the front-end of the WSUS installation, which includes IIS and the update storage location. For more information about remote SQL, see Appendix C: Remote SQL. |
/b |
Install WSUS in a special mode designed to be used with remote SQL. This option is used to set up the database on the back-end SQL server. For more information about remote SQL, see Appendix C: Remote SQL. |
/l |
This option used in combination with a language variable allows you to force the setup wizard to use a different language than the one detected as the default. Use a colon followed by a language variable from the Language Variables table below to set the language. |
/g |
Use this option to perform an upgrade from the RC1 version of WSUS. |
Use the following properties to configure WSUS by using the command-line parameter /v.
WSUS Setup Properties
Windows Installer Property | Description |
---|---|
CONTENT_DIR |
The directory where content will be stored. Must be an NTFS drive and can be a non-local mapped network drive. Default is WSUSInstallationDrive:\WSUS\WSUSContent, where WSUSInstallationDrive is the local drive with largest free space. |
CONTENT_LOCAL |
If set to "1" the .cab files will be stored locally (this is the default). If set to "0" the client computers will be redirected to the Microsoft Update server for downloading the .cab files. |
SQLINSTANCE_NAME |
The name of the SQL Server instance to be used. If an existing instance is not present, the default is "WSUS." |
WMSDE_DIR |
The directory where WMSDE database will be stored. The directory must be on an NTFS drive. The default is drive:\WSUS, where drive is the local drive with largest free space. |
RETAIN_DATA |
This option is used during uninstallation to define what data should be left. RETAIN_DATA=0 - Delete everything. RETAIN_DATA=1 – Leave the database. RETAIN_DATA=2 – Leave logs. RETAIN_DATA=3 - Leave the database and logs. RETAIN_DATA=4 – Leave content. RETAIN_DATA=5 - Leave the database and content. RETAIN_DATA=6 – Leave logs and content. RETAIN_DATA=7 - Leave everything (default). |
ENABLE_REPLICA |
If set to 1, enable replica mode. If set to 0, do not enable replica mode. |
REPLICA_PARENT_PORT |
Set to the ID of the replica parent port. |
REPLICA_PARENT |
Set to the name of the replica's parent server. |
Use the following properties in combination with the /l option.
Language Variables
Variable | Language name |
---|---|
CHS |
Simplified Chinese |
CHT |
Traditional Chinese |
CSY |
Czech |
DEU |
German |
ENU |
English |
ESN |
Spanish |
FRA |
French |
HUN |
Hungarian |
ITA |
Italian |
JPN |
Japanese |
KOR |
Korean |
NLD |
Dutch |
PLK |
Polish |
PTB |
Portuguese-Brazil |
PTG |
Portuguese-Portugal |
RUS |
Russian |
SVE |
Swedish |
TRK |
Turkish |