Créer une image de système d’exploitation d’usine

Ce labo explique comment utiliser le Kit système Windows (WSK) pour concevoir et créer une image de système d’exploitation d’usine.

Nous allons aborder les points suivants :

• Utilisation à partir d’une iso WSK montée
• Ajout de pilotes
• Ajout d’applications
• Ajout d’un dossier de contenu de test
• Personnalisation de la disposition de l’appareil
• Personnalisation des paramètres
• Génération d’une image

1. Ce dont vous avez besoin

Pour effectuer ce labo, vous avez besoin des éléments suivants :

• Un PC technicien
• Kit système Windows
• Si vous créez un FFU :
  • Un appareil d’ingénierie pour lequel vous créez une image
  • Pilotes pour votre appareil d’ingénierie. Assurez-vous que vos pilotes sont conformes à Windows-Core.
• Si vous créez une image VHDX :
  • Un PC avec Hyper-V installé. Il peut s’agir du même PC que le PC de technicien.
• Un dossier qui inclut la documentation de test
• (Facultatif) Applications à inclure dans votre image
• (Facultatif) Pilotes à inclure dans votre image

2. Montez l’ISO WSK et lancez l’environnement WSK

Pour créer des images de système d’exploitation d’usine, vous avez besoin de WSK, qui contient les packages et les outils dont vous avez besoin pour créer une image. Vous pouvez utiliser WSK en copiant le contenu de l’iso WSK sur votre PC de technicien ou en montant l’ISO à partir d’un partage réseau ou localement sur votre PC. Dans ce labo, nous allons monter une iso WSK stockée localement et travailler à partir de là.

Monter le WSK

1. Créez un répertoire sur votre PC de technicien appelé C:\WSK et copiez le fichier ISO WSK à partir du lecteur USB collatéral lab dans celui-ci.
2. Dans l’Explorateur de fichiers, accédez à l’iso WSK
3. Cliquez avec le bouton droit sur l’ISO, puis cliquez sur Monter.

Ouvrir l’environnement du Kit système Windows

Ouvrez l’environnement du Kit système Windows :

1. Accédez à la racine du lecteur affecté à l’ISO WSK monté.
2. Cliquez avec le bouton droit sur SetImagGenEnv.cmd et Exécuter en tant qu’administrateur.

Voici ce que vous verrez :

**********************************************************************
** Windows System Kit image generation environment
** Version xxx.xxxxx.1001
**********************************************************************

3. Créer un espace de travail de système d’exploitation de fabrique

Un espace de travail est un répertoire de travail qui permet d’organiser les applications, les pilotes et les autres ressources nécessaires à la création d’une image de système d’exploitation d’usine.

PrepWSKWorkspace C:\FactoryWorkSpace -Product FactoryOS

Notes

Si vous souhaitez créer une machine virtuelle, ajoutez le -vm paramètre à la commande ci-dessus :

PrepWSKWorkspace C:\FactoryWorkSpace -Product FactoryOS -VM

Pour connaître toutes les options disponibles, consultez Syntaxe PrepWSKWorkspace .

Voici ce que vous verrez dans l’environnement WSK :

Overwrite == Prompt. PrepOEMWorkspace will prompt for permission to overwrite an existing workspace.
Prepping C:\FactoryWorkSpace as a WSK workspace for building a FactoryOS AMD64 UEFI Hardware image....
OEMInput file C:\FactoryWorkSpace\FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.xml created.

Success!

Conformément à C:\FactoryWorkspace la sortie ci-dessus, vous disposez maintenant d’un espace de travail dans qui inclut un fichier OEMInput.xml appelé FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.xml. Vous allez modifier ce fichier OEMInput.xml tout au long du labo. Vous pouvez également afficher le chemin d’accès et le nom de fichier de votre OEMInput.xml en exécutant echo %OEMInputFileName% à partir de l’environnement WSK.

Lors de la création de votre espace de travail, WSK a configuré la %WSKWorkspaceRoot% variable d’environnement qui est mappée à votre espace de travail. Si vous fermez et rouvrez l’environnement du Kit système Windows, vous devez le définir WSKWorkspaceRoot à nouveau en remplaçant les répertoires à la racine de votre espace de travail et en exécutant SetWSKWorkspaceRoot.

4. À propos des manifestes de fonctionnalité

Les manifestes de fonctionnalité définissent les emplacements des fichiers pour les applications, les pilotes et les packages que vous souhaitez inclure dans vos images. Lorsque vous ajoutez des applications et des pilotes, par défaut, ils sont ajoutés à toutes les images, sauf si vous les marquez comme facultatifs.

Les sections suivantes utilisent des manifestes de fonctionnalités pour définir les applications, les pilotes et les paramètres que vous incluez dans votre image.

5. Ajouter des pilotes

Si vous créez une image FFU pour un appareil physique, le Kit système Windows inclut des scripts qui facilitent l’ajout de pilotes compatibles à vos images de système d’exploitation d’usine. Ces scripts créent ou mettent à jour automatiquement un fichier manifeste de fonctionnalité en fonction des pilotes que vous ajoutez à un espace de travail :

• Le CreateWSKDriversFM script crée un manifeste de fonctionnalité de pilote et ajoute tous les pilotes du %WSKWorkspaceRoot%\DCHUDrivers dossier dans le manifeste de fonctionnalité de pilote.

• Le UpdateWSKDriversFM script ajoute toutes les rivières du %WSKWorkspaceRoot%\DCHUDrivers dossier dans un manifeste de fonctionnalité de pilote existant. Étant donné qu’un espace de travail inclut un driversFM vide, nous allons utiliser UpdateWSKDriversFM pour ajouter vos pilotes au manifeste de fonctionnalité de pilote existant. Si vous décidez d’ajouter d’autres pilotes ultérieurement, vous pouvez ajouter des pilotes supplémentaires dans votre dossier DCHUDrivers et réexécuter ce script.

1. Copiez les pilotes dans votre espace de travail :

   xcopy /s E:\Drivers\ %WSKWorkspaceRoot%\DCHUDrivers /chrkyf
   

   Où E:\Drivers\ est l’emplacement où vous avez vos pilotes conformes au système d’exploitation d’usine

2. Ajoutez vos pilotes au manifeste de fonctionnalité de pilote dans votre espace de travail. Un manifeste %WSKWorkspaceRoot\FMFiles\OEMDriversFM.xml de fonctionnalité de pilote vide a été créé et ajouté à votre OEMInput.xml lorsque vous avez créé votre espace de travail. WSK inclut un script qui ajoute tous les pilotes du %WSKWorkspaceRoot%\DCHUDrivers dossier dans le manifeste de la fonctionnalité de pilote. Une fois les pilotes ajoutés au manifeste de fonctionnalité OEMDriversFM, ils sont inclus dans votre image.

   Exécutez le script pour ajouter des pilotes à partir du dossier pilotes DCHU dans votre espace de travail :

   UpdateWSKDriversFM
   

   Sortie :

   Script will backup then append new Drivers to C:\FactoryWorkspace\FMFiles\OEMDriversFM.xml if it exists.
   Existing Drivers FM found. Backing up existing file to C:\Users\username\AppData\Local\Temp\WSKScriptBackups\OEMDriversFM.xml...
   
   Searching C:\FactoryWorkspace\DCHUDrivers for Drivers to add to C:\FactoryWorkspace\FMFiles\OEMDriversFM.xml...
   Adding C:\FactoryWorkspace\DCHUDrivers\devices.driver.display.inf to FM...
   …
   Adding C:\FactoryWorkspace\DCHUDrivers\audio.driver.inf to FM...
   
   FM file successfully created at C:\FactoryWorkspace\FMFiles\OEMDriversFM.xml.
   All newly found Drivers under C:\FactoryWorkspace\DCHUDrivers are now unconditionally in any image that includes C:\FactoryWorkspace\FMFiles\OEMDriversFM.xml.
   Remember to make apps or drivers you do not want in every image "Optional" (apps) or in a FM Feature (drivers).
   
   The previous version of C:\FactoryWorkspace\FMFiles\OEMDriversFM.xml is backed up at C:\Users\username\AppData\Local\Temp\WSKScriptBackups\OEMDriversFM.xml.
   

3. Ouvrez votre fichier OEMInput.xml dans un éditeur de texte et vérifiez que OEMDriversFM.xml est inclus dans l’élément <AdditionalFMs> . Cela garantit que les pilotes définis dans votre OEMDriversFM.xml seront inclus dans votre image. Si vous ne vous souvenez pas du nom de votre fichier OEMInput.xml, vous pouvez exécuter echo %WSKOEMInputFileName% pour voir le chemin d’accès à votre OEMInput.xml.

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

6. Ajouter des applications

Le Kit système Windows comprend des scripts qui facilitent l’ajout d’applications compatibles à vos images de système d’exploitation d’usine. Ces scripts créent ou mettent automatiquement à jour un fichier manifeste de fonctionnalité en fonction des applications que vous ajoutez à un espace de travail :

• Le CreateWSKAppsFM script crée un manifeste d’application et ajoute toutes les applications du %WSKWorkspaceRoot%\Apps dossier dans le manifeste de fonctionnalité de l’application.

• Le UpdateWSKAppsFM script ajoute toutes les applications du %WSKWorkspaceRoot%\Apps dossier dans un manifeste de fonctionnalité d’application existant. Étant donné qu’un espace de travail inclut un appsFM vide, nous allons utiliser UpdateWSKAppsFM pour ajouter de nouvelles applications au manifeste de fonctionnalité d’application existant qui est inclus par défaut dans votre OEMInput.xml.

Si vous avez des applications que vous souhaitez ajouter à votre image :

1. Copiez des applications dans votre espace de travail :

   Xcopy /s E:\UWP %WSKWorkspaceRoot%\Apps /chrkyf
   

   Où E:\UWP est l’emplacement à partir duquel vous copiez vos applications UWP

2. Ajoutez vos applications à partir du Apps dossier au manifeste de fonctionnalité OEMAppsFM.xml . Une fois les applications ajoutées au manifeste de fonctionnalité OEMAppsFM, elles sont incluses dans votre image :

   UpdateWSKAppsFM
   

   Voici un exemple de sortie :

   Script will backup then append new Apps to C:\FactoryWorkSpace\FMFiles\OEMAppsFM.xml if it exists.
   Existing Apps FM found. Backing up existing file to C:\Users\administrator\AppData\Local\Temp\WSKScriptBackups\OEMAppsFM_3.xml...
   
   Searching C:\FactoryWorkSpace\Apps for Apps to add to C:\FactoryWorkSpace\FMFiles\OEMAppsFM.xml...
   Adding C:\FactoryWorkSpace\Apps\Dependencies\arm\Microsoft.NET.Native.Framework.1.7.appx to FM...
   Adding C:\FactoryWorkSpace\Apps\Dependencies\arm\Microsoft.NET.Native.Runtime.1.7.appx to FM...
   Adding C:\FactoryWorkSpace\Apps\Dependencies\arm\Microsoft.VCLibs.Arm.14.00.appx to FM...
   Adding C:\FactoryWorkSpace\Apps\Dependencies\x64\Microsoft.NET.Native.Framework.1.7.appx to FM...
   Adding C:\FactoryWorkSpace\Apps\Dependencies\x64\Microsoft.NET.Native.Runtime.1.7.appx to FM...
   Adding C:\FactoryWorkSpace\Apps\Dependencies\x64\Microsoft.VCLibs.x64.14.00.appx to FM...
   Adding C:\FactoryWorkSpace\Apps\Dependencies\x86\Microsoft.NET.Native.Framework.1.7.appx to FM...
   Adding C:\FactoryWorkSpace\Apps\Dependencies\x86\Microsoft.NET.Native.Runtime.1.7.appx to FM...
   Adding C:\FactoryWorkSpace\Apps\Dependencies\x86\Microsoft.VCLibs.x86.14.00.appx to FM...
   Adding C:\FactoryWorkSpace\Apps\HelloWorld_1.0.0.0_x64.appx to FM...
   
   FM file successfully created at C:\FactoryWorkSpace\FMFiles\OEMAppsFM.xml.
   All newly found Apps under C:\FactoryWorkSpace\Apps are now unconditionally in any image that includes C:\FactoryWorkSpace\FMFiles\OEMAppsFM.xml.
   Remember to make apps or drivers you do not want in every image "Optional" (apps) or in a FM Feature (drivers).
   
   The previous version of C:\FactoryWorkSpace\FMFiles\OEMAppsFM.xml is backed up at C:\Users\administrator\AppData\Local\Temp\WSKScriptBackups\OEMAppsFM_3.xml.
   

3. Ouvrez votre fichier OEMInput.xml et vérifiez que OEMAppsFM.xml est inclus dans l’élément <AdditionalFMs> . Cela garantit que les applications définies dans votre OEMAppsFM.xml seront incluses dans votre image.

   Ce qui suit doit s’afficher :

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

   Notes

   Si vous avez ajouté l’option -VM lorsque vous avez créé votre espace de travail, votre OEMInput.xml sera appelée FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.xml.

7. Ajouter un dossier de contenu de test

L’élément <TestContent> d’un fichier OEMInput.xml vous permet de spécifier un dossier qui inclut du contenu de test, comme des scripts, des exécutables et d’autres ressources que vous utiliserez pour exécuter des tests sur votre appareil de système d’exploitation d’usine.

L’ajout d’un dossier de contenu de test lors de la création de votre image garantit que la documentation de test est disponible sur vos appareils de système d’exploitation d’usine et réduit le temps passé à copier manuellement des fichiers d’un PC technicien vers un appareil de test.

1. Créez un dossier de contenu de test dans votre espace de travail De système d’exploitation d’usine sur votre PC de technicien :

   md %WSKWorkspaceRoot%\TestContent
   

2. Copiez votre documentation de test dans le dossier TestContent. Un seul dossier de contenu de test peut être inclus dans une image, mais ce dossier peut contenir des sous-dossiers. Faites en sorte que tous vos documents de test se situent dans un seul dossier de contenu de test :

   xcopy /s E:\TestContent %WSKWorkspaceRoot$\TestContent /chrkyf
   

   Où E:\TestContent est le dossier avec votre contenu de test

3. Ajoutez votre dossier de contenu de test à votre fichier OEMInput.xml. WSK inclut un script qui automatise ce processus :

   AddTestContent %WSKWorkspaceRoot%\TestContent
   

   Voici ce que vous verrez si le dossier a été correctement ajouté à votre OEMInput.xml :

   Successfully saved the TestContent path in the OEMInput file.
   

4. Ouvrez votre fichier OEMInput.xml et vérifiez qu’il contient un <TestContent> élément, et que l’élément affiche le chemin d’accès à votre dossier de contenu de test :

   Notes

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

   Voici à quoi doit ressembler votre <TestContent> élément :

   <TestContent>C:\FactoryWorkspace\TestContent</TestContent>
   

8. DeviceLayout et ciblage de l’appareil

Notes

Si vous créez une machine virtuelle, vous pouvez ignorer cette section et passer à la section suivante, où nous expliquons comment personnaliser les paramètres.

Personnaliser DeviceLayout

Une disposition d’appareil est le blueprint de la configuration de disque d’un appareil de système d’exploitation d’usine. Il décrit comment le contenu Microsoft, OEM et SV fonctionne ensemble pour créer une disposition de disque pour une image de système d’exploitation d’usine. Les dispositions d’appareil sont configurées à l’aide d’un fichier XML et du Kit système Windows pour générer un package de disposition d’appareil spécifique à votre appareil.

1. Ouvrez %WSKWorkspaceRoot%\OEMCustomization\DeviceLayout\DeviceLayoutOEM.xml dans un éditeur de texte. Ce fichier vous permet de configurer les caractéristiques du disque que vous utilisez.

   • Ajoutez un <DevicePath> pour avec <Store> .<ID> {5a585bae-900b-41b5-b736-a4cecffc34b4} C’est là que le système d’exploitation sera flashé. Ce disque de système d’exploitation aura des partitions configurées par Microsoft.
     • Exemple de disque dur <DevicePath> - <DevicePath>PciRoot(0x0)/Pci(0x1D,0x0)/Pci(0x0,0x0)/NVMe(0x1,00-00-00-00-00-00-00-00)</DevicePath>
     • Exemple d’UFS <DevicePath> - <DevicePath>PciRoot(0x0)/Pci(0x12,0x5)/UFS(0x0,0x0)</DevicePath>
   • Pour les disques durs, mettez à jour tous les GUID dans le chemin d’accès de l’appareil pour utiliser des caractères génériques (?), par exemple <DevicePath>PciRoot(0x0)/Pci(0x1D,0x0)/Pci(0x0,0x0)/NVMe(0x1,??-??-??-??-??-??-??-??)</DevicePath>
   • Vérifiez que correspond <SectorSize> à votre appareil.

   Voici à quoi ressemble un exemple DeviceLayoutOEM :

   <OEMDeviceLayout xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.microsoft.com/embedded/2004/10/ImageUpdate/v2">
       <Stores>
           <Store>
               <Id>{5a585bae-900b-41b5-b736-a4cecffc34b4}</Id>
               <StoreType>Default</StoreType>
   			<DevicePath>PciRoot(0x0)/Pci(0x1D,0x0)/Pci(0x0,0x0)/NVMe(0x1,??-??-??-??-??-??-??-??)</DevicePath>
           </Store>
       </Stores>
       <SectorSize>512</SectorSize>
       <MergeVersionTag>1</MergeVersionTag>
   </OEMDeviceLayout>
   

2. Enregistrez et fermez DeviceLayoutOEM.xml.

3. Mettez à jour OEMInput afin qu’il utilise le fichier de disposition que vous avez créé :

   1. Ouvrez votre fichier OEMinput.xml à la racine de votre espace de travail dans un éditeur de texte.
   2. Mettez à jour l’élément <DeviceLayoutType> sur GPT_SPACES_SPLIT

   <DeviceLayoutType>GPT_SPACES_SPLIT</DeviceLayoutType>
   

   3. Enregistrez votre fichier OEMInput.xml. Vous pouvez le laisser ouvert, car nous y apporterons d’autres modifications dans la section suivante.

Personnaliser le ciblage de l’appareil

1. Si vous ne l’avez pas encore ouvert, ouvrez votre fichier OEMInput.xml dans un éditeur de texte. Vous pouvez le trouver à l’adresse %WSKWorkspaceRoot%\FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.xml.

   Notes

   Vous pouvez exécuter echo %WSKOEMInputFileName à partir de l’environnement WSK pour voir le chemin et le nom de fichier de votre fichier OEMInput.xml.

2. Configurez l’élément <DevicePlatformIDs> , par exemple :

   <DevicePlatformIDs>
   <DevicePlatformID>Contoso.ContosoLaptop.*.1</DevicePlatformID>
   <DevicePlatformID>*.*.*.*</DevicePlatformID>
   </DevicePlatformIDs>
   

3. Enregistrez et fermez votre fichier OEMInput.xml.

9. Personnaliser les paramètres

Lors de la conception d’une image de système d’exploitation d’usine, vous pouvez utiliser l’infrastructure de personnalisation des paramètres pour vous assurer que les paramètres de votre appareil sont correctement configurés.

Les paramètres sont configurés dans les fichiers XML, qui sont utilisés pour créer des packages de personnalisation que vous ajoutez dans un fichier OEMInput. Les paramètres étant spécifiques au produit, veillez à utiliser les fichiers de personnalisation des paramètres qui s’appliquent au produit d’appareil que vous créez.

1. Créez un XML de personnalisation des paramètres vide :

   CreateWSKCustomizationsXML
   

   Sortie :

   Creating output folder: C:\FactoryWorkSpace\OEMCustomization\CustomizationXML
   Created output folder: C:\FactoryWorkSpace\OEMCustomization\CustomizationXML
   …
   wcosimageprep INFO ThreadId1340 Generating WCOS customization file(s)...
   wcosimageprep INFO ThreadId1340 Writing customization files to disk...
   wcosimageprep INFO ThreadId1340 CustomizationXML generation parameters: Advanced=False, Categorize=False
   wcosimageprep INFO ThreadId1340 C:\FactoryWorkSpace\OEMCustomization\CustomizationXML\CustomizationXML.xml
   wcosimageprep INFO ThreadId1340 Time elapsed 00:00:00.4587755
   CustomizationXML file(s) has been generated successfully at C:\FactoryWorkSpace\OEMCustomization\CustomizationXML.
   

2. Ouvrez le fichier XML de personnalisation des paramètres dans un éditeur de texte.

   notepad C:\FactoryWorkSpace\OEMCustomization\CustomizationXML\CustomizationXML.xml
   

3. Renseignez les <Identity> attributs, par exemple :

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

4. Pour cette partie du labo, nous allons définir :

   • Si vous créez un FFU, le chemin d’accès à la disposition de votre appareil
   • Numéro de version affiché sur l’écran du système d’exploitation d’usine, ainsi que dans Factory Orchestrator

   Dans votre CustomizationXML, renseignez les <Value> éléments des paramètres que vous souhaitez personnaliser. Les paramètres suivants nous permettent de configurer le chemin d’accès à la disposition d’appareil personnalisée, ainsi que l’élément de barre favori :

   Renseignez les <Value> éléments des paramètres que vous souhaitez personnaliser. Pour ce labo :

   Nom de la personnalisation	Valeur
   OEMVersion	<Value>1.1.1.1</Value>
   SplitLayoutFile	<Value>C:\FactoryWorkspace\OEMCustomization\DeviceLayout\DeviceLayoutOEM.xml</Value>

   Notes

   Vous n’avez pas besoin de configurer SplitLayoutFile si vous créez une image de machine virtuelle.

   Par exemple :

   <Customization Name="SplitLayoutFile">
       <ReadOnlyMetadata Description="OEM/SV-owned split layout file. (File must be named DeviceLayoutOEM.xml)" Type="FILE" DefaultValue="" SupportedExtensions="xml" />
       <Value>C:\FactoryWorkspace\OEMCustomization\DeviceLayout\DeviceLayoutOEM.xml</Value>
   </Customization>
   

   Consultez Paramètres disponibles pour le système d’exploitation d’usine pour afficher les paramètres disponibles pour le produit du système d’exploitation d’usine.

5. Enregistrez et fermez CustomizationXML.xml.

6. Utilisez les scripts du Kit système Windows pour générer un package de personnalisation OEM et l’ajouter à votre fichier OEMInput.xml.

   CreateWSKCustomizationsFM
   

   Sortie :

   wcosimageprep INFO ThreadId21660 Validating arguments for external action.
   wcosimageprep INFO ThreadId21660 Assigning defaults for external action.
   wcosimageprep INFO ThreadId21660 Generating WCOS customization packages from C:\FactoryWorkspace\OEMCustomization\CustomizationXML
   …
   Customization Packages have been generated successfully at C:\FactoryWorkspace\OEMCustomization\Packages
   …
   OEMCustomizationsFM file has been generated successfully at C:\FactoryWorkspace\FMFiles\OEMCustomizationsFM.xml
   
   C:\FactoryWorkspace\FMFiles\OEMCustomizationsFM.xml has been added to the OEMInput file under the AdditionalFms element
   

10. Créer votre image

Exécutez BuildWSKImage pour créer un FFU basé sur votre fichier OEMInput.xml.

BuildWSKImage %WSKWorkspaceRoot%\FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.xml

Ou, si vous créez une machine virtuelle :

BuildWSKImage %WSKWorkspaceRoot%\FactoryOS_Development_AMD64_UEFI_SpacesGPT_VM.xml

Important

Si vous essayez de générer une image dans le dossier de destination qui inclut déjà un . Images FFU ou disques durs virtuels portant le même nom, la création de l’image échoue avec l’erreur suivante :

imageapp : ERROR : ThreadId18164 OutputFile C:\FactoryOS.Output\FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.ffu already exists.

Avant de générer une image, assurez-vous que votre dossier de sortie ne contient pas déjà une image générée du même nom.

11. Flasher votre image

Votre image de système d’exploitation d’usine personnalisée est générée et prête à l’emploi.

• Si vous avez créé un FFU, vous pouvez flasher votre image sur votre appareil à l’aide de l’une des options de flashage disponibles avec WSK.

• Si vous avez créé un VHDX, vous pouvez utiliser Hyper-V pour démarrer votre nouvelle image.

12. Facultatif Ajouter un pilote à une image

Sur les appareils d’ingénierie, vous pouvez ajouter un pilote à un FFU existant sans avoir à reconstruire l’image à l’aide de ImageApp.exe, qui est inclus dans le Kit système Windows.

Ajouter un pilote à un FFU :

ImageApp.exe C:\FactoryWorkspace.Output\FactoryOS_Development_AMD64_UEFI_SpacesGPT_Hardware.ffu /patch /drivers:E:\OfflineDriver\ /CPUType:amd64

Où E:\OfflineDriver\ est le dossier qui inclut l’exemple de pilote (driver-test.inf) que vous souhaitez ajouter à votre image.

Pour plus d’informations et d’autres utilisations, consultez Utilisation de l’application /patch .