Créer une galerie de machines virtuelles personnalisées

Windows 10 Fall Creators Update et versions ultérieures.

Dans Fall Creators Update, création rapide développée pour inclure une galerie de machines virtuelles.

Bien qu’il existe un ensemble d’images fournies par les partenaires Microsoft et Microsoft, la galerie peut également répertorier vos propres images.

Cet article décrit les détails suivants :

• création de machines virtuelles compatibles avec la galerie.
• création d’une source de galerie.
• ajout de votre source de galerie personnalisée à la galerie.

Architecture de la galerie

La galerie de machines virtuelles est un affichage graphique pour un ensemble de sources de machines virtuelles définies dans le Registre Windows. Chaque source de machine virtuelle est un chemin d’accès (chemin local ou URI) vers un fichier JSON avec des machines virtuelles en tant qu’éléments de liste.

La liste des machines virtuelles que vous voyez dans la galerie est le contenu complet de la première source, suivi du contenu de la deuxième source, ainsi de suite jusqu’à ce que toutes les machines virtuelles disponibles aient été répertoriées. La liste est créée dynamiquement chaque fois que vous lancez la galerie.

Clé de Registre : Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization

Nom de la valeur : GalleryLocations

Entrez : REG_MULTI_SZ

Créer des machines virtuelles compatibles avec la galerie

Les machines virtuelles de la galerie peuvent être une image disque (.iso) ou un disque dur virtuel (.vhdx).

Les machines virtuelles effectuées à partir d’un disque dur virtuel ont quelques exigences de configuration :

1. Conçu pour prendre en charge le microprogramme UEFI. S’ils sont créés à l’aide d’Hyper-V, il s’agit d’une machine virtuelle de génération 2.
2. Le disque dur virtuel doit être d’au moins 20 Go . N’oubliez pas que c’est la taille maximale. Hyper-V ne prend pas l’espace que la machine virtuelle n’utilise pas activement.

Test d’une nouvelle image de machine virtuelle

La galerie de machines virtuelles crée des machines virtuelles à l’aide du même mécanisme que l’installation à partir d’une source d’installation locale.

Pour valider une image de machine virtuelle, démarrez et exécutez :

1. Ouvrez la galerie de machines virtuelles (Hyper-V Création rapide) et sélectionnez Source d’installation locale.
2. Sélectionnez Modifier la source d’installation.
3. Sélectionnez le .iso ou .vhdx qui sera utilisé dans la galerie.
4. Si l’image est une image Linux, désélectionnez l’option Démarrage sécurisé.
5. Créez une machine virtuelle. Si la machine virtuelle démarre correctement, elle est prête pour la galerie.

Créer une nouvelle source de galerie

L’étape suivante consiste à créer une source de galerie. Il s’agit du fichier JSON qui répertorie vos machines virtuelles et ajoute toutes les informations supplémentaires que vous voyez dans la galerie.

Informations textuelles :

• nom - obligatoire - il s’agit du nom qui apparaît dans la colonne de gauche et également en haut de la vue de la machine virtuelle.

• publisher - obligatoire

• description - obligatoire - Liste des chaînes qui décrivent la machine virtuelle.

• version - obligatoire

• lastUpdated : la valeur par défaut est lundi 1er janvier 0001.

  Le format doit être : aaaa-mm-ddThh :mm :ssZ

  La commande PowerShell suivante fournit la date d’aujourd’hui dans le format approprié et la place dans le Presse-papiers :

  Get-Date -UFormat "%Y-%m-%dT%TZ" | clip.exe
  

• paramètres régionaux : valeur par défaut vide.

Photos:

• logo - obligatoire
• symbole
• miniature

Et bien sûr, votre machine virtuelle (.iso ou .vhdx).

Pour générer les hachages, vous pouvez utiliser la commande PowerShell suivante :

Get-FileHash -Path .\TMLogo.jpg -Algorithm SHA256

Le modèle JSON ci-dessous contient des éléments de démarrage et le schéma de la galerie. Si vous la modifiez dans VSCode, elle fournit automatiquement IntelliSense.

{
    "$schema": "https://raw.githubusercontent.com/MicrosoftDocs/Virtualization-Documentation/live/hyperv-tools/vmgallery/vm-gallery-schema.json",

    "images": [
        {
            "name":  "",
            "version":  "",
            "locale":  "",
            "publisher":  "",
            "lastUpdated":  "",
            "description":  [
                ""
            ],
            "disk":  {
                "uri":  "",
                "hash":  ""
            },
            "logo":  {
                "uri":  "",
                "hash":  ""
            },
            "symbol":  {
                "uri":  "",
                "hash":  ""
            },
            "thumbnail":  {
                "uri":  "",
                "hash":  ""
            }
        }
    ]
}

Connecter votre galerie à l’interface utilisateur de la galerie de machines virtuelles

Le moyen le plus simple d’ajouter votre source de galerie personnalisée à la galerie de machines virtuelles consiste à l’ajouter dans regedit.

1. Ouvrir regedit.exe

2. Accédez à Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization\

3. Recherchez l’élément GalleryLocations .

   S’il existe déjà, accédez au menu Modifier et modifiez.

   S’il n’existe pas encore, accédez au menu Modifier, accédez à New to Multi-String Value

4. Ajoutez votre galerie à la clé de GalleryLocations Registre.

   

Résolution des problèmes

Rechercher les erreurs de chargement de la galerie

La galerie de machines virtuelles fournit des rapports d’erreurs dans l’Observateur d’événements Windows. Pour rechercher les erreurs :

1. Ouvrez l’observateur d’événements
2. Accéder aux journaux Windows ->Application
3. Recherchez les événements de la source VMCreate.

Ressources

Il existe une poignée de scripts de galerie et d’assistance dans le lien GitHub.

Consultez un exemple d’entrée de galerie ici. Il s’agit du fichier JSON qui définit la galerie intégrée.