Erstellen eines benutzerdefinierten Katalogs für virtuelle Computer

Windows 10 Fall Creators Update und höher.

Im Fall Creators Update wurde "Quick Create" erweitert, um einen Katalog virtueller Computer einzuschließen.

Obwohl es eine Reihe von Bildern gibt, die von Microsoft- und Microsoft-Partnern bereitgestellt werden, kann der Katalog auch Eigene Bilder auflisten.

Dieser Artikel enthält Details:

• Erstellen virtueller Computer, die mit dem Katalog kompatibel sind.
• Erstellen einer neuen Katalogquelle.
• Hinzufügen ihrer benutzerdefinierten Katalogquelle zum Katalog.

Galeriearchitektur

Der Katalog für virtuelle Computer ist eine grafische Ansicht für eine Reihe virtueller Computerquellen, die in der Windows-Registrierung definiert sind. Jede Virtuelle Computerquelle ist ein Pfad (lokaler Pfad oder URI) zu einer JSON-Datei mit virtuellen Computern als Listenelemente.

Die Liste der virtuellen Computer, die sie im Katalog sehen, ist der vollständige Inhalt der ersten Quelle, gefolgt von den Inhalten der zweiten Quelle usw., bis alle verfügbaren virtuellen Computer aufgelistet wurden. Die Liste wird bei jedem Start des Katalogs dynamisch erstellt.

Registrierungsschlüssel: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization

Wertname: GalleryLocations

Typ: REG_MULTI_SZ

Erstellen von katalogkompatiblen virtuellen Computern

Virtuelle Computer im Katalog können entweder ein Datenträgerimage (.iso) oder eine virtuelle Festplatte (VHDX) sein.

Virtuelle Computer, die von einer virtuellen Festplatte hergestellt werden, weisen einige Konfigurationsanforderungen auf:

1. Entwickelt, um die UEFI-Firmware zu unterstützen. Wenn sie mit Hyper-V erstellt werden, handelt es sich um eine VM der Generation 2.
2. Die virtuelle Festplatte sollte mindestens 20 GB groß sein – denken Sie daran, dass dies die maximale Größe ist. Hyper-V nimmt keinen Speicherplatz in Anspruch, den der virtuelle Computer nicht aktiv verwendet.

Testen eines neuen VM-Images

Der Katalog virtueller Computer erstellt virtuelle Computer mit demselben Mechanismus wie die Installation aus einer lokalen Installationsquelle.

So überprüfen Sie, ob ein Image eines virtuellen Computers gestartet und ausgeführt wird:

1. Öffnen Sie den VM-Katalog (Hyper-V Schnellerstellung), und wählen Sie "Lokale Installationsquelle" aus.
2. Wählen Sie " Installationsquelle ändern" aus.
3. Wählen Sie die .iso oder VHDX aus, die im Katalog verwendet werden soll.
4. Wenn es sich bei dem Image um ein Linux-Image handelt, deaktivieren Sie die Option "Sicherer Start".
5. Erstellen Sie einen virtuellen Computer. Wenn der virtuelle Computer ordnungsgemäß gestartet wird, ist er für den Katalog bereit.

Erstellen einer neuen Katalogquelle

Der nächste Schritt besteht darin, eine neue Katalogquelle zu erstellen. Dies ist die JSON-Datei, die Ihre virtuellen Computer auflistet und alle zusätzlichen Informationen hinzufügt, die im Katalog angezeigt werden.

Textinformationen:

• name - required - this is the name that appears in the left column and also at the top of the virtual machine view.

• Herausgeber – erforderlich

• description - required - List of strings that describe the VM.

• Version – erforderlich

• lastUpdated – standardmäßig montags, 1. Januar 0001.

  Das Format sollte sein: jjjj-mm-ddThh:mm:ssZ

  Der folgende PowerShell-Befehl stellt das heutige Datum im richtigen Format bereit und platziert es in der Zwischenablage:

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

• Gebietsschema – ist standardmäßig leer.

Bilder:

• Logo - erforderlich
• Symbol
• Daumennagel

Und natürlich Ihr virtueller Computer (.iso oder VHDX).

Um die Hashes zu generieren, können Sie den folgenden PowerShell-Befehl verwenden:

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

Die folgende JSON-Vorlage enthält Startelemente und das Schema des Katalogs. Wenn Sie sie in VSCode bearbeiten, wird intelliSense automatisch bereitgestellt.

{
    "$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":  ""
            }
        }
    ]
}

Verbinden Des Katalogs mit der BEnutzeroberfläche des VM-Katalogs

Die einfachste Möglichkeit zum Hinzufügen Ihrer benutzerdefinierten Katalogquelle zum VM-Katalog besteht darin, sie in regedit hinzuzufügen.

1. regedit.exe öffnen

2. Navigieren Sie zu Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization\.

3. Suchen Sie nach dem GalleryLocations Element.

   Wenn sie bereits vorhanden ist, wechseln Sie zum Menü "Bearbeiten ", und ändern Sie sie.

   Wenn sie noch nicht vorhanden ist, navigieren Sie zum Menü "Bearbeiten", navigieren Sie durch "Neu" zu "Mehrwert für mehrere Zeichenfolgen".

4. Fügen Sie Ihren Katalog zum GalleryLocations Registrierungsschlüssel hinzu.

   

Problembehandlung

Überprüfen auf Fehler beim Laden des Katalogs

Der Katalog für virtuelle Computer bietet fehlerberichterstattung in der Windows-Ereignisanzeige. So überprüfen Sie auf Fehler:

1. Öffnen Sie die Ereignisanzeige
2. Navigieren sie zu Windows-Protokollen –>Anwendung
3. Suchen Sie nach Ereignissen aus "Source VMCreate".

Ressourcen

Es gibt eine Handvoll Katalogskripts und Hilfsprogramme im GitHub-Link.

Einen Beispielkatalogeintrag finden Sie hier. Dies ist die JSON-Datei, die den Box-Katalog definiert.