Средство установки необязательных компонентов Windows® (OCSetup.exe) - это средство командной строки, используемое для добавления системных компонентов в сетевой образ Windows. Оно устанавливает или удаляет пакеты компонентной модели CBS в сети, передавая пакеты в средство DISM для установки или удаления. OCSetup также можно использовать для установки пакетов MSI, вызывая службу установщика Windows (MSIExec.exe) и передавая ей компоненты установщика Windows для установки или удаления. Кроме того, OCSetup можно использовать для установки пакетов системных компонентов CBS или MSI, у которых есть связанные собственные установщики (EXE-файлы). Средство OCSetup доступно в операционных системах Windows® 7 и Windows Server® 2008 R2.

Программу OCSetup.exe можно использовать на компьютерах под управлением Windows 7 или Windows Server 2008 R2.

Важно!
  • Чтобы использовать средство OCSetup, системные пакеты MSI необходимо предварительно сохранить перед их установкой, а пути к пакетам должны быть указаны в файле ответов (Unattend.xml). Сохранить файл установщика можно, разместив его в папке, заданной в разделе реестра CustomSetup или в папке по умолчанию %WINSYSDIR%\SysMSI\Stage\<Компонент>, где <Компонент> - это имя установщика, заданное для него в реестре.
  • Перед запуском средства OCSetup из командной строки настройте командную строку так, чтобы она выполнялась от имени администратора (даже если вход в компьютер осуществлен от имени администратора компьютера).

Параметры командной строки

Для программы OCSetup доступны следующие параметры командной строки:

ocsetup.exe [/?] [/h] [/help] компонент [/log:файл] [/norestart] [/passive] [/quiet] [/unattendfile:файл] [/uninstall] [/x: параметр]

Параметр Описание

/?, /h, /help

Выводит справку по всем параметрам при выполнении с параметрами или без них.

Пример:

start /w ocsetup /help

компонент

Имя устанавливаемого или удаляемого компонента. Для имени компонента учитывается регистр символов.

Несколько компонентов для установки или удаления разделяются точкой с запятой.

При настройке Windows без использования файла ответов, созданного с помощью диспетчера установки Windows (Windows SIM), используйте имя командной строки в разделе базового пакета Windows Справки по установке Windows в автоматическом режиме.

Пример:

start /w ocsetup <component_name>

/log: файл

Определяет нестандартное расположение файла журнала. Если указан недопустимый путь, файл журнала создается в папке журнала по умолчанию.

По умолчанию журнал хранится в следующих папках.

  • Текущий каталог при обновлении операционной системы Windows 7 или Windows Server 2008 R2.

  • Каталог \windows\system32 для операционной системы Windows Vista® и Windows Server® 2008.

Примечание.

Размер файла журнала должен быть значительно меньше для операций Windows 7.

Пример.

start /w ocsetup <component_name> /log:C:\test\ocsetup.log

/norestart

Компьютер не перезагружается, даже если это необходимо после установки компонента.

Пример.

start /w ocsetup <component_name> /norestart

/passive

Автоматический режим. Отображается только ход выполнения операции.

Пример.

start /w ocsetup <Windows Installer MSI or package name> /unattendfile:<path to answer file> /passive

/quiet

Режим подавления вывода. Пользователь не участвует в процессе.

Пример.

start /w ocsetup <component_name> /quiet

/unattendfile: файл

Файл содержит переопределения или дополнения стандартных настроек конфигурации. Предполагает пассивный режим.

Пример.

start /w ocsetup <Windows Installer MSI or package name> /unattendfile:<path to answer file>

/uninstall

Удаление заданного компонента. По умолчанию используется установка.

Пример.

start /w ocsetup <component_name> /uninstall

/x: параметр

Дополнительные параметры настройки, которые используются при установке компонента, требующего наличия пользовательского установщика. Средство OCSetup передаст эти параметры пользовательскому установщику.

Чтобы определить, имеется ли у компонента пользовательский установщик, просмотрите следующий раздел реестра:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\OptionalComponents\componentName

Значение CustomSetup - это имя пользовательского установщика. Если значение CustomSetup предоставлено, программа OCSetup перейдет к указанному исполняемому файлу для выполнения установки пакета. Исполняемый файл должен соответствовать той же спецификации командной строки, что и OCSetup.exe; исполняемый файл должен возвратить те же самые коды выхода.

Примечание.

Раздел реестра не будет существовать, если системные MSI-файлы не установлены. Кроме того, этот раздел реестра отсутствует, если пакеты, которые требуют наличия пользовательского установщика, не были зарегистрированы, а пользовательский установщик не был определен.

Пример.

start /w ocsetup <component_name> /x:<parameters>

Установка или удаление пакета, для которого нужен пользовательский установщик

Если выполняется установка или удаление пакета, требующего наличия пользовательского установщика, необходимо зарегистрировать имя этого пакета. При регистрации имени пакета также определяется тип пакета (CBS или MSI), все примененные обновления и имя исполняемого файла пользовательского установщика.

Чтобы зарегистрировать пакет, требующий наличия пользовательского установщика, измените следующий раздел реестра:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\OCSetup\Components\ Имя_компонента

Добавьте в этот раздел следующие значения.

Значение Тип Данные

Тип

REG_DWORD

Тип пакета

0 - CBS

1 - MSI

Component

REG_SZ

Имя обновления CBS или путь к MSI.

PatchFiles

REG_MULTI_SZ

(Необязательно) Путь к файлу обновления MSI.

CustomSetup

REG_SZ

(Необязательно) Путь к исполняемому файлу пользовательского установщика.

Пользовательский установщик должен соответствовать той же спецификации командной строки, что и OCSetup.exe; исполняемый файл должен возвратить те же самые коды выхода.

Примеры

Далее в таблице представлены примеры использования программы OCSetup в клиентских версиях Windows для установки дополнительных компонентов Windows.

Дополнительный компонент Команда

Протокол SNMP

start /w ocsetup SNMP

Клиент Telnet

start /w ocsetup TelnetClient

Игра «Червы»

start /w ocsetup Hearts

Зависит от дополнительного компонента InboxGames, который следует установить вначале.

В следующей таблице приведены примеры использования программы OCSetup в серверных версиях Windows для определения ролей сервера без зависимостей.

Роль сервера Команда

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 Server

start /w ocsetup WindowsServerBackup

Устранение неполадок

Чтобы запустить OCSetup от лица администратора

Примечание.

Эта процедура не нужна, если используется Windows Server® 2008 R2 версии Server Core.

  1. В меню Пуск перейдите в раздел Все программы, а затем выберите Стандартные.

  2. Щелкните правой кнопкой мыши пункт Командная строка, а затем выберите команду Запуск от имени администратора.

Чтобы проверить, установлен ли компонент, выполните одно из следующих действий.

  • Убедитесь в окне «Просмотр событий», что программа OCSetup вызвала событие OCSETUP_EVENT_INSTALLSUCCESS.

  • Если выполняется включение компонента Windows, в окне «Панель управления» выберите пункт Программы, в группе Программы и компоненты щелкните Включение или отключение компонентов Windows, а затем убедитесь, что флажок соответствующего компонента Windows установлен. Также можно открыть диалоговое окно Включение или отключение компонентов Windows, запустив файл OptionalFeatures.exe из командной строки.

  • В версии Server Core запустите файл OCList.exe для получения списка установленных серверных ролей и дополнительных возможностей. Средство OCList устанавливается по умолчанию на компьютеры с установленной версией Server Core.

Чтобы проверить, удален ли компонент, выполните одно из следующих действий.

  • Убедитесь в окне «Просмотр событий», что программа OCSetup вызвала событие OCSETUP_EVENT_UNINSTALLSUCCESS.

  • Если выполняется отключение компонента Windows, в окне «Панель управления» выберите пункт Программы, в группе Программы и компоненты щелкните Включение или отключение компонентов Windows. Убедитесь, что флажок соответствующего компонента Windows снят.

    В версии Server Core запустите файл OCList.exe для получения списка установленных серверных ролей и дополнительных возможностей. Средство OCList устанавливается по умолчанию на компьютеры под управлением Windows Server 2008 R2 версии Server Core.

Дополнительные сведения об устранении неполадок доступны в следующих файлах журнала:

  • журнал Windows Update (%WINDIR%\WindowsUpdate.log);

  • журнал компонентной модели CBS (%WINDIR%\logs\cbs\cbs.log).

Средству OCSetup не удается настроить компоненты Windows

Средству OCSetup не удается включить или отключить компоненты Windows, которые содержат пробелы в имени. Например, компоненты Windows «Дополнительные игры», «Интернет-шашки» и «Интернет-нарды» содержат пробелы.

Возможное решение: Используйте команду DISM, чтоб включить или отключить компоненты из командной строки. Например, dism /online /enable-feature /featurename:"More Games". Кроме того, компоненты Windows можно настроить с помощью файла ответов путем выбора соответствующего действия пакета.

Использование средства OCSetup и файла ответов для удаления компонентов может завершиться с ошибкой

При попытке установить или удалить компонент с помощью программы OCSetup и файла ответов автоматической установки возможна ошибка, даже если файл ответов содержит компонент корневого уровня.

Возможное решение: Используйте средство DISM для применения файла ответов автоматической установки вместо использования OCSetup.

Дополнительные сведения

Дополнительные сведения об установке и удалении системных компонентов см. на этом веб-сайте корпорации Майкрософт (может быть на английском языке).

См. также