Setup Properties

Microsoft® Office 2003 Setup and Microsoft Windows Installer use properties to help control the Office installation process. The default values for Setup properties are defined in the Windows Installer package (MSI file). You can specify new property values on the command line, in the Setup settings file (Setup.ini), or on the Modify Setup Properties page of the Custom Installation Wizard.

About properties

You use several different types of Setup properties to customize Office. Some types of properties must be set in a particular way in order to achieve the desired results.

Boolean properties

A number of properties used with Office 2003 Setup are Boolean properties. Boolean properties are either set or not set; they do not take a specific value. If a Boolean property exists, it is considered set, regardless of the property value. You set a Boolean property by assigning it any value — typically, the value 1 or True.

Example:

setup.exe DONOTMIGRATEUSERSETTINGS=1

On the Modify Setup Properties page of the Custom Installation Wizard, you can clear any Boolean property in the default list by selecting the value Clear Property. If you add a Boolean property, you can clear it by assigning it a null string (""); leaving its value blank does not change the existing state of the property. On the Setup command line or in Setup.ini, you also clear a Boolean property by assigning it a null string ("").

Example:

Setup.exe DONOTMIGRATEUSERSETTINGS=""

There are two types of Setup properties:

  • Public property names are all uppercase and can be specified on the command line, in the Setup settings file, or on the Modify Setup Properties page of the Custom Installation Wizard.
  • Private property names are a mix of uppercase and lowercase letters and can be specified only on the Modify Setup Properties page of the Custom Installation Wizard.

If you enter a property name on the command line or in Setup.ini, Setup assumes that it is a public property and converts the name to all uppercase letters. When you enter a property name in the Custom Installation Wizard, you must enter the name exactly as it is defined, in all uppercase or in mixed-case letters. With few exceptions, all properties that you can use for managing the installation process are public properties.

For more information about using Setup properties to customize an Office installation, see Methods of Customizing Office.

ADDDEFAULT

ADDDEFAULT=[string]

Return a set of features to their default installation states, as defined in the original Windows Installer package and transform (MST file). You can specify all, or you can specify a list of feature names separated by commas. Only the features you specify are reset to their default installation states; child features — including hidden child features — are not included unless you specify them explicitly.

You use the ADDDEFAULT property only during the initial installation — for example, to return all features to their default states before using the ADDLOCAL, ADDSOURCE, or ADVERTISE properties. Note, however, that regardless of how you list them on the command line, Windows Installer always evaluates these properties in the following order:

  1. ADDLOCAL
  2. REMOVE
  3. ADDSOURCE
  4. ADDDEFAULT
  5. REINSTALL
  6. ADVERTISE
For example, if the command line specifies ADDSOURCE=ALL, ADDLOCAL=MyFeature, then MyFeature is set to Run from My Computer first. Then ADDSOURCE=ALL is evaluated, and all features (including MyFeature) are set to Run from Network. For more information about working with Windows Installer properties, see the Roadmap to Windows Installer Documentation on the MSDN Web site.

 Note    If a feature is advertised by default in the Windows Installer package, then the ADDDEFAULT property sets the feature to the same state as when the user activated the feature for the first time.


Examples:

ADDDEFAULT=ALL
ADDDEFAULT="ASSISTANTClippit,ASSISTANTDot,ASSISTANTRocky"

ADDLOCAL

ADDLOCAL=[string]

Install a set of features to run from the user's computer. You can specify all, or you can specify a list of feature names separated by commas.

You can use ADDLOCAL with the ADDDEFAULT, ADDSOURCE, and ADVERTISE properties. Note, however, that regardless of how you list them on the command line, Windows Installer always evaluates these properties in the following order:

  1. ADDLOCAL
  2. REMOVE
  3. ADDSOURCE
  4. ADDDEFAULT
  5. REINSTALL
  6. ADVERTISE
For example, if the command line specifies ADDSOURCE=ALL, ADDLOCAL=MyFeature, then MyFeature is set to Run from My Computer first. Then ADDSOURCE=ALL is evaluated, and all features (including MyFeature) are set to Run from Network. For more information about working with Windows Installer properties, see the Roadmap to Windows Installer Documentation on the MSDN Web site.

Examples:

ADDLOCAL=ALL
ADDLOCAL="ASSISTANTClippit,
ASSISTANTDot,ASSISTANTRocky,EXCELFiles"

ADDSOURCE

ADDSOURCE=[string]

Install a set of features to run from the network server. You can specify all, or you can specify a list of feature names separated by commas.

You can use ADDSOURCE with the ADDDEFAULT, ADDLOCAL, and ADVERTISE properties. Note, however, that regardless of how you list them on the command line, Windows Installer always evaluates these properties in the following order:

  1. ADDLOCAL
  2. REMOVE
  3. ADDSOURCE
  4. ADDDEFAULT
  5. REINSTALL
  6. ADVERTISE
For example, if the command line specifies ADDSOURCE=ALL, ADDLOCAL=MyFeature, then MyFeature is set to Run from My Computer first. Then ADDSOURCE=ALL is evaluated, and all features (including MyFeature) are set to Run from Network. For more information about working with Windows Installer properties, see the Roadmap to Windows Installer Documentation on the MSDN Web site.

Examples:

ADDDEFAULT=ALL
ADDSOURCE="ASSISTANTClippit,
ASSISTANTDot,ASSISTANTRocky,EXCELFiles"

ADVERTISE

ADVERTISE=[string]

Advertise a set of features on the user's computer. In this state, features are installed the first time the user attempts to use them. You can specify all, or you can specify a list of feature names separated by commas.

If you specify that a parent feature be advertised, then all of its child features are also advertised; if a child feature does not support the Installed on First Use installation state, then it is set to Not Available.

Examples:

ADVERTISE=ALL
ADVERTISE="ASSISTANTClippit,
ASSISTANTDot,ASSISTANTRocky,EXCELFiles"

ALLUSERS

ALLUSERS=[string]

Install Office for all users of the computer or for only the current user. By default, Windows Installer installs Office for all users of the computer. Setting ALLUSERS to a null value ("") overrides this default behavior and installs Office per user.

Values include the following:

1 Install Office for all users of the computer; requires administrative privileges.
2 Install Office for all users of the computer; default value for Office.
"" Install Office only for the user running Setup.

 Note    Because only an administrator can install Office, Setup terminates if the user does not have administrative privileges. For Office, setting ALLUSERS to 1 has the same effect as setting it to 2.

Example:

ALLUSERS=""

ARPCOMMENTS

ARPCOMMENTS=[string]

Display additional text in Add/Remove Programs (Control Panel) when a user selects Office. Limited to 255 characters, not all of which may be displayed.

Example:

ARPCOMMENTS="Word processing and e-mail applications"

 Note    In Microsoft Windows® XP or later, users without administrative privileges are prevented from changing or removing programs listed in Add/Remove Programs.


For more information about properties related to Add/Remove Programs, see the Windows Installer Property Reference on the MSDN Web site.

ARPCONTACTS

ARPCONTACTS=[string]

Display a list of support contacts in Add/Remove Programs (Control Panel) when a user selects Office. Limited to 255 characters.

Example:

ARPCONTACTS="For assistance with Office 2003, 
contact Help Desk."

 Note    In Microsoft Windows XP or later, users without administrative privileges are prevented from changing or removing programs listed in Add/Remove Programs.


For more information about properties related to Add/Remove Programs, see the Windows Installer Property Reference on the MSDN Web site.

ARPHELPLINK

ARPHELPLINK=[string]

Display a link to a Web site in Add/Remove Programs (Control Panel) when a user selects Office. Limited to 255 characters.

Example:

ARPHELPLINK="http://MyWebServer/LocalHelp"

 Note    In Microsoft Windows XP or later, users without administrative privileges are prevented from changing or removing programs listed in Add/Remove Programs.


For more information about properties related to Add/Remove Programs, see the Windows Installer Property Reference on the MSDN Web site.

ARPHELPTELEPHONE

ARPHELPTELEPHONE=[string]

Display a Help desk telephone number in Add/Remove Programs (Control Panel) when a user selects Office. Limited to 255 characters.

Example:

ARPHELPTELEPHONE="Ext. 1000"

 Note    In Microsoft Windows XP or later, users without administrative privileges are prevented from changing or removing programs listed in Add/Remove Programs.


For more information about properties related to Add/Remove Programs, see the Windows Installer Property Reference on the MSDN Web site.

ARPNOMODIFY

ARPNOMODIFY=[boolean]

Help prevent users from modifying the Office configuration through Add/Remove Programs (Control Panel); makes the Change button unavailable.


 Note    When the ARPNOMODIFY property is set, users can still run Office Setup in maintenance mode from the command line.


Example:

ARPNOMODIFY=1

 Note    In Microsoft Windows XP or later, users without administrative privileges are prevented from changing or removing programs listed in Add/Remove Programs.


For more information about properties related to Add/Remove Programs, see the Windows Installer Property Reference on the MSDN Web site.

ARPNOREMOVE

ARPNOREMOVE=[boolean]

Help prevent users from removing Office through Add/Remove Programs (Control Panel); makes the Remove button unavailable.


 Note    When the ARPNOREMOVE property is set, users can still run Office Setup in maintenance mode from the command line.


Example:

ARPNOREMOVE=1

 Note    In Microsoft Windows XP or later, users without administrative privileges are prevented from changing or removing programs listed in Add/Remove Programs.


For more information about properties related to Add/Remove Programs, see the Windows Installer Property Reference on the MSDN Web site.

ARPNOREPAIR

ARPNOREPAIR=[boolean]

Help prevent users from repairing Office through Add/Remove Programs (Control Panel); makes the Repair button in the Support Info dialog box unavailable.

Example:

ARPNOREPAIR=1

 Note    In Microsoft Windows XP or later, users without administrative privileges are prevented from changing or removing programs listed in Add/Remove Programs.


For more information about properties related to Add/Remove Programs, see the Windows Installer Property Reference on the MSDN Web site.

CHECKINSTALLORDER

CHECKINSTALLORDER=[string]

Bypass the check that prevents some Microsoft Office 2003 Multilingual User Interface Packs (MUI Packs) from being installed before Office 2003. Use this property when the installation order for packages cannot be determined in advance, as when you are using Group Policy software installation to distribute packages or when you are using Microsoft Systems Management Server without chaining. Setting the CHECKINSTALLORDER property to False allows MUI Pack packages to be installed on the computer before Office 2003 is installed.


 Note    If you are using Group Policy software installation to deploy Office 2003 and MUI Packs, you must create a separate transform for each MUI Pack, in which you set the CHECKINSTALLORDER property to False. If you are using SMS, you can specify a value for CHECKINSTALLORDER once on the command line or in Setup.ini.


Example:

CHECKINSTALLORDER=False

For more information about installing Office 2003 with MUI Packs, see Customizing and Installing Office 2003 MUI Packs.

CIWEXTRASHORTCUTSDIRS

CIWEXTRASHORTCUTSDIRS=[string]

Search additional locations for custom shortcuts to remove when Office is removed (in addition to the folders that Setup searches by default). Enter an absolute folder path or a subfolder relative to a predefined folder. Separate multiple entries with a semicolon (;).

Example:

CIWEXTRASHORTCUTDIRS="<StartMenu\Programs>CorpApps;C:\Office\Tools"

For more information about removing custom shortcuts, see Customizing Office Features and Shortcuts.

COMPANYNAME

COMPANYNAME=[string]

Specify an organization name, which appears in the About box (Help menu) and on the banner page of Office applications.


 Note    If you enter an organization name on the Specify Default Path and Organization page of the Custom Installation Wizard, that setting takes precedence over the COMPANYNAME property set on the Modify Setup Properties page of the wizard, in the [Options] section of Setup.ini, or on the command line. For more information about resetting COMPANYNAME on the command line, see DONTUSEOCIWORGNAME below.


Example:

COMPANYNAME="My Business"

COMPLETEINSTALLDESCRIPTION

COMPLETEINSTALLDESCRIPTION=[string]

Customize the text displayed by Setup to describe the Complete Install option. The following example shows the default value in the English version of Office.

Example:

COMPLETEINSTALLDESCRIPTION="Install all of Microsoft Office 2003 
on your computer, including all optional components and tools."

For more information, see Customizing How Setup Runs.

COMPLETETEXT

This property is not customizable. Unlike the radio button labels for other installation options in Setup (such as the Custom Install option), you cannot change the label for the Complete Install option. However, you can customize the description by setting the COMPLETEINSTALLDESCRIPTION property.

For more information, see Customizing How Setup Runs.

CUSTOMINSTALLDESCRIPTION

CUSTOMINSTALLDESCRIPTION=[string]

Customize the text displayed by Setup to describe the Custom Install option. The following example shows the default value in the English version of Office.

Example:

CUSTOMINSTALLDESCRIPTION="Customize your Microsoft Office 2003 
installation by choosing which features to install on your 
computer. Recommended for advanced users."

For more information, see Customizing How Setup Runs.

CUSTOMTEXT

CUSTOMTEXT=[string]

Customize the label displayed by Setup for the Custom Install installation option. The following example shows the default value in the English version of Office.


 Note    The ampersand (&) precedes the character in the string that is to be used as the access key for the button. Pressing down both the access key and the ALT key selects the option.


Example:

CUSTOMTEXT="&Custom Install"

For more information, see Customizing How Setup Runs.

DEFAULTREMOVECHOICEDESCRIPTION

DEFAULTREMOVECHOICEDESCRIPTION=[string]

Customize the text displayed by Setup to describe the Remove previous versions option. The following example shows the default value in the English version of Office.

Example:

DEFAULTREMOVECHOICEDESCRIPTION="Choose whether to keep or remove 
previous versions of Office applications."

For more information, see Customizing How Setup Runs.

DISABLEREMOVEPREVIOUS

DISABLEREMOVEPREVIOUS=[boolean]

Do not display the Remove Previous Versions page during Setup.

Example:

DISABLEREMOVEPREVIOUS=1

DISABLEROLLBACK

DISABLEROLLBACK=[boolean]

Disable the rollback feature of Windows Installer.

Example:

DISABLEROLLBACK=1

For more information about properties related to Add/Remove Programs, see the Windows Installer Property Reference on the MSDN Web site.

DISABLESCMIGRATION

DISABLESCMIGRATION=[boolean]

Retain custom shortcuts created for previous versions of Office.

Example:

DISABLESCMIGRATION=1

DONOTMIGRATEUSERSETTINGS

DONOTMIGRATEUSERSETTINGS=[boolean]

Specify whether to copy the user's application settings when upgrading from a previous version of Office. If you apply a transform that includes an Office profile settings file (OPS file), the DONOTMIGRATEUSERSETTINGS property is set by default; otherwise, the property is not set by default.


 Note    Setting the DONOTMIGRATEUSERSETTINGS property is equivalent to clearing the Migrate user settings check box on the Customize Default Application Settings page of the Custom Installation Wizard.


Example:

DONOTMIGRATEUSERSETTINGS=1

For more information about migrating user settings, see Customizing User-Defined Settings.

DONTUSEOCIWORGNAME

DONTUSEOCIWORGNAME=[boolean]

Ignore the organization name specified on the Specify Default Path and Organization page of the Custom Installation Wizard. To override the organization name specified in a transform, use the DONTUSEOCIWORGNAME property with the COMPANYNAME property on the command line.

Example:

DONTUSEOCIWORGNAME=1 COMPANYNAME="My Business"

See also: COMPANYNAME

ERRORSUPPORTTEXT_ADMIN_DEFAULT

ERRORSUPPORTTEXT_ADMIN_DEFAULT=[string]

Customize the error message displayed by Setup during installation of Office 2003. The following example shows the default value in the English version of Office.

Example:

ERRORSUPPORTTEXT_ADMIN_DEFAULT="Contact your 
Information Technology department for assistance."

ERRORSUPPORTTEXT_ADMIN_DEFAULT_PERMISSION

ERRORSUPPORTTEXT_ADMIN_DEFAULT_PERMISSION=[string]

Customize the error message displayed by Setup during installation of Office 2003. The following example shows the default value in the English version of Office.

Example:

ERRORSUPPORTTEXT_ADMIN_DEFAULT_PERMISSION="Verify 
that you have sufficient permissions to access 
the registry or contact your 
Information Technology department for assistance."

ERRORSUPPORTTEXT_ADMIN_DEFAULT_PROBLEM

ERRORSUPPORTTEXT_ADMIN_DEFAULT_PROBLEM=[string]

Customize the error message displayed by Setup during installation of Office 2003. The following example shows the default value in the English version of Office.

Example:

ERRORSUPPORTTEXT_ADMIN_DEFAULT_PROBLEM="If problem persists, 
contact your Information Technology department for assistance."

FATAL_ERROR_TEXT

FATAL_ERROR_TEXT=[string]

Customize the text that users see when an installation fails. The following example shows the default value in the English version of Office.

Example:

FATAL_ERROR_TEXT="Installation ended 
prematurely because of an error."

INSTALLLOCATION

INSTALLLOCATION=[string]

Specify the installation location for Office 2003. On the Specify Default Path and Organization or Modify Setup Properties page of the Custom Installation Wizard, you can specify a path relative to a predefined folder. A value set on the command line or in Setup.ini overrides a value set in a transform.


 Note    Office 2003 is installed in a version-specific folder. If you choose to keep a previous version of Office on the computer, you can specify the same location without overwriting any files.


Example:

INSTALLLOCATION="C:\Program Files\MyApp"

KEEPALLTEXT

KEEPALLTEXT=[string]

Customize the label displayed by Setup for the Keep all previous versions check box, which appears on the Remove Previous Versions page of Setup only when users are upgrading from a previous version of Office. The following example shows the default value in the English version of Office.


 Note    The ampersand (&) precedes the character in the string that is to be used as the access key for the button. Pressing down both the access key and the ALT key selects the option.


Example:

KEEPALLTEXT="&Keep all previous versions"

 Note    If Microsoft Office Outlook® 2003 is already installed on the computer, then the Keep all previous versions check box does not appear at all. Unlike other Office applications, Outlook 2003 cannot coexist on the computer with a previous version of Outlook.


For more information, see Customizing How Setup Runs.

LIMITUI

LIMITUI=[boolean]

Disable interactive Setup user interface; equivalent to using the /qb command-line option or setting the Display property to basic in the Setup settings file. When the LIMITUI property is set, Setup ignores the /qf and /qr command-line options and the Display=full and Display=reduced property settings.

Setting the LIMITUI property on the Modify Setup Properties page of the Custom Installation Wizard does not affect the initial installation; however, it disables the Setup user interface when Setup runs in maintenance mode after the initial installation.


 Tip   You can use the LIMITUI and ARPNOMODIFY properties together to help prevent users from running Setup after Office is installed or making any changes to the installation.


Example:

LIMITUI=1 ARPNOMODIFY=1

See also: ARPNOMODIFY

MINIMUMINSTALLDESCRIPTION

MINIMUMINSTALLDESCRIPTION=[string]

Customize the text displayed by Setup to describe the Minimum Install option. The following example shows the default value in the English version of Office.

Example:

MINIMUMINSTALLDESCRIPTION="Install Microsoft Office 2003 with 
only the minimal required components. Recommended 
low disk space installation."

For more information, see Customizing How Setup Runs.

MINIMUMTEXT

MINIMUMTEXT=[string]

Customize the label displayed by Setup for the Minimum Install installation option. The following example shows the default value in the English version of Office.


 Note    The ampersand (&) precedes the character in the string that is to be used as the access key for the button. Pressing down both the access key and the ALT key selects the option.


Example:

MINIMUMTEXT="&Minimal Install"

For more information, see Customizing How Setup Runs.

MSINODISABLEMEDIA

MSINODISABLEMEDIA=[string]

Allow users who install Office 2003 from an administrative installation point on the network to rely on physical media, such as CD, as an alternate resiliency source.

When you run Setup with the /a option to create an administrative installation point, Windows Installer automatically sets the DISABLEMEDIA property to 1, which prevents users who install from the administrative image from using a CD as an alternate source. However, because Windows Installer 2.0 allows users to switch between compressed and uncompressed sources, this setting is no longer required.

To prevent Windows Installer from setting the DISABLEMEDIA property, set MSINODISABLEMEDIA to 1 on the command line or in Setup.ini when you create the administrative installation point. Users who install Office from this image will be able to rely on a CD – either a copy of the uncompressed administrative image or a copy of the compressed Office 2003 CD – as an alternate source.

Example:

setup.exe /a MSINODISABLEMEDIA=1

NOCANCEL

NOCANCEL=[boolean]

Remove the Cancel button from all dialog boxes displayed during Setup.

Example:

NOCANCEL=1

NOFEATURESTATEMIGRATION

NOFEATURESTATEMIGRATION=[boolean]

Disable default feature installation state migration for the Office package. When you upgrade to Office 2003, Setup detects and matches feature installation states from the previous version. Setting the NOFEATURESTATEMIGRATION property overrides this default behavior.


 Note    You can also override default installation state migration on a per-feature basis on the Set Feature Installation States page of the Custom Installation Wizard.


Example:

NOFEATURESTATEMIGRATION=1

For more information, see Customizing Office Features and Shortcuts.

NOUSERNAME

NOUSERNAME=[boolean]

Prevent Setup from defining a user name during a quiet installation. Setting the NOUSERNAME property allows users to enter their own user names the first time they run an Office application. Set this property when you install Office on a computer that you plan to use as a hard disk image.

Example:

NOUSERNAME=1

For more information, see Creating a Hard Disk Image.

OPCREMOVAL

OPCREMOVAL=[string]

Prevent Setup from removing previous versions of Office during the installation or performing any other cleanup tasks. To turn default removal behavior back on, you must set OPCREMOVAL to On. Any other value turns the property off, as shown in the following examples.

Examples:

OPCREMOVAL=Off
OPCREMOVAL=0

 Note    Turning off the OPCREMOVAL property is not the same as selecting the option Remove the following versions of Microsoft Office applications on the Remove Previous Versions page of the Custom Installation Wizard and then clearing all the check boxes. Even with all the check boxes cleared, Setup performs some general cleanup. If this property is turned off, however, Setup does not perform any cleanup.


For more information, see Customizing Removal Behavior.

OUTLOOKASDEFAULTCALENDARAPP

OUTLOOKASDEFAULTCALENDARAPP=[string]

Specify whether Outlook is the default calendar application. Valid values include the following:

1 Set Outlook as the default calendar application.
0 Prevent Outlook from being set as the default calendar application.

Example:

OUTLOOKASDEFAULTCALENDARAPP=0

OUTLOOKASDEFAULTCONTACTSAPP

OUTLOOKASDEFAULTCONTACTSAPP=[string]

Specify whether Outlook is the default contacts application. Valid values include the following:

1 Set Outlook as the default contacts application.
0 Prevent Outlook from being set as the default contacts application.

Example:

OUTLOOKASDEFAULTCONTACTSAPP=0

OUTLOOKASDEFAULTMAILAPP

OUTLOOKASDEFAULTMAILAPP=[string]

Specify whether Outlook is the default e-mail application. Valid values include the following:

1 Set Outlook as the default mail application.
0 Prevent Outlook from being set as the default mail application.

Example:

OUTLOOKASDEFAULTMAILAPP=0

OUTLOOKASDEFAULTNEWSAPP

OUTLOOKASDEFAULTNEWSAPP=[string]

Specify whether Outlook is the default news application. Valid values include the following:

1 Set Outlook as the default news application.
0 Prevent Outlook from being set as the default news application.

Example:

OUTLOOKASDEFAULTNEWSAPP=0

OWC10EXISTS

OWC10EXISTS=[string]

Ensure that the upgraded version of Microsoft Office XP Web Components are included in the Office 2003 installation.

Microsoft Office Professional Edition 2003 includes both Office 2003 Web Components (Owc11.msi) and an upgraded version of Office XP Web Components (Owc10.msi). Both MSI files appear on the installation image, and both versions are included in the Office 2003 feature tree. Office 2003 Web Components are installed by default; however, the upgraded Office XP Web Components are installed only if a previous version of Office XP Web Components exists on the user's computer.

If your organization uses solutions that rely on Office XP Web Components and you are deploying to new clients (that is, not upgrading), then you can ensure that the upgraded Office XP Web Components are included in the Office 2003 installation by setting the OWC10EXISTS property.

Example:

OWC10EXISTS=1

PIDKEY

PIDKEY=[string]

Enter a 25-character Volume License Key on the Setup command line or in the Setup settings file. When you set the PIDKEY property, users are not required to enter a product key when they install Office.

Example:

PIDKEY="1234567890123456789012345"

PROOFONLYINSTALLDESCRIPTION

PROOFONLYINSTALLDESCRIPTION=[string]

Customize the text displayed by Setup to describe the option to install only the proofing tools when you deploy Office 2003 with MUI Packs. The following example shows the default value in the English version of Office.

Example:

PROOFONLYINSTALLDESCRIPTION="Install only the proofing 
tools and other editing tools that come with 
Microsoft Office 2003 Multilingual User Interface Pack. 
Additional features may be added or removed after 
installation through Add/Remove Programs in Control Panel."

REBOOT

REBOOT=[string]

Determine whether Setup restarts the computer or prompts the user to restart during the installation of a package. To prevent Setup from prompting the user or automatically restarting the computer at the end of the installation, set the REBOOT property to ReallySuppress. By default, Office 2003 Setup sets the REBOOT property to ReallySuppress for all chained packages included in the installation except the last one.

On Windows 2000 or later, you can ignore restarts prompted by a file in use, and normally you prevent Setup from prompting the user or restarting the computer for these requested reboots by setting REBOOT to Suppress. However, Office 2003 Setup does not recognize REBOOT=Suppress for chained packages, and allows Windows Installer to restart the computer at the end of the installation process if a chained package requests or requires one. (Note that this behavior does not affect the installation of the primary package.) Instead, you must set REBOOT to ReallySuppress, which prevents both requested and required restarts; this setting is equivalent to specifying /noreboot on the command line.

For more information about chaining, see the section [ChainedInstall_n] in Setup Settings File.

For more information about REBOOT and other Windows Installer properties, see the Roadmap to Windows Installer Documentation on the MSDN Web site.

REINSTALL

REINSTALL=[string]

Reinstall a set of features on the user's computer. If you specify all, the entire product is reinstalled. You can also specify a list of feature names separated by commas. Only the features you specify are reinstalled; no child features — including hidden child features — are included.

Examples:
REINSTALL=ALL
REINSTALL="ASSISTANTClippit,ASSISTANTDot,
ASSISTANTRocky,EXCELFiles"

REINSTALLMODE

REINSTALLMODE=[string]

Specify the type of reinstallation to perform when updating client computers from a patched administrative installation source. Typically used with the REINSTALL property. The default values for Office are vomu; valid values include the following:

p Reinstall only if file is missing.
o Reinstall if file is missing or if an older version is present.
e Reinstall if file is missing or if an equal or older version is present.
d Reinstall if file is missing or if a different version is present.
c Reinstall if file is missing or corrupted.
a Force all files to be reinstalled.
u Rewrite all required registry entries in the HKEY_CURRENT_USER hive.
m Rewrite all required registry entries in the HKEY_LOCAL_MACHINE hive.
s Reinstall all shortcuts and recache all icons, overwriting any existing shortcuts or icons.
v Run from the source and recache the MSI file on the user's computer.

Example

setup.exe REINSTALL=[list of features modified by the update] REINSTALLMODE=vomu /qb

For more information, look up the REINSTALLMODE property Windows in the Roadmap to Windows Installer Documentation on the MSDN Web site.

REMOVE

REMOVE=[string]

Remove a set of features from the user's computer. If you specify all, the entire product is removed. You can also specify a list of feature names separated by commas. If you specify that a parent feature be removed, then all of its child features are also removed.

Examples:

REMOVE=ALL
REMOVE="ASSISTANTClippit,ASSISTANTDot,
ASSISTANTRocky,EXCELFiles"

RUNFROMSOURCEINSTALLDESCRIPTION

RUNFROMSOURCEINSTALLDESCRIPTION=[string]

Customize the text displayed by Setup to describe the Run from Network option. The following example shows the default value in the English version of Office.

Example:

RUNFROMSOURCEINSTALLDESCRIPTION="Install Microsoft Office 2003 
to run from the network source. Requires minimal 
space on your hard drive, and the source will be 
required in order to use Office."

For more information, see Customizing How Setup Runs.

RUNFROMSOURCETEXT

RUNFROMSOURCETEXT=[string]

Customize the label displayed by Setup for the Run from Network option. The following example shows the default value in the English version of Office.


 Note    The ampersand (&) precedes the character in the string that is to be used as the access key for the button. Pressing down both the access key and the ALT key selects the option.


Example:

RUNFROMSOURCETEXT="Run From N&etwork"

For more information, see Customizing How Setup Runs.

SETUPDW

SETUPDW=[string]

Set or disable Setup error reporting (DW.exe). Set the SETUPDW property to 0 to prevent Dw.exe from reporting installation errors to Microsoft; set it to 1 to collect information about Setup failures and send the data to Microsoft. This property affects only Setup error reporting, and has no effect on Microsoft Office Error Reporting.


 Note    The SETUPDW property is set to 0 by default when you create an administrative installation point.


Example:

SETUPDW=1

For more information, see Customizing How Setup Runs.

SKIPCHECKBOXDIALOG

SKIPCHECKBOXDIALOG=[string]

Do not display the page that appears during Setup when users select the Custom Install option. On this page users can select the check box next to any application to install a typical set of features. Setting the SKIPCHECKBOXDIALOG property to 1 hides the page and prevents users from selecting installation options for themselves.

Example:

SKIPCHECKBOXDIALOG=1

SKIPREMOVEPREVIOUSDIALOG

SKIPREMOVEPREVIOUSDIALOG=[string]

Do not display the Remove Previous Versions dialog box during Setup. The Custom Installation Wizard sets this property to 1 when you select the Remove the following versions of Microsoft Office applications option on the Remove Previous Versions page of the Custom Installation Wizard.

Example:

SKIPREMOVEPREVIOUSDIALOG=1

SOURCELIST

SOURCELIST=[string]

Specify additional network servers to use when the primary Office installation image is unavailable; equivalent to the list specified on the Identify Additional Servers page of the Custom Installation Wizard.

After Office is installed, Windows Installer continues to reference the administrative installation point for installing on demand, repairing features, or running Setup in maintenance mode. Copying the original administrative image to backup servers helps ensure that users always have access to a network source.

If you install Office from a compressed CD image with a local installation source enabled, then Windows Installer relies on the cache on the local computer for these operations. If the local installation source is corrupted or deleted, however, then the Office Source Engine goes to compressed images specified by SOURCELIST to recreate the local installation source.


 Note    Separate a list of server shares with semicolons. Use a drive letter only if the drive is part of a standard drive scheme used throughout the organization.


Example:

SOURCELIST="\\backup1\office11;\\backup2\office11"

For more information, see Setup Sequence of Events.

StrContactInfo

StrContactInfo=[string]

Provide contact information for technical support when Setup displays an error message; applies only to errors displayed by Setup.exe.


 Note    You cannot set this property (or other properties shown in mixed-case letters) on the Setup command line or in the Setup settings file. You can set the StrContactInfo property only on the Modify Setup Properties page of the Custom Installation Wizard.


Example:

Enter the following value on the Modify Setup Properties page:

"For help with this error, please contact Help Desk at ext. 1000."

TARGETDIR

TARGETDIR= [string]

Specify the location where the Office package is copied during an administrative installation; used only when running Setup with the /a command-line option.

Example:

TARGETDIR="\\server\share\OfficeXPAIP"

TRANSFORMS

TRANSFORMS=[string]

Specify a transform to apply to the installation; use only on the Setup command line. The TRANSFORMS property is equivalent to the MST1 option in the [MST] section of the Setup settings file. The value can be a path relative to the folder that contains Setup.exe, an absolute path, or an environment variable.

You cannot use the TRANSFORMS property in the Setup settings file to specify a transform for the Office 2003 package or any chained packages.


 Note    If you misspell the TRANSFORMS option on the command line as TRANSFORM (singular), then Setup returns an error and your transform is not applied. Similarly, if you enter Cmdline=TRANSFORM= in the [ChainedInstall_n] section, then your transform is not applied; in this case, however, no error is displayed.


Example:

TRANSFORMS="\\server\share\OfficeAIP\Custom.mst"

For more information, see Methods of Customizing Office.

TRANSFORMSSECURE

TRANSFORMSSECURE=[boolean]

Cache the transform on the local computer in a location where the user does not have write access, and apply the transform only if the MST file is located at the root of the administrative installation point (that is, in the same folder as the MSI file). The TRANSFORMSSECURE property applies to the package regardless of the user; it helps to provide secure transform storage for traveling users.

Example:

TRANSFORMSSECURE=1

TYPICALINSTALLDESCRIPTION

TYPICALINSTALLDESCRIPTION=[string]

Customize the text displayed by Setup to describe the Typical Install option. The following example shows the default value in the English version of Office.

Example:

TYPICALINSTALLDESCRIPTION="Install Microsoft Office 2003 
with only the most commonly used 
components. Additional features may be installed 
on first use, or added later through 
Add/Remove Programs in Control Panel."

For more information, see Customizing How Setup Runs.

TYPICALTEXT

TYPICALTEXT=[string]

Customize the label displayed by Setup for the Typical Install installation option. The following example shows the default value in the English version of Office.


 Note    The ampersand (&) precedes the character in the string that is to be used as the access key for the button. Pressing down both the access key and the ALT key selects the option.


Example:

TYPICALTEXT="&Typical Install"

For more information, see Customizing How Setup Runs.

UPGRADEINSTALLDESCRIPTION

UPGRADEINSTALLDESCRIPTION=[string]

Customize the text displayed by Setup to describe the Upgrade installation option when the user is upgrading from a previous version of Office. The following example shows the default value in the English version of Office.

Example:

UPGRADEINSTALLDESCRIPTION="Install Microsoft Office 2003 based 
on your current Office configuration, and remove previous 
versions of Office from your computer."

For more information, see Customizing How Setup Runs.

UPGRADETEXT

UPGRADETEXT=[string]

Customize the label displayed by Setup for the Upgrade installation option when the user is upgrading from a previous version of Office. The following example shows the default value in the English version of Office.


 Note    The ampersand (&) precedes the character in the string that is to be used as the access key for the button. Pressing down both the access key and the ALT key selects the option.


Example:

UPGRADETEXT="&Upgrade

USERNAME

USERNAME=[string]

Specify a default user name, which appears in the About box (Help menu) and on the banner page of Office applications. The name is also used in Office documents to identify the author or the source of revision marks and comments.

Example:

USERNAME="Don Funk"

Related link

Office 2003 Setup also uses the following properties to manage the local installation source: CDCACHE, LOCALCACHEDRIVE, PURGE, and DELETEABLECACHE. You customize these properties in the Setup.ini file. For more information, see the section [CACHE] in Setup Settings File.

 
 
Applies to:
Deployment Center 2003