Поделиться через

Использование API клиента служб развертывания Windows

  • Статья

В средах, где стандартное решение служб развертывания Windows (WDS) не может использоваться для установки Windows, API клиента WDS позволяет разработчикам создавать пользовательские приложения развертывания. Приложения могут использовать этот API для взаимодействия с сервером WDS для получения сведений об образах системы, доступных с сервера. Пользовательские клиентские приложения WDS должны соответствовать следующим рекомендациям.

Установка роли WDS на сервере

  • Службы развертывания Windows (WDS) — это пересмотренная версия служб удаленной установки (RIS). Вам потребуется роль сервера WDS на сервере для реализации пользовательских клиентских решений WDS.
  • WDS заменяет RIS в качестве стандартного компонента, начиная с Windows Server 2008 и Windows Server 2003 с пакетом обновления 2 (SP2).
  • Необходимо обновить сервер RIS до WDS в Windows Server 2003 с пакетом обновления 1 (SP1). Вы можете установить роль сервера WDS с помощью пакет автоматической установки Windows (WAIK).

Запуск Windows PE 2.0

Среда предустановки Windows 2.0 должна быть запущена, если она еще не запущена. Клиент WDS и поддерживаемые библиотеки DLL загружаются setup.exe только на этапе настройки среды предустановки Microsoft Windows (Windows PE 2.0).

  • Когда новый компьютер подключен к сети, для скачивания программы сетевой загрузки можно использовать встроенную технологию PXE. Дополнительные сведения о PXE-загрузке компьютера для установки Windows см. в разделе Пошаговое руководство по обновлению служб развертывания Windows.
  • Загрузочный образ WINDOWS PE 2.0 RAMDISK можно сохранить в . Формат WIM и скачанный в процессе загрузки сети. Затем windows PE можно загрузить и запустить непосредственно с этого носителя.

Открытие сеанса с сервером WDS

Клиент WDS должен открыть сеанс с сервером WDS.

  • Используйте функцию WdsCliCreateSession , чтобы открыть сеанс с сервером WDS. Эта функция принимает имя или IP-адрес сервера и получает адрес дескриптора для сеанса клиента WDS.
  • Если для открытия сеанса на сервере потребуется проверка подлинности клиента WDS, приложение должно предоставить адрес структуры WDS_CLI_CRED , содержащей учетные данные клиента, при вызове функции WdsCliCreateSession . Приложение может использовать функцию WdsCliAuthorizeSession для преобразования анонимного сеанса в сеанс, прошедший проверку подлинности.
  • Если сеанс, открытый с помощью функции WdsCliCreateSession , больше не требуется, приложение должно использовать функцию WdsCliClose для закрытия дескриптора и освобождения ресурсов, удерживаемых сеансом.

Перечисление образов системы на сервере WDS

Клиент WDS может использовать API для перечисления образов системы на сервере WDS.

  • Используйте функцию WdsCliFindFirstImage , чтобы получить дескриптор первого образа и инициализировать перечисление образов на сервере WDS.
  • Используйте функцию WdsCliFindNextImage , чтобы увеличить перечисление, начатое функцией WdsCliFindFirstImage . Функция WdsCliFindNextImage получает дескриптор для следующего изображения.
  • Используйте функцию WdsCliGetImageIndex , чтобы получить индекс образа для текущего образа. Это значение допустимо только до повторного использования функций WdsCliFindNextImage или WdsCliClose .
  • Используйте функцию WdsCliGetEnumerationFlags , чтобы получить информационные флаги о фильтрации изображений.

Получение сведений об изображениях

Клиент WDS может использовать API для получения сведений об образах на сервере WDS. Следующие функции получают сведения о текущем образе. Так как функции WdsCliFindFirstImage и WdsCliFindNextImage изменяют текущее значение дескриптора образа, приложение должно сохранить все сведения, которые оно получит и потребуется в будущем, прежде чем снова вызывать функции WdsCliFindFirstImage или WdsCliFindNextImage .

  • Используйте функцию WdsCliGetImageArchitecture , чтобы получить архитектуру процессора текущего образа.
  • Используйте функцию WdsCliGetImagePath , чтобы получить относительный путь к файлу образа, который содержит текущее изображение.
  • Используйте функцию WdsCliGetImageSize , чтобы получить размер изображения.
  • Используйте функцию WdsCliGetImageVersion , чтобы получить версию образа.
  • Используйте функцию WdsCliGetImageLanguage , чтобы получить язык по умолчанию для текущего образа.
  • Используйте функцию WdsCliGetImageLanguages , чтобы получить массив языков, поддерживаемых текущим изображением.
  • Используйте WdsCliGetImageLastModifiedTime, возвращающее время последнего изменения для текущего образа.
  • Используйте функцию WdsCliGetImageName , чтобы получить имя текущего образа.
  • Используйте функцию WdsCliGetImageDescription , чтобы получить описание текущего образа.
  • Используйте функцию WdsCliGetImageGroup , чтобы получить имя группы образов для текущего образа.
  • Используйте функцию WdsCliGetImageHalName , чтобы получить имя уровня аппаратной абстракции (HAL) для текущего образа.

Журнал событий клиента WDS

Функция ведения журнала клиентской библиотеки WDS позволяет отправлять события хода установки с клиента на сервер WDS.

  • Используйте функцию WdsCliInitializeLog , чтобы инициализировать журнал для сеанса клиента WDS.
  • Используйте функцию WdsCliLog для записи сообщений о событиях в журнал сервера WDS.
  • В Windows Server 2008 сервер WDS записывает события клиента в журнал событий конкретного приложения, который можно просмотреть через eventvwr.exe а также в журнал трассировки отладки. В Windows Server 2003 с включенным ведением журнала отладки сервер WDS будет записывать события клиента в файл журнала, расположенный по адресу %windir%\tracing\wdsserver.log. Для записи этих событий на сервере должно быть включено ведение журнала клиента WDS.

Сведения об API служб развертывания Windows

Использование API сервера служб развертывания Windows