Partager via


Personnalisation de Validation OS en utilisant Validation OS Image Builder

Vous pouvez ajouter des packages de pilotes et des packages de personnalisation Validation OS pour vous assurer que Validation OS peut démarrer et prendre en charge les applications pour vos scénarios. Vous pouvez utiliser des packages de personnalisation pour ajouter la prise en charge de plusieurs fonctionnalités à la demande couvertes plus loin dans le document.

Validation OS n’est pas livré avec des pilotes inclus, vous devrez donc vous assurer d’ajouter des pilotes avant de pouvoir appliquer votre image à votre PC.

Procédure générale

Le processus global pour créer une image Validation OS en utilisant Validation OS Image Builder est le suivant :

  1. Montez le fichier ISO de Validation OS à un emplacement spécifique sur le système de fichiers du PC technicien.

  2. Démarrez le ValidationOSImageBuilder.exe approprié en fonction de l’architecture native du PC technicien (x64 ou arm64).

  3. Suivez les étapes dans Validation OS ImageBuilder

    1. [Facultatif] Sélectionnez l’emplacement de l’image Validation OS générée.

    2. [Facultatif] Ajoutez les pilotes à l’image Validation OS montée.

    3. [Facultatif] Ajoutez une ou plusieurs fonctionnalités à la demande souhaitées.

    4. [Facultatif] Définissez/remplacez les clés de registre dans l’image Validation OS.

    5. [Facultatif] Incluez des binaires/applications personnalisés dans l’image Validation OS.

    6. [Facultatif] Créez une solution Visual Studio avec des références au SDK correspondant à l’image Validation OS générée.

Commencer avec Validation OS Image Builder

Validation OS Image Builder est un outil GUI qui vous permet de générer facilement une image Validation OS personnalisée pour votre scénario spécifique. Il vous permet d’ajouter

  • des packages optionnels tels que Audio, Bluetooth, Camera, Multimedia, USB, etc.
  • des pilotes pour votre matériel spécifique
  • d’autres applications logicielles que vous souhaitez inclure dans l’image Validation OS
  • des clés de registre que vous souhaitez activer dans l’image Validation OS au démarrage
  • des commandes de démarrage que vous souhaitez exécuter au démarrage de l’OS

Il vous permet également de générer un SDK qui peut être utilisé pour l’image Validation OS spécifique en cours de génération.

La liste des packages de fonctionnalités optionnels disponibles se trouve ici : Packages de fonctionnalités

Utilisation de Validation OS Image Builder

Ce qui suit est un guide étape par étape de l’utilisation de Validation OS Image Builder à partir du package ISO Validation OS.

  1. Montez le package ISO Validation OS et naviguez jusqu’au dossier <ISO_ROOT>:\ImageBuilder<ISO_ROOT>: est le lecteur où l’ISO a été monté.

  2. Exécutez ValidationOSImageBuilder.exe pour démarrer Validation OS Image Builder et acceptez l’invite vous demandant d’exécuter le programme avec les privilèges administrateur.

  3. Cliquez sur « Démarrage » pour aller à l’écran des fonctionnalités.

  4. Dans l’écran des fonctionnalités, sélectionnez les fonctionnalités que vous souhaitez ajouter à l’image Validation OS et cliquez sur Suivant pour accéder à l’écran des pilotes (voir la liste des fonctionnalités disponibles dans la section ci-dessus).

  5. Dans l’écran optionnel des pilotes, sélectionnez le dossier où se trouvent les pilotes pour votre appareil.

  6. Dans cet écran, vous pouvez également ajouter facultativement les composants suivants à votre image :

    1. Dossier logiciel optionnel : cela vous permet d’inclure un dossier contenant des fichiers .EXE optionnels qui seront inclus dans l’image Validation OS.

    2. Fichier de registre : cela vous permet de télécharger un fichier .REG contenant des entrées de registre qui seront incluses dans l’image Validation OS au démarrage.

    3. Commandes de démarrage : cela vous permet d’ajouter un fichier .EXE à l’image Validation OS qui sera exécuté au démarrage.

  7. Cliquez sur Suivant pour accéder à l’écran de sortie.

  8. Dans l’écran de sortie, vous pouvez

    1. choisir le dossier où le fichier WIM de sortie et les autres composants seront générés (par défaut est C:\ValidationOS)

    2. spécifier si l’image Validation OS (WIM) démarrera à partir d’une clé USB ou d’un disque dur (par défaut est USB)

    3. choisir si Validation OS Image Builder doit générer ou non un SDK associé pour l’image Validation OS personnalisée générée

    4. enregistrer les paramètres de Validation OS Image Builder les plus récemment utilisés dans un fichier modèle pour une utilisation future

  9. Cliquez sur Suivant pour accéder à l’écran de révision & terminer qui vous montrera toutes les fonctionnalités, pilotes et paramètres de sortie que vous avez choisis une dernière fois.

  10. Cliquez sur Créer pour générer l’image Validation OS.

  11. Une fois l’image Validation OS générée, vous verrez une option pour naviguer vers le dossier de sortie où vous verrez le nouveau fichier ValidationOS.wim.

Remarque

ValidationOS-2.wim est également généré dans le dossier GenImageOutput. C’est une image optimisée contenant uniquement la partition pertinente pour le type de démarrage que vous avez sélectionné dans l’écran des pilotes.

Utilisation de la ligne de commande Validation OS Image Builder

Toutes les fonctionnalités disponibles dans l’interface utilisateur de Validation OS Image Builder sont également disponibles via la ligne de commande Validation OS Image Builder. Pour utiliser la ligne de commande Validation OS Image Builder, naviguez jusqu’au dossier <ISO_ROOT>:\IBCLI<ISO_ROOT>: est le lecteur où l’ISO a été monté.

L’utilitaire de ligne de commande Validation OS Image Builder s’appelle ValidationOSImageBuilderCLI.exe.

Voici une liste des options de ligne de commande disponibles :

-l, --list List all features included in the ISO

-i, --info <info> Get the description of a specific feature

-rp, --resolve <resolve> List all packages included by a set of features

-f, --features <features> Specify features to include

-d, --drivers <drivers> Specify the driver folder path

-s, --software <software> Specify the software folder path

-r, --registry <registry> Specify the registry file path

-sc, --startup-command <startup-command> Specify the startup command file path

-o, --output <output> Specify the output folder path

-sdk, --generate-sdk Generate SDK solution

-st, --save-template Save settings to a template

-g, --generate-image Trigger image generation

-api, --generate-api Generate API Surface from features

-lt, --load-template <load-template> Load a template file

-bt, --boottype <boottype> Specify the boot type (USB/InternalDisk).
        Default is USB

--version Show version information

-?, -h, --help Show help and usage information

Des exemples de la façon d’utiliser les options de ligne de commande sont affichés lorsque vous exécutez ValidationOSImageBuilderCLI -h

Utilisation du SDK généré

Pour utiliser le SDK généré, vous devez avoir Microsoft Visual Studio installé sur votre ordinateur.

Dans l’Explorateur, naviguez jusqu’au dossier de sortie (qui est généralement nommé C:\ValdationOS<Date-Time of image creation>) où vous verrez un dossier nommé sdk. Dans ce dossier, vous verrez un fichier .sln. Double-cliquez sur ce fichier pour l’ouvrir dans Visual Studio.

Dans la vue Solution Explorer dans Visual Studio, vous verrez un fichier .cpp. Vous pouvez modifier ce fichier avec votre code ou ajouter vos propres fichiers de code à ce projet. Pour voir les packages Nuget auxquels votre projet fait référence, vous pouvez faire un clic droit sur References dans la vue Solution Explorer et sélectionner Manage Nuget Packages

Pour construire la solution, sélectionnez Build dans le menu principal et sélectionnez Build Solution ce qui générera le fichier .exe à partir de ce code pour votre image Validation OS personnalisée.

Utilisation d’APIValidator avec apisurface.xml

Avec l’image ValidationOS.wim, l’Image Builder génère également un fichier apisurface.xml dans le dossier api. Ce fichier contient une liste de référence de toutes les fonctions API que l’image ValidationOS.wim personnalisée prend en charge.

Vous pouvez utiliser un outil appelé APIValidator.exe avec n’importe quel fichier .exe et ce fichier apisurface.xml comme entrées pour déterminer s’il existe des incompatibilités entre votre fichier .exe et votre image ValidationOS.wim personnalisée.

Pour installer APIValidator.exe, veuillez vous référer aux instructions dans le fichier <ISO_ROOT>:\SDK\ValidationOS_System_Kit-APIValidator_Usage.txt. Vous devrez d’abord installer WDK. Une fois installé, une commande typique pour analyser un fichier .exe par rapport au fichier de surface API ressemblera à ceci :

Apivalidator.exe -BinaryPath:"<Path to .exe file>" -SupportedApiXmlFiles:"<Path to apisurface.xml file>"

Dans la sortie, vous verrez une liste d’erreurs, le cas échéant, ainsi que des détails sur les dépendances incompatibles.

Exemples de SDK Validation OS Image Builder

Vous pouvez voir des exemples de code qui utilisent les différentes fonctionnalités fournies avec Validation OS Image Builder ici : https://github.com/microsoft/validation-OS