建立自定義虛擬機圖庫

2025-06-19

Windows 10 Fall Creators Update 和更新版本。

在 Fall Creators Update 中，快速建立功能已擴展功能，包括虛擬機資源庫。

使用自定義映像快速建立 VM 資源庫

雖然有一組由 Microsoft 和其合作夥伴提供的影像，但圖庫也可以列出您自己的影像。

本文詳細資料：

建置與資源庫相容的虛擬機。
建立新的圖庫來源。
將自訂畫廊來源加入至畫廊。

畫廊架構

虛擬機資源庫是 Windows 登錄中定義的一組虛擬機來源的圖形化檢視。每個虛擬機來源都是指向 JSON 檔案的路徑（本機路徑或 URI），該檔案中虛擬機以清單項目形式列出。

您在資源庫中看到的虛擬機清單是第一個來源的完整內容，後面接著第二個來源的內容等等，直到列出所有可用的虛擬機為止。每次開啟畫廊時，都會動態建立清單。

畫廊建築

登入機碼： Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization

值名稱：GalleryLocations

類型: REG_MULTI_SZ

建立範本庫相容的虛擬機器

資源庫中的虛擬機可以是磁碟映像（.iso）或虛擬硬碟（.vhdx）。

從虛擬硬碟建立的虛擬機有一些設定需求：

建置以支援 UEFI 韌體。如果他們是使用 Hyper-V 建立的，那就是第 2 代 VM。
虛擬硬碟至少應為 20GB - 請記住，這是大小上限。 Hyper-V 不會佔用 VM 未主動使用的空間。

測試新的 VM 映像

虛擬機資源庫會使用與從本機安裝來源安裝相同的機制來建立虛擬機。

若要驗證虛擬機映像將會開機並執行：

開啟 VM 資源庫（Hyper-V 快速建立），然後選取 [ 本機安裝來源]。
選取 [變更安裝來源]。
挑選將在資源庫中使用的 .iso 或 .vhdx。
如果映像是Linux映像，請取消選取 [安全開機] 選項。
建立虛擬機。如果虛擬機正常開機，便已可用於圖庫。

建置新的圖片庫來源

下一個步驟是建立新的圖庫來源。這是列出虛擬機的 JSON 檔案，並新增您在資源庫中看到的所有額外資訊。

文字資訊：

標記的圖庫文字位置

name - 必要 - 這是出現在左側欄位以及虛擬機器檢視的頂端的名稱。
publisher - 必要
description - 必要 - 描述 VM 的字串清單。
version - 必要
lastUpdated - 預設為 0001 年 1 月 1 日星期一。

格式應該是：yyyy-mm-ddThh：mm：ssZ

下列 PowerShell 命令會以適當的格式提供今天的日期，並將其放在剪貼簿上：
```
Get-Date -UFormat "%Y-%m-%dT%TZ" | clip.exe
```
locale - 預設為空白。

圖片：

標示的相簿圖片位置

標誌 - 必要
象徵
縮圖

當然，您的虛擬機（.iso 或 .vhdx）。

若要產生哈希，您可以使用下列 powershell 命令：

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

下列 JSON 範本包含入門項目和畫廊的結構。如果您在 VSCode 中編輯它，它會自動提供 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":  ""
            }
        }
    ]
}

將您的圖片庫連接至 VM 圖片庫 UI

將自定義資源庫來源新增至 VM 資源庫的最簡單方式，是將其新增至 regedit。

開啟 regedit.exe
導航到 Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization\
尋找 GalleryLocations 項目。

如果已經存在，請移至 [ 編輯 ] 功能表並修改。

如果不存在，請移至 [ 編輯 ] 功能表，流覽 [ 新增至 多字串值]
將圖庫新增至 GalleryLocations 登錄機碼。

故障排除

檢查載入畫廊時是否有錯誤

虛擬機資源庫會在 Windows 事件查看器中提供錯誤報告。若要檢查錯誤：

開啟事件檢視器
流覽至 Windows 記錄 ->應用程式
尋找來自 Source VMCreate 的事件。

資源

GitHub 連結中有幾個畫廊腳本和協助程式。

請參閱範例項目這裡。這是定義內建圖庫的 JSON 檔案。

共用方式為