Setup Properties | Microsoft Office 2003 Editions Resource Kit (Pro-Resource Kit)

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.

Information on the following Setup properties is included in this appendix:

ADDDEFAULT
ADDLOCAL
ADDSOURCE
ADVERTISE
ALLUSERS
ARPCOMMENTS
ARPCONTACTS
ARPHELPLINK
ARPHELPTELEPHONE
ARPNOMODIFY
ARPNOREMOVE
ARPNOREPAIR
CHECKINSTALLORDER
CIWEXTRASHORTCUTSDIRS
COMPANYNAME
COMPLETEINSTALLDESCRIPTION
COMPLETETEXT
CUSTOMINSTALLDESCRIPTION
CUSTOMTEXT
DEFAULTREMOVECHOICEDESCRIPTION
DISABLEREMOVEPREVIOUS
DISABLEROLLBACK
DISABLESCMIGRATION
DONOTMIGRATEUSERSETTINGS
DONTUSEOCIWORGNAME
ERRORSUPPORTTEXT_ADMIN_DEFAULT
ERRORSUPPORTTEXT_ADMIN_DEFAULT_PERMISSION
ERRORSUPPORTTEXT_ADMIN_DEFAULT_PROBLEM
FATAL_ERROR_TEXT
INSTALLLOCATION
KEEPALLTEXT
LIMITUI
MINIMUMINSTALLDESCRIPTION
MINIMUMTEXT
MSINODISABLEMEDIA
NOCANCEL
NOFEATURESTATEMIGRATION
NOUSERNAME
OPCREMOVAL
OUTLOOKASDEFAULTCALENDARAPP
OUTLOOKASDEFAULTCONTACTSAPP
OUTLOOKASDEFAULTMAILAPP
OUTLOOKASDEFAULTNEWSAPP
OWC10EXISTS
PIDKEY
PROOFONLYINSTALLDESCRIPTION
REBOOT
REINSTALL
REMOVE
RUNFROMSOURCEINSTALLDESCRIPTION
RUNFROMSOURCETEXT
SETUPDW
SKIPCHECKBOXDIALOG
SKIPREMOVEPREVIOUSDIALOG
SOURCELIST
StrContactInfo
TARGETDIR
TRANSFORMATSOURCE
TRANSFORMS
TRANSFORMSSECURE
TYPICALINSTALLDESCRIPTION
TYPICALTEXT
UPGRADEINSTALLDESCRIPTION
UPGRADETEXT
USERNAME

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 clear a Boolean property by assigning it a null string ("").

Example:

Setup.exe DONOTMIGRATEUSERSETTINGS=""

Public and private properties

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” in Chapter 4, “Customizing Office 2003.”

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:

ADDLOCAL
REMOVE
ADDSOURCE
ADDDEFAULT
REINSTALL
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 Platform SDK on the MSDN Web site at http://msdn.microsoft.com/library/default.asp?url=/library/en-us/msi/setup/roadmap_to_windows_installer_documentation.asp.

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:

ADDLOCAL
REMOVE
ADDSOURCE
ADDDEFAULT
REINSTALL
ADVERTISE

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:

ADDLOCAL
REMOVE
ADDSOURCE
ADDDEFAULT
REINSTALL
ADVERTISE

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 at http://msdn.microsoft.com/library/default.asp?url=/library/en-us/msi/setup/property_reference.asp.

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.

CHECK INSTALLORDER

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 “Overview of Deploying Office 2003 with the MUI Pack” in Chapter 13, “Preparing for an Office Multilingual Deployment.”

CIWEXTRA SHORTCUTSDIRS

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” in Chapter 4, “Customizing Office 2003.”

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.

Example:

COMPANYNAME="My Business"

COMPLETE INSTALL DESCRIPTION

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” in Chapter 4, “Customizing Office 2003.”

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” in Chapter 4, “Customizing Office 2003.”

CUSTOM INSTALLDESCRIPTION

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” in Chapter 4, “Customizing Office 2003.”

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” in Chapter 4, “Customizing Office 2003.”

DEFAULTRE MOVECHOICE DESCRIPTION

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” in Chapter 4, “Customizing Office 2003.”

DISABLE REMOVEPREVIOUS

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.

DISABLES CMIGRATION

DISABLESCMIGRATION=[boolean]

Retain custom shortcuts created for previous versions of Office.

Example:

DISABLESCMIGRATION=1

DONOT MIGRATEUSER SETTINGS

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” in Chapter 4, “Customizing Office 2003.”

DONTUSE OCIWORGNAME

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"

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” in Chapter 4, “Customizing Office 2003.”

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

MINIMUMINSTALL DESCRIPTION

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” in Chapter 4, “Customizing Office 2003.”

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” in Chapter 4, “Customizing Office 2003.”

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

NOFEATURE STATEMIGRATION

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” in Chapter 4, “Customizing Office 2003.”

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” in Chapter 5, “Installing Office 2003.”

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” in Chapter 4, “Customizing Office 2003.”

OUTLOOK ASDEFAULT CALENDARAPP

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

OUTLOOK ASDEFAULT CONTACTSAPP

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

OUTLOOKAS DEFAULTMAILAPP

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

OUTLOOK ASDEFAULT NEWSAPP

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 is 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"

PROOFONLY INSTALLDESCRIPTION

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 (MSI file). If you install Office 2003 or a MUI Pack quietly and the Windows Installer REBOOT property is not set to REALLYSUPPRESS, then Setup automatically restarts the computer if Windows Installer detects a file in use at the end of the installation. In Windows 2000 or later, however, there is no harm in ignoring a requested reboot for a file in use. To prevent Setup from prompting the user or automatically restarting the computer, set the REBOOT property to REALLYSUPPRESS.

Example:

[Options] REBOOT=REALLYSUPPRESS

Note

The Windows Installer REBOOT property—which takes the value FORCE, SUPPRESS, or REALLYSUPPRESS—is not the same as the Office 2003 Setup Reboot option, which takes the value 1 or 0. You use the Reboot option to restart the computer in order to complete a chained installation. In this case, Setup manages the restart process and the installation process is not interrupted. For more information, see the [ChainedInstall_n] entry in “Setup Settings File” in this appendix.

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"

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"

RUNFROM SOURCEINSTALL DESCRIPTION

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” in Chapter 4, “Customizing Office 2003.”

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” in Chapter 4, “Customizing Office 2003.”

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 application crash 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” in Chapter 4, “Customizing Office 2003.”

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

SKIPREMOVE PREVIOUSDIALOG

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” in Chapter 3, “Preparing to Deploy Office 2003.”

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"

TRANSFORMATSOURCE

TRANSFORMATSOURCE=[boolean]

Apply the transform from the root of the administrative installation point and do not cache it on the local computer. The TRANSFORMATSOURCE property applies to the package regardless of the user; it provides reliable transform storage for roaming users.

Example:

TRANSFORMATSOURCE=1

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” in Chapter 4, “Customizing Office 2003.”

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

TYPICALINSTALL DESCRIPTION

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” in Chapter 4, “Customizing Office 2003.”

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” in Chapter 4, “Customizing Office 2003.”

UPGRADEINSTALL DESCRIPTION

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” in Chapter 4, “Customizing Office 2003.”

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"