Microsoft KB Archive/936209

= How to use the Ocsetup.exe tool to install or to remove Windows optional components in Windows Vista =

Article ID: 936209

Article Last Modified on 7/6/2007

-

APPLIES TO


 * Windows Vista Business
 * Windows Vista Enterprise
 * Windows Vista Home Premium
 * Windows Vista Home Basic
 * Windows Vista Ultimate

-



INTRODUCTION
This article describes how to use the Windows optional component setup tool (Ocsetup.exe) to install or to remove Windows optional components in Windows Vista.



MORE INFORMATION
Windows optional components are parts of the Windows operating system that can be individually added, removed, enabled, or disabled. You can use the Ocsetup.exe tool at the command prompt to install or to remove Windows Vista optional components. You must have administrative credentials to run the Ocsetup.exe tool.

Use Ocsetup.exe to install Windows optional components
 Click Start, right-click Command Prompt, and then click Run as administrator. At the command prompt, type the following command, and then press ENTER:

start /w ocsetup

Notes  In step 2,  specifies the name of the Windows optional component. The optional component name is case sensitive. For example, if you want to install the DHCP Server role, type start /w ocsetup DHCPServerCore, and then press ENTER. To determine the name of the Windows optional component, click Start, type optionalfeatures in the Start Search box, and then click optionalfeatures in the Programs list.  Type exit, and then press ENTER to close the Command Prompt window.

Note To display the list of command-line switches that the Ocsetup.exe tool supports, type ocsetup at the command prompt, and then press ENTER.

Use Ocsetup.exe to remove Windows optional components
 Click Start, right-click Command Prompt, and then click Run as administrator.</li> At the command prompt, type the following command, and then press ENTER:

start /w ocsetup  /uninstall

Notes  In step 2,  specifies the name of the Windows optional component. The optional component name is case sensitive. For example, if you want to remove the DHCP Server role, type start /w ocsetup DHCPServerCore /uninstall, and then press ENTER.</li> To determine the name of the Windows optional component, click Start, type optionalfeatures in the Start Search box, and then click optionalfeatures in the Programs list.</li></ul> </li> Type exit, and then press ENTER to close the Command Prompt window. </li></ol>

Note To display the list of command-line switches that the Ocsetup.exe tool supports, type ocsetup at the command prompt, and then press ENTER.

Ocsetup.exe tool functionality
The Ocsetup.exe tool provides functionality that resembles the functionality that the Sysocmgr.exe tool provides in Microsoft Windows XP and in Microsoft Windows Server 2003. In Windows Vista, Windows Defender Software Explorer and Windows Update use the Ocsetup.exe tool. In Windows Server code name “Longhorn,” Server Manager uses the Ocsetup.exe tool.

The Ocsetup.exe tool is used as a wrapper for Package Manager (Pkgmgr.exe) and for Windows Installer (Msiexec.exe). Ocsetup.exe is a command-line utility that can be used to perform scripted installs and scripted uninstalls of Windows optional components. The Ocsetup.exe tool replaces the Sysocmgr.exe tool that Windows XP and Windows Server 2003i use.

Windows optional components can be MSI-based or component-based. The Ocsetup.exe tool detects the type of optional component that is passed as a parameter. Additionally, the Ocsetup.exe tool calls the correct child process to install or to remove the optional component. If the optional component is MSI-based, the Ocsetup.exe tool calls Msiexec.exe. If the optional component is component-based, the Ocsetup.exe tool calls Pkgmgr.exe. The Ocsetup.exe tool returns back to the caller the exit code that is received from Pkgmgr.exe, from Msiexec.exe, or from the custom bootstrapping application.

For system optional components that are MSI-based, the Ocsetup.exe tool first checks a registry location to determine one of the following:
 * If a component uses the generic bootstrapping application (Ocsetup.exe).
 * If a component has a special custom-made bootstrapping application that performs install tasks or removal tasks.

Based on this determination, the Ocsetup.exe tool passes the task to the custom bootstrapping application, or the Ocsetup.exe tool internally performs generic bootstrapping tasks. The Ocsetup.exe tool performs the following generic tasks:
 * Checks the cache directory for updates.
 * Passes the MSI package name and the MSI package location to Windows Installer.
 * Passes names of one or more .msp files to Windows Installer.

The Ocsetup.exe tool also accepts configuration information that is supplied as an unattended file. For more information, see the unattended documentation. <div class="references_section">