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. 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
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.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
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.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.
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"
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” 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
See also ARPNOMODIFY
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
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"