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

Article translations Article translations
Article ID: 936209 - View products that this article applies to.
Expand all | Collapse all

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

  1. Click Start
    Collapse this imageExpand this image
    the Start button
    , right-click Command Prompt, and then click Run as administrator.
  2. At the command prompt, type the following command, and then press ENTER:
    start /w ocsetup Optional component name
    Notes
    • In step 2, Optional component name 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 correct optional component name for Windows Vista to use with the ocsetup command-line, visit the following Web page, and then review the "Command-Line Name" column in the Microsoft-Windows-Foundation-Package Features table:
      http://technet.microsoft.com/library/cc722041.aspx
  3. 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

  1. Click Start
    Collapse this imageExpand this image
    the Start button
    , right-click Command Prompt, and then click Run as administrator.
  2. At the command prompt, type the following command, and then press ENTER:
    start /w ocsetup Optional component name /uninstall
    Notes
    • In step 2, Optional component name 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.
    • To determine the name of the Windows optional component, click Start
      Collapse this imageExpand this image
      the Start button
      , type optionalfeatures in the Start Search box, and then click optionalfeatures in the Programs list.
  3. 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.

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 2008, 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.

References

For more information about how to install or to remove Windows components by using the Ocsetup.exe tool, visit the following Microsoft Web site:
http://technet2.microsoft.com/WindowsVista/en/library/ced21f54-456d-4936-88a1-a0e42eea3ca31033.mspx?mfr=true
For more information about command-line options that are available for the Ocsetup.exe tool, visit the following Microsoft Web site:
http://technet2.microsoft.com/WindowsVista/en/library/9a9fe5ed-5cfb-47f0-99e3-af4ef1442ee71033.mspx?mfr=true
For more information about command-line options that are available for Package Manager, visit the following Microsoft Web site:
http://technet.microsoft.com/en-us/library/cc749465.aspx
For more information about Windows Installer, visit the following Microsoft Web site:
http://technet2.microsoft.com/WindowsServer/en/library/9361d377-9011-4e21-8011-db371fa220ba1033.mspx?mfr=true
For more information about the Sysocmgr.exe tool, click the following article number to view the article in the Microsoft Knowledge Base:
222444 How to add or remove Windows Components by using Sysocmgr.exe

Properties

Article ID: 936209 - Last Review: February 12, 2013 - Revision: 5.0
Applies to
  • Windows Vista Business
  • Windows Vista Enterprise
  • Windows Vista Home Premium
  • Windows Vista Home Basic
  • Windows Vista Ultimate
  • Windows Server 2008 Datacenter without Hyper-V
  • Windows Server 2008 Enterprise without Hyper-V
  • Windows Server 2008 for Itanium-Based Systems
  • Windows Server 2008 Standard without Hyper-V
  • Windows Server 2008 Datacenter
  • Windows Server 2008 Enterprise
  • Windows Server 2008 Standard
  • Windows Web Server 2008
Keywords: 
kbexpertiseadvanced kbhowto KB936209

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com