Archivo de configuración de imagen (o OEMInput)

Artículo
06/19/2023

El archivo de configuración de imagen (o OEMInput) es un archivo XML que define los paquetes y personalizaciones que entran en el diseño de una imagen, incluida la configuración de hardware y unidad, el producto del sistema operativo de fábrica, los idiomas y las características, aplicaciones, controladores y paquetes específicos del producto.

Al generar una imagen, el proceso de generación de imágenes crea una imagen mediante paquetes que se asignan a los valores y atributos que configuró en OEMInput.xml. Al configurar algunos elementos OEMInput, como idiomas y productos, se agregan paquetes del Kit de sistema de Windows (WSK) directamente a la imagen sin necesidad de configuración adicional. También puede configurar y agregar manifiestos de características que definan ubicaciones de paquetes adicionales y habiliten características, aplicaciones, controladores y configuraciones adicionales.

Muestra que el manifiesto de característica se puede agregar a un archivo de configuración de imagen para agregar funcionalidad. Una vez que se personaliza un archivo de configuración de imagen, se crea una imagen mediante el material adjunto del WSK y el área de trabajo oem.

Ubicación de OEMInput

Al preparar un área de trabajo, obtendrá un archivo de configuración de imagen inicial en la raíz del directorio del área de trabajo que está preconfigurado con información del dispositivo, manifiestos de características, características y aplicaciones para el producto que eligió. Busque un archivo con el siguiente esquema de nomenclatura en el directorio del área de trabajo: <Product>_<architecture>_<boottype>_<hardware or VM>_<imagetype>.xml

Puede obtener la ruta de acceso y el nombre de archivo del archivo de OEMInput.xml ejecutando echo %WSKOEMInputFileName% desde el entorno de WSK.

Descripción del esquema

A continuación se muestra un archivo OEMInput.xml vacío. En esta sección se describe el propósito y el uso de cada elemento.

<OEMInput>
  <Description></Description>
  <DeviceLayoutType></DeviceLayoutType>
  <Device></Device>
  <ReleaseType></ReleaseType>
  <BuildType></BuildType>
  <Languages>
    <Language></Language>
  </Languages>
  <AdditionalFMs>
    <AdditionalFM></AdditionalFM>
  </AdditionalFMs>
  <Features>
    <Microsoft>
      <Feature></Feature>
    </Microsoft>
    <OEM>
      <Feature></Feature>
    </OEM>
  </Features>
  <AppXOptionalPackages>
    <AppXID></AppXID>
  </AppXOptionalPackages>
  <DevicePlatformIDs>
    <DevicePlatformID></DevicePlatformID>
  </DevicePlatformIDs>
  <Product></Product>
  <TestContent></TestContent>
  <UserInstallableFeatures>
      <Feature></Feature>
  </UserInstallableFeatures>
</OEMInput>

Descripción

Descripción de la imagen y arquitectura de la imagen. La arquitectura (AMD64, x86) debe estar en este campo. Si el architecure no está en este campo, puede provocar un error en la compilación.

Ejemplo:

<Description>Factory OS Hardware Validation image. UEFI Hardware OEMInput for AMD64</Description>

DeviceLayoutType

Define las propiedades de diseño de disco para la imagen.

Opciones	Descripción
GPT	Se usa para dispositivos basados en UEFI y máquinas virtuales de Hyper-V Generation 2.
GPT_SPACES_512	Se usa para dispositivos basados en UEFI y máquinas virtuales de Hyper-V Generation 2 con el diseño de espacios. Al crear nuevos archivos de ejemplo con PrepWSKWorkspace, este es el valor predeterminado.
GPT_SPACES_4096	Se usa para dispositivos basados en UEFI y máquinas virtuales de Hyper-V Generation 2 con el diseño de espacios que usan discos de sector 4096.
GPT_SPACES_SPLIT	Úselo cuando use un diseño de dispositivo dividido.

Ejemplo:

<DeviceLayoutType>GPT_SPACES_512</DeviceLayoutType>

Dispositivo

Define si la imagen es para dispositivos basados en UEFI.

Opciones	Descripción
GenericUEFIDevice	Se usa para dispositivos basados en UEFI y máquinas virtuales de Hyper-V Generation 2. Al crear nuevos archivos de ejemplo con PrepWSKWorkspace, este es el valor predeterminado.

Ejemplo:

<Device>GenericUEFIDevice</Device>

ReleaseType

Determina si se pueden usar aplicaciones de prueba, controladores y otros paquetes.

Opciones	Descripción
Prueba	Úselo para identificar una imagen como una imagen de prueba, habrá menos restricciones de creación de imágenes en este tipo de imagen.

<ReleaseType>Test</ReleaseType>

BuildType

Especifica el uso de una compilación de producción.

Opciones	Descripción
Fre	Este es el valor predeterminado. No cambie este valor.

Ejemplo:

<BuildType>fre</BuildType>

Idiomas

Especifica qué idiomas están disponibles en una imagen.

Los idiomas se especifican en los <Language> elementos .
El idioma predeterminado se especifica mediante el Default atributo para un idioma. Debe especificar un idioma como predeterminado. Especifique solo un idioma predeterminado.

Consulte Agregar idiomas para obtener información sobre cómo agregar idiomas.

Ejemplo (en-us establecido como predeterminado):

<Languages>
    <Language Default="true">en-us</Language>
    <Language>zh-cn</Language>
</Languages>

AdditionalFMs

Enumera los manifiestos de características usados en el diseño del dispositivo. Los manifiestos de características enumeran las aplicaciones, los controladores y otros componentes que puede agregar a la imagen. Algunas de ellas están predefinidas al crear un área de trabajo y un conjunto de archivos de ejemplo, por ejemplo:

Ejemplo de manifiestos de características predefinidos:

<AdditionalFMs> 
    <!-- You MUST include GenericDeviceFM.xml and FOSNonProductionFM.xml! -->
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\WindowsCoreProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\FOSNonProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\WindowsCoreNonProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\GenericDeviceFM.xml</AdditionalFM>
    <!-- Add OEM FMs here. -->
    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml</AdditionalFM>
    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml</AdditionalFM>
</AdditionalFMs>

Características

El <Features> elemento permite agregar características opcionales a la imagen.

<Microsoft> elemento: agregue o modifique características opcionales específicas del producto del sistema operativo de fábrica.
- Consulte Factory OS para ver las características disponibles específicas del sistema operativo factory.
<OEM> element: si ha definido controladores opcionales, agréguelos en este elemento.

Ejemplo:

<Features>
    <Microsoft>
        <Feature>WCOS_EVENTLOG_SERVICE</Feature>        
        <Feature>WCOS_PNP_RUNTIMEDEVICEINSTALL</Feature>
        <Feature>FONTSIZE_15</Feature>
        <Feature>DEVICEPORTAL_OPTIONAL_MONITORCONFIG</Feature>
        <Feature>SERVICING_STACK</Feature>
        <Feature>ALLOW_CONNECTEDSTANDBY</Feature>
        <Feature>MICROSOFT_EDGE</Feature>
        <Feature>OEM_IMAGE</Feature>
        <Feature>SHELL_BOOT</Feature>
        <Feature>DEVSHELL_MFG</Feature>
        <Feature>MANUFACTURING_TOOLS</Feature>
        <Feature>STATESEPARATION_ON</Feature>
        <Feature>TESTSIGNING_ON</Feature>
        <Feature>ENABLE_WOW</Feature>
        <Feature>WCOS_DEVICEPORTAL</Feature>
        <Feature>WCOS_DEVICEPORTAL_WOW</Feature>
        <Feature>WCOS_POWERSHELLCORE</Feature>
        <Feature>FACTORY_ORCHESTRATOR_SERVICE</Feature>
        <Feature>STORAGESPACES_LAYOUT</Feature>
        <Feature>KDNETUSB_ON</Feature>
    </Microsoft>
    <OEM>
        <Feature>OEMDriver</Feature>
    </OEM>
</Features>

AppXOptionalPackages

Agregue el identificador de aplicación de las aplicaciones opcionales que se incluirán en la imagen.

Ejemplo:

<AppXOptionalPackages>
    <AppXID>Microsoft.WindowsCalculator_8wekyb3d8bbwe</AppXID>
    <AppXID>Microsoft.FactoryTestFrameworkUWP_8wekyb3d8bbwe</AppXID>
</AppXOptionalPackages>

DevicePlatformIDs

Un DevicePlatofrmID es una cadena que consta de valores de la estructura de información del sistema SMBIOS, concatenada junto con cada valor separado por un punto. El archivo OEMInput.xml puede incluir varios DevicePlaformIDs.

Al crear un área de trabajo, el archivo OEMInput incluirá <DevicePlatformID>Manufacturer.Family.Product.Version</DevicePlatformID>. Actualice la cadena para reflejar el <DevicePlatformID> hardware. Consulte DevicePlatformID para obtener más información.

Si el archivo OEMInput.xml no incluye el <DevicePlatformIDs> elemento , asegúrese de agregarlo. No podrá flashear la imagen en el hardware si este elemento no está en el archivo OEMInput.xml.

Ejemplo:

<DevicePlatformIDs>
    <DevicePlatformID>Manufacturer.FamilyName.ProductName.ProductVersion</DevicePlatformID>
    <DevicePlatformID>Contoso.Laptops.ContosoBook.V1</DevicePlatformID>
    <DevicePlatformID>Contoso.ContosoLaptop.*.1</DevicePlatformID>
</DevicePlatformIDs>

Producto

[Product define el manifiesto de característica principal que se usa en una imagen.

Opciones	Descripción
Sistema operativo de fábrica	Uso para el sistema operativo Factory

Ejemplo:

<Product>Factory OS</Product>

TestContent

Se usa para agregar una carpeta de material adjunto de prueba a las imágenes. Consulte Contenido de prueba para obtener información sobre cómo agregar contenido de prueba.

Ejemplo:

<TestContent>%WSKWorkspaceRoot%\TestContent</TestContent>

Archivo de configuración de imagen de ejemplo para una máquina virtual UEFI de OS AMD64 habilitada para espacios

<?xml version="1.0" encoding="utf-8"?>
<OEMInput xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/embedded/2019/06/ImageUpdate">
  <Description>FactoryOS Test en-us image. VM2 OEMInput for VMGen2 on amd64</Description>
  <DeviceLayoutType>GPT_SPACES_512</DeviceLayoutType>
  <Device>GenericUEFIDevice</Device>
  <ReleaseType>Test</ReleaseType>
  <BuildType>fre</BuildType>
  <Languages>
    <Language Default="true">en-us</Language>
  </Languages>
  <AdditionalFMs> 
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\WindowsCoreProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\WindowsCoreNonProductionFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\MobileDeviceSpaceFM.xml</AdditionalFM>
    <AdditionalFM>%WSKContentRoot%\FMFiles\%WSKImageArchitecture%\FactoryOS\FOSNonProductionFM.xml</AdditionalFM>
    <!-- Add OEM FMs here. -->
    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMAppsFM.xml</AdditionalFM>
    <AdditionalFM>%WSKWorkspaceRoot%\FMFiles\OEMDriversFM.xml</AdditionalFM>
  </AdditionalFMs> 
  <Features>
    <Microsoft>
        <Feature>STATESEPARATION_ON</Feature>
        <Feature>STORAGESPACES_LAYOUT</Feature>
        <Feature>UEFI_VM</Feature>
        <Feature>WCOS_EVENTLOG_SERVICE</Feature>        
        <Feature>FONTSIZE_15</Feature>
        <Feature>DEVICEPORTAL_OPTIONAL_MONITORCONFIG</Feature>
        <Feature>WCOS_STORAGE_CDDVD</Feature>        
        <Feature>WCOS_POWERSHELL</Feature>
        <Feature>TESTSIGNING_ON</Feature>
        <Feature>SHELL_BOOT</Feature>
        <Feature>MANUFACTURING_TOOLS</Feature>
        <Feature>ENABLE_WOW</Feature>
        <Feature>WCOS_DEVICEPORTAL</Feature>
        <Feature>WCOS_DEVICEPORTAL_WOW</Feature>
        <Feature>FACTORY_ORCHESTRATOR_SERVICE</Feature>
        <Feature>MANUFACTURING_POWER_SCHEME</Feature>
        <Feature>MANUFACTURING_MODE_EMPTY_PROFILE</Feature>
        <Feature>RESOLUTION_1080X1920</Feature>
        <Feature>OEM_IMAGE</Feature>
        <Feature>KDNETUSB_ON</Feature>        
        <Feature>WCOS_HYPERV_GUEST_UEFI</Feature>
    </Microsoft>
  </Features>
  <AppXOptionalPackages>
    <AppXID>Microsoft.FactoryTestFrameworkUWP_8wekyb3d8bbwe</AppXID>
  </AppXOptionalPackages>
      <DevicePlatformIDs>
      <DevicePlatformID>*.*.*.**</DevicePlatformID>
    </DevicePlatformIDs>
  <Product>Factory OS</Product>
  <TestContent>%WSKWorkspaceRoot%\TestContent</TestContent>
</OEMInput>

Compartir a través de

Archivo de configuración de imagen (o OEMInput)

Ubicación de OEMInput

Descripción del esquema

Descripción

DeviceLayoutType

Dispositivo

ReleaseType

BuildType

Idiomas

AdditionalFMs

Características

AppXOptionalPackages

DevicePlatformIDs

Producto

TestContent

Archivo de configuración de imagen de ejemplo para una máquina virtual UEFI de OS AMD64 habilitada para espacios

Recursos adicionales