OCSetup 命令行选项

OCSetup

命令行选项

发布时间: 2009年10月

更新时间: 2009年10月

应用到: Windows 7

可用于向联机Windows(R)

可选组件安装程序 ()

工具是一个命令行工具，的 Windows

映像添加系统组件。该工具通过将用于安装和删除的程序包传递给部署映像服务和管理 (DISM)

工具，联机安装或删除基于组件的服务 (CBS)

程序包。通过调用

Windows

安装程序服务 ()

并向其传递要安装或删除的 Windows

安装程序组件，OCSetup

还可用于安装 Microsoft(R)

系统安装程序 (.msi)

程序包。此外，OCSetup

可用于安装具有相关联的自定义安装程序（.exe

文件）的 CBS

或 MSI

系统组件程序包。OCSetup

工具可作为 Windows® 7

和 Windows Server® 2008 R2

操作系统的一部分使用。

可以在运行 Windows 7

或 Windows Server 2008 R2

的计算机上使用

。

重要事项

若要使用 OCSetup，必须在安装系统 MSI 程序包前将其暂存，并且必须在答案文件

() 中指定程序包的路径。暂存安装程序文件的方法是：将文件置于

CustomSetup 注册表项指定的位置或 %WINSYSDIR%SysMSIStage 的默认位置（其中

是在安装程序的注册表设置中定义的安装程序的名称）。

在命令提示符下运行 OCSetup 工具之前，请将命令提示符设置为以管理员身份运行（即使您作为该计算机的管理员登录）。

命令行选项

以下命令行选项可与 OCSetup

一起使用。

[/?][/h] [/help] component [/log:file] [/norestart]

[/passive] [/quiet] [/unattendfile:file] [/uninstall] [/x:parameter]

参数 描述

/?、/h

显示所有选项的帮助，无论是否使用这些选项运行。

和 例如：

/help

复制代码

start /w ocsetup /help

component

要安装或卸载的组件名称。组件名称区分大小写。

使用分号分隔要安装或卸载的多个组件。

如果在不使用答案文件（该答案文件是在 Windows 系统映像管理器

(Windows SIM) 中创建的）的情况下配置 Windows 功能，则使用“无人参与 Windows

安装程序参考”中 Windows-Foundation-Package 部分的命令行名称。

例如：

复制代码

start /w ocsetup

指定非默认日志文件的位置。如果指定了无效路径，将在默认的日志文件位置创建日志文件。

默认的日志文件位置为：



/log:

file

更新 Windows 7 或 Windows Server 2008 R2 操作系统时的当前目录。



Windows Vista® 和 Windows Server® 2008 操作系统的

windowssystem32 目录。

备注

Windows 7 操作的日志文件的大小应该小许多。

示例：

复制代码

start /w ocsetup /log:C:

/norestart

不重新启动计算机，即使安装组件后需要重新启动。

示例：

复制代码

start /w ocsetup /norestart

无人参与模式。仅显示进度。

示例：

复制代码

start /w ocsetup

/unattendfile: /passive

/passive

/quiet

安静模式。无用户交互操作。

示例：

复制代码

start /w ocsetup /quiet

/unattendfile: file

文件会覆盖默认的配置设置或对其添加内容。也就是被动模式。

示例：

复制代码

start /w ocsetup

/unattendfile:

卸载组件。安装为默认安装。

示例：

复制代码

start /w ocsetup /uninstall

安装需要自定义安装程序的组件时将应用其他配置参数。OCSetup 会将这些参数传递给自定义安装程序。

若要确定某个组件是否具有自定义安装程序，请检查以下注册表项：

HKEY_LOCAL_MACHINESOFTWAREMicrosoftWindowsCurrentVersionSetupOptionalComponentscomponentName

CustomSetup 的值即为自定义安装程序的名称。如果已提供

CustomSetup 值，OCSetup 将推迟使用指定的 .exe 文件以执行程序包的安装。该 .exe 文件必须遵循与 相同的命令行规范，并且必须返回相同的退出代码。

备注

如果系统 MSI 文件未安装，则此注册表项将不存在。此外，如果既没有注册需自定义安装程序的程序包，也没有定义自定义安装程序，此注册表项也不会出现。

示例：

复制代码

start /w ocsetup /x:

安装或卸载需要使用自定义安装程序的程序包

安装或卸载需要自定义安装程序的程序包时，必须注册该程序包的名称。注册程序包的名称时，还要确定程序包类型（CBS

或 MSI）、任何已应用的更新以及自定义安装程序 .exe

文件的名称。

/uninstall

/x:

parameter

若要注册需要自定义安装程序的程序包，请编辑以下注册表项：

HKEY_LOCAL_MACHINESOFTWAREMicrosoftWindowsCurrentVersionSetupOCSetupComponents ComponentName

在该注册表项下添加以下值：

值

类型

类型

REG_DWORD

数据

程序包类型

0 - CBS

1 - MSI

组件

PatchFiles

REG_SZ

CBS 更新的名称或 MSI 的路径。

REG_MULTI_SZ

（可选）MSI 更新文件的路径。

（可选）自定义安装程序 .exe 文件的路径。

该自定义安装程序必须遵循与

相同的命令行规范，并且必须返回相同的退出代码。

CustomSetup REG_SZ

示例

下表提供了在客户端版本的 Windows

上使用 OCSetup

安装 Windows

可选组件的示例。

可选组件

SNMP（简单网络管理协议）

命令

复制代码

start /w ocsetup SNMP

Telnet 客户端

复制代码

start /w ocsetup TelnetClient

红心大战

复制代码

start /w ocsetup Hearts

它与 InboxGames 可选组件（必须首先安装）存在依赖关系。

下表提供了在服务器版本的 Windows

上使用 OCSetup

建立不具有依赖关系的服务器角色的示例。

服务器角色

动态主机配置协议 (DHCP)

服务器

命令

复制代码

start /w ocsetup DHCPServer

域名系统 (DNS) 服务器

复制代码

start /w ocsetup DNS-Server-Full-Role

Windows 部署服务

(Windows DS)

复制代码

start /w ocsetup

Microsoft-Windows-Deployment-Services

下表提供了使用 OCSetup

工具启用服务器版本中可用的 Windows

功能的示例。

Windows 功能

桌面体验

命令

复制代码

start /w ocsetup DesktopExperience

它与 InkSupport 可选组件（必须首先安装）存在依赖关系。

证书服务

复制代码

start /w ocsetup CertificateServices

Windows 服务器备份

复制代码

start /w ocsetup WindowsServerBackup

疑难解答

以管理员身份运行 OCSetup

备注

如果运行的是 Windows Server(R) 2008 R2 操作系统的服务器核心安装，则不需要

此过程。

1.

单击“开始”，指向“所有程序”，然后单击“附件”。

2.

右键单击“命令提示符”，然后单击“以管理员身份运行”。

要确认安装了某个组件，请执行以下操作之一：



在事件查看器中确认 OCSetup

引发了事件

OCSETUP_EVENT_INSTALLSUCCESS。



如果要启用 Windows

功能，请在“控制面板”中单击“程序”，然后在“程序和功能”下单击“打开或关闭 Windows

功能”，然后确认是否选中该 Windows

功能的复选框。还可通过从命令提示符运行

来打开“打开或关闭

Windows

功能”对话框。



在服务器核心安装上，运行 ，以列出当前安装的服务器角色和可选功能。默认情况下，OCList

工具安装在运行服务器核心安装的计算机上。

要确认删除了某个组件，请执行以下操作之一：



在事件查看器中确认 OCSetup

引发了事件

OCSETUP_EVENT_UNINSTALLSUCCESS。



如果要禁用 Windows

功能，请在“控制面板”中单击“程序”，然后在“程序和功能”下单击“打开或关闭 Windows

功能”。确认是否清除该 Windows

功能的复选框。

在服务器核心安装上，运行 ，以列出当前安装的服务器角色和可选功能。默认情况下，OCList

工具安装在运行 Windows Server 2008 R2

的服务器核心安装的计算机上。

从以下日志文件中可找到其他疑难解答信息：





Windows

更新日志 (%WINDIR%)

基于组件的服务日志 (%WINDIR%)

OCSetup

无法配置一些 Windows

功能

OCSetup

无法启用或禁用功能名称中包含空格的 Windows

功能。例如，Windows

功能“More Games”、“Internet Checkers”和“Internet Backgammon”全都包含空格。

解决方法：使用 DISM

命令从命令行启用或禁用功能。例如，dism /online

/enable-feature /featurename:"More Games"。此外，可通过使用答案文件并选择相应的程序包操作来配置 Windows

功能。

使用 OCSetup

和答案文件安装或取消安装组件可能会失败

如果尝试使用 OCSetup

和无人参与答案文件安装或卸载组件，则即使无人参与文件包含根级别组件，该过程也可能会失败。

解决方法：使用 DISM

而不是使用 OCSetup

来应用无人参与答案文件。