Настройка параметров

Статья
07/03/2024

В этом разделе описывается настройка классических параметров для образов операционной системы фабрики. Эти параметры будут включены в образ и будут применяться ко всем устройствам, которые мигают с изображением.

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

Создание файла настройки параметров

CreateWSKCustomizationsXML Используйте скрипт в WSK для создания файла настройки параметров:

Подключите ISO WSK и откройте среду Пакета системных пакетов Windows в качестве администратора:
```
D:\SetWSKImagGenEnv.cmd
```
Задайте рабочую область в качестве корневого каталога рабочей области:
```
cd c:\workspace
SetWSKWorkspaceRoot.cmd
```

Создайте XML-файл настройки:

CreateWSKCustomizationsXML

При необходимости можно создать набор XML-файлов настройки, добавив -categorize этот параметр. Это создает набор XML-файлов настройки, разделенных по категориям:
```
CreateWSKCustomizationsXML -Categorize
```
Кроме того, вы можете вручную разделить XML-файл настройки, если создаваемые XML-файлы настройки не имеют одинаковых <FeatureArea> повторяющихся в нескольких XML-файлах настройки.

CreateWSKCustomizationsXMLиспользует файл конфигурации рабочей области для уменьшения количества обязательных параметров. Доступны следующие необязательные параметры:

Параметры	Параметры
-Классифицировать	Разбивает ПараметрыXML на несколько файлов, один файл для каждой настройки. Если этот параметр не используется, будет создан один большой файл настройки
-OutputFolder	Указывает папку, в которой создается XML-файл настройки.

Примечание.

Этот скрипт перезаписывает любой существующий XML-файл настройки в выходном каталоге. Если у вас есть XML-файл настройки, создайте резервную копию перед выполнением этого скрипта или укажите -OutputFolder другую выходную папку.

После запуска скрипта в рабочей области %WSKWorkspaceRoot%\OEMCustomization\CustomizationXMLбудет один или несколько файлов конфигурации параметров.

Настройка файла настройки параметров

Откройте файл настройки параметров в текстовом редакторе.

Задайте атрибуты в элементе <Identity> :

<Identity OwnerName="OEMName" ReleaseType="Test" />

Атрибут	Description
OwnerName	Имя сущности, создающего изображение
ReleaseType	Это должно соответствовать элементу OEMinput изображения.`ReleaseType` Допустимое значение: `Test`. См. ниже, чтобы узнать, как выбрать правильное значение.

Настройка параметров. Каждый параметр находится в XML-элементе с именем <Customization>. Вот как <Customization> выглядит элемент:
```
<Customization Name="SplitLayoutFile">
  <ReadOnlyMetadata Description="OEM/SV-owned split layout file. (File must be named DeviceLayoutOEM.xml)" Type="FILE" DefaultValue="" SupportedExtensions="xml" />
  <Value />
</Customization>
```
В этом примере показаны различные атрибуты для параметра, охватывающего сведения о параметрах и возможных значениях. Он также имеет пустой элемент с именем <Value>, который будет использоваться для настройки параметра.
Настройте параметр, изменив <Value> элементы параметров, которые необходимо настроить. По завершении сохраните XML-файл.
- Чтобы просмотреть все доступные параметры для вашей фабрики ОС, см . раздел "Доступные параметры" для фабрики ОС.
В приведенном ниже фрагменте кода показан SplitLayoutFile параметр, заполненный путем к пути к файлу DeviceLayoutOEM.xml.
```
<Customization Name="SplitLayoutFile">
  <ReadOnlyMetadata Description="OEM/SV-owned split layout file. (File must be named DeviceLayoutOEM.xml)" Type="FILE" DefaultValue="" SupportedExtensions="xml" />
  <Value>%WSKWorkspaceRoot%\OEMCustomization\DeviceLayout\DeviceLayoutOEM.xml</Value>
</Customization>
```

Создание пакетов настройки параметров и их добавление в файл OEMInput

Примечание.

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

Открытие среды Windows System Kit от имени администратора
Задайте корневой каталог рабочей области:
```
cd c:\workspace
SetWSKWorkspaceRoot.cmd
```

Скрипт CreateWSKCustomizationsFM в WSK создает пакеты параметров и манифест функции настройки параметров, включающий пакеты параметров. Затем скрипт добавляет манифест функции настройки в файл OEMInput. По умолчанию CreateWSKCustomizationsFM все XML-файлы настройки обрабатываются в папке рабочей области %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML .

CreateWSKCustomizationsFM

Примечание.

Эта команда больше не принимает -OEMInput-OEMNameпараметры или -Architecture параметры.

Если вы создали набор файлов настройки категории, используйте -customizationXML этот параметр, чтобы указать папку, в которой сохраняются XML-файлы настройки. Например:
```
CreateWSKCustomizationsFM -customizationXML %WSKWorkspaceRoot%\OEMCustomization\CustomizationXML
```

CreateWSKCustomizationsFMиспользует файл конфигурации рабочей области для уменьшения количества обязательных параметров. С помощью следующих необязательных параметров CreateWSKCustomizationsFMможно использовать следующие:

Параметр	Параметры
-OEMPackagesFolder	Укажите путь к папке, в которой хранятся пакеты настройки. Все пакеты настройки в этой папке будут включены в манифест компонента. Путь по умолчанию — `%WSKWorkspaceRoot%\OEMCustomization\CustomizationXML`.
-Version	Позволяет добавлять номер версии, добавленный к именам пакетов. Формат – `xxxx.y.z.z`. По умолчанию — `1000.0.0.0`.
-FMFile	Позволяет указать путь к файлу манифеста компонента настройки, который определяет пользовательские параметры. Этот FM добавляется в файл OEMInput, чтобы параметры были включены в образ. По умолчанию — `%WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml`.
-CustomizationXML	Путь к файлу или папке CustomizationXML, содержащей файлы настройки. Если указать путь к папке, все параметры настройки xml-файлов будут обработаны и будут выводить один параметр FM. Если этот параметр не указан, используется `%WSKWorkspaceRoot%\OEMCustomization\CustomizationXML.xml`путь по умолчанию.

Убедитесь, что файл OEMCustomizationsFM.xml находится в файле OEMInput. Его можно найти в элементе <AdditionalFMs> :

<AdditionalFMs>
...
  <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml</AdditionalFM>
  <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml</AdditionalFM>
  <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMCustomizationsFM.xml</AdditionalFM>
</AdditionalFMs>

Создайте изображение. При создании образа параметры, настроенные вами, будут заданы в образе.

Примечание.

При тестировании можно добавлять пакеты настройки непосредственно в образы для ускорения итерации. Дополнительные сведения см. в статье "Исправление образа операционной системы фабрики" для тестирования .

Схема файла настройки параметров

Файлы настройки параметров состоят из нескольких элементов, которые классифицируют параметры в различные группы. Параметры в каждой группе связаны. Каждый параметр имеет атрибуты, показывающие, как можно настроить каждый параметр. Чтобы настроить параметр, добавьте значение в <Value> элемент параметра, который требуется настроить.

<?xml version="1.0" encoding="utf-8"?>
<CustomizationFile xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" SchemaVersion="1.0" BuildArch=" " Product=" " BuildInfo=" " xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate">
  <Identity OwnerName="" ReleaseType="" />
  <Categories>
    <Category Name="Default">
      <FeatureAreas>
        <FeatureArea Name="Area1">
          <Customizations>
            <Customization Name="Example1">
              <ReadOnlyMetadata Description="Attributes in this element describe values for configuring this setting" Type="REG_DWORD" DefaultValue="1" Minimum="0" Maximum="1" />
              <Value />
            </Customization>
            <Customization Name="Example2">
              <ReadOnlyMetadata Description="Set the value element to configure settings" Type="REG_SZ" DefaultValue="" />
              <Value />
            </Customization>
          </Customizations>
        </FeatureArea>
      </FeatureAreas>
    </Category>
    <Category Name="Category2">
      <FeatureAreas>
        <FeatureArea Name="Area2">
          <Customizations>
            <Customization Name="Example3">
              <ReadOnlyMetadata Description="Set the value element to configure settings" Type="REG_SZ" DefaultValue="" />
              <Value />
            </Customization>
          </Customizations>
        </FeatureArea>
      </FeatureAreas>
    </Category>
  </Categories>
</CustomizationFile>

Аудит параметров в изображении

При создании образа в выходной папке рабочей области содержится журнал, содержащий сведения о параметрах. Дополнительные сведения см . в WCOSCustomizationReport.xml .

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

Настройка параметров

Создание файла настройки параметров

Настройка файла настройки параметров

Создание пакетов настройки параметров и их добавление в файл OEMInput

Схема файла настройки параметров

Аудит параметров в изображении

Дополнительные ресурсы