Fichier de configuration d’image (ou OEMInput)

Article
06/19/2023

Le fichier de configuration d’image (ou OEMInput) est un fichier XML qui définit les packages et les personnalisations qui entrent dans la conception d’une image, y compris la configuration du matériel et du lecteur, le produit du système d’exploitation d’usine, les langues et les fonctionnalités, applications, pilotes et packages spécifiques au produit qui sont inclus.

Lorsque vous générez une image, le processus de génération d’image génère une image à l’aide de packages qui correspondent aux valeurs et attributs que vous avez configurés dans OEMInput.xml. La configuration de certains éléments OEMInput, tels que les langages et le produit, ajoute des packages du Kit système Windows (WSK) directement dans votre image sans configuration supplémentaire. Vous pouvez également configurer et ajouter des manifestes de fonctionnalités qui définissent des emplacements de package supplémentaires et activent des fonctionnalités, des applications, des pilotes et des paramètres supplémentaires.

Montre que le manifeste de fonctionnalité peut être ajouté à un fichier de configuration d’image pour ajouter des fonctionnalités. Une fois qu’un fichier de configuration d’image est personnalisé, une image est générée à l’aide de la documentation de wSK et de l’espace de travail OEM.

EMPLACEMENT OEMInput

Lorsque vous préparez un espace de travail, vous obtenez un fichier de configuration d’image de départ à la racine du répertoire de l’espace de travail préconfiguré avec des informations sur l’appareil, des manifestes de fonctionnalités, des fonctionnalités et des applications pour le produit que vous avez choisi. Recherchez un fichier avec le schéma d’affectation de noms suivant dans le répertoire de l’espace de travail : <Product>_<architecture>_<boottype>_<hardware or VM>_<imagetype>.xml

Vous pouvez obtenir le chemin d’accès et le nom de fichier de votre fichier OEMInput.xml en exécutant echo %WSKOEMInputFileName% à partir de l’environnement WSK.

Description du schéma

Voici un fichier OEMInput.xml vide. Cette section décrit l’objectif et l’utilisation de chaque élément.

<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>

Description

Description de l’image et architecture de l’image. L’architecture (AMD64, x86) doit se trouver dans ce champ. Si l’architecture ne se trouve pas dans ce champ, cela peut entraîner l’échec de la build.

Exemple :

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

DeviceLayoutType

Définit les propriétés de disposition de disque pour l’image.

Options	Description
GPT	Utilisez pour les appareils UEFI et les machines virtuelles Hyper-V de génération 2.
GPT_SPACES_512	Utilisez pour les appareils UEFI et les machines virtuelles Hyper-V de génération 2 avec la disposition des espaces. Lorsque vous créez des exemples de fichiers avec PrepWSKWorkspace, il s’agit de la valeur par défaut.
GPT_SPACES_4096	Utilisez pour les appareils UEFI et les machines virtuelles Hyper-V de génération 2 avec la disposition des espaces qui utilisent des disques de secteur 4 096.
GPT_SPACES_SPLIT	Utilisez lorsque vous utilisez une disposition d’appareil fractionné.

Exemple :

<DeviceLayoutType>GPT_SPACES_512</DeviceLayoutType>

Appareil

Définit si l’image est destinée aux appareils UEFI.

Options	Description
GenericUEFIDevice	Utilisez pour les appareils UEFI et les machines virtuelles Hyper-V de génération 2. Lorsque vous créez des exemples de fichiers avec PrepWSKWorkspace, il s’agit de la valeur par défaut.

Exemple :

<Device>GenericUEFIDevice</Device>

ReleaseType

Détermine si les applications de test, les pilotes et d’autres packages peuvent être utilisés.

Options	Description
Test	Utilisez ceci pour identifier une image en tant qu’image de test. Il y aura moins de restrictions d’imagerie sur ce type d’image.

<ReleaseType>Test</ReleaseType>

BuildType

Spécifie d’utiliser une build de production.

Options	Description
Fre	Il s’agit de la valeur par défaut. Ne changez pas cette valeur.

Exemple :

<BuildType>fre</BuildType>

Languages

Spécifie les langues disponibles dans une image.

Les langues sont spécifiées dans les <Language> éléments.
La langue par défaut est spécifiée à l’aide de l’attribut Default d’une langue. Vous devez spécifier une langue par défaut. Spécifiez une seule langue par défaut.

Pour plus d’informations sur l’ajout de langues, consultez Ajouter des langues .

Exemple (en-us défini comme valeur par défaut) :

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

Modules supplémentaires

Répertorie les manifestes de fonctionnalités utilisés dans la conception de votre appareil. Les manifestes de fonctionnalités répertorient les applications, les pilotes et les autres composants que vous pouvez ajouter à votre image. Certains d’entre eux sont prédéfinis lorsque vous créez un espace de travail et un ensemble d’exemples de fichiers, par exemple :

Exemple de manifestes de fonctionnalités prédéfinis :

<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>

Fonctionnalités

L’élément <Features> vous permet d’ajouter des fonctionnalités facultatives à votre image.

<Microsoft> élément : ajoutez ou modifiez des fonctionnalités facultatives spécifiques au produit du système d’exploitation d’usine.
- Consultez Système d’exploitation d’usine pour connaître les fonctionnalités disponibles spécifiques au système d’exploitation d’usine.
<OEM> élément : si vous avez défini des pilotes facultatifs, ajoutez-les dans cet élément.

Exemple :

<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

Ajoutez l’ID d’application des applications facultatives à inclure dans l’image.

Exemple :

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

DevicePlatformIDs

Un DevicePlatofrmID est une chaîne composée de valeurs de la structure d’informations système SMBIOS, concaténées avec chaque valeur séparée par un point. Votre fichier OEMInput.xml peut inclure plusieurs DevicePlaformIDs.

Lorsque vous créez un espace de travail, votre fichier OEMInput inclut <DevicePlatformID>Manufacturer.Family.Product.Version</DevicePlatformID>. Mettez à jour la <DevicePlatformID> chaîne pour refléter votre matériel. Pour plus d’informations, consultez DevicePlatformID .

Si votre fichier OEMInput.xml n’inclut pas l’élément <DevicePlatformIDs> , veillez à l’ajouter. Vous ne pourrez pas flasher votre image sur votre matériel si cet élément ne figure pas dans votre fichier OEMInput.xml.

Exemple :

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

Produit

[Le produit définit le manifeste de fonctionnalité de base utilisé dans une image.

Options	Description
Système d’exploitation d’usine	Utiliser pour le système d’exploitation d’usine

Exemple :

<Product>Factory OS</Product>

TestContent

Permet d’ajouter un dossier de test-collatéral aux images. Pour plus d’informations sur l’ajout de contenu de test, consultez Contenu de test.

Exemple :

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

Exemple de fichier de configuration d’image pour une machine virtuelle UEFI AMD64 avec système d’exploitation d’usine avec espaces

<?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>

Partager via

Fichier de configuration d’image (ou OEMInput)

EMPLACEMENT OEMInput

Description du schéma

Description

DeviceLayoutType

Appareil

ReleaseType

BuildType

Languages

Modules supplémentaires

Fonctionnalités

AppXOptionalPackages

DevicePlatformIDs

Produit

TestContent

Exemple de fichier de configuration d’image pour une machine virtuelle UEFI AMD64 avec système d’exploitation d’usine avec espaces

Ressources supplémentaires