Setup.exe command-line reference (Windows SharePoint Services)

Applies To: Windows SharePoint Services 3.0

 

Topic Last Modified: 2010-11-08

In SharePoint Products and Technologies, the setup.exe command-line tool is used for very few operations, and almost all of these are for IT administrators only.

In this article

  • How to use a setup.exe command-line switch

  • Available switches and parameters

How to use a setup.exe command-line switch

When you run setup.exe, you include a space after the command, followed by a forward slash (/) and the name of the switch, and sometimes followed by another space and one or more parameters, which are specific instructions that give the program more information about how to execute the command. The table in the next section contains several examples of switches.

Available switches and parameters

In SharePoint Products and Technologies, Setup recognizes the following command-line options.

Switch or parameter Description
/config [path and file name]

Specifies the configuration file that Setup uses during the installation. By default, the Config.xml file stored in the core product folder directs Setup to install that product. You can edit the Config.xml file to make additional customizations to the installation or you can point to a different configuration file.

Use /config on the Setup command line to point to the location of the default Config.xml file for a particular product or to point to a custom configuration file.

Examples

To point to a customized config.xml file:

\\<server>\<share>\setup.exe /config \\<server>\<share>\<folder>\config.xml

where <folder> is the folder that contains the Config.xml file.

Or, to point to a different configuration file:

\\<server>\<share>\setup.exe /config \\<server>\<share>\configfiles\wss-quiet.xml

Note

You must use a fully qualified path. Setup does not recognize relative paths that contain /config.

/modify [ProductID]

Used with a modified Config.xml file to run Setup in maintenance mode and make changes to an existing installation, such as adding or removing features. Look up the value of [ProductID] in the Setup.xml file for the product you want to modify. The Setup.xml file is located in the core product folder. In Setup.xml, [ProductID] is equal to the value of the Id attribute of the Setup element. For example:

- <Setup Id="Wss" Type="Product" ProductCode="{40120000-1110-0000-0000-0000000FF1CE}">

For Windows SharePoint Services 3.0, this switch cannot be used to change the configuration of the server (such as from a stand-alone configuration to a server farm configuration). To change the configuration for Windows SharePoint Services 3.0, you must uninstall and reinstall Windows SharePoint Services 3.0 using a different configuration type.

Example

\\<server>\<share>\setup.exe /modify Wss /config \\<server>\<share>\<folder>AddConfig.xml

/repair [ProductID]

Runs Setup to repair the files needed for the specified product. Look up the value of [ProductID] in the Setup.xml file for the product you want to modify. Running Setup in repair mode only affects the program files, and does not repair your server configuration or any sites.

Note

You should also run the SharePoint Products and Technologies Configuration Wizard after you run setup.exe /repair to complete the repair of the configuration. If you are using a stand-alone configuration, you can run psconfig.exe -setup from the command line to repair the configuration instead of using the wizard. If you are in a server farm configuration, you should use the full wizard interface. For more information, see the Help for the SharePoint Products and Technologies Configuration Wizard.

Example

\\<server>\<share>\setup.exe /repair Wss

/uninstall [ProductID]

Removes the specified product from the user's computer. Look up the value of [ProductID] in the Setup.xml file for the product you want to modify.

Example

\\<server>\<share>\setup.exe /uninstall WSS

Download this book

This topic is included in the following downloadable book for easier reading and printing:

See the full list of available books at Downloadable content for Windows SharePoint Services 3.0.