針對 Azure 虛擬桌面中的自訂映像範本進行疑難排解

透過 Azure 虛擬桌面中的自訂映像範本，您可輕鬆建立用於部署工作階段主機虛擬機器 (VM) 的自訂映像。 本文可協助您針對您可能會遇到的一些問題進行疑難解答。

建立映像時的一般疑難排解

Azure Image Builder 會使用 Hashicorp Packer 來建立映像。 Packer 會將所有記錄項目輸出至名為 customization.log 的檔案。 根據預設，此檔案位於 Azure Image Builder 使用命名慣例 IT_<ResourceGroupName>_<TemplateName>_<GUID>自動建立的資源群組中。 您可以在範本建立階段中指定您自己的名稱，以覆寫此命名。

在此資源群組中的儲存體帳戶包含一個名為 packerlogs 的 Blob 容器。 容器中是名為 的資料夾，其中包含您找到記錄檔的 GUID。 您用來自定義映像的內建腳本專案， Starting AVD AIB Customization: {<Script name>}: {<Timestamp>}可協助您找出與腳本相關的任何錯誤。

如需如何解譯 Azure Image Builder 記錄的詳細資訊，請參閱 針對 Azure VM 映射產生器進行疑難解答。

重要

Microsoft 支援服務 不會處理任何客戶建立的腳本，或從Microsoft存放庫複製並修改的任何腳本或範本的問題。 歡迎您在我們的 GitHub 存放庫中共同作業和改善這些工具，您可以在其中提出問題。 如需詳細資訊，請參閱 為什麼我們不支持客戶或第三方腳本？

資源群組必須是空的

如果您指定自己的資源群組供 Azure Image Builder 使用，則映像建置開始之前，它必須是空的。 這表示如果您想要針對此目的重複使用現有的資源群組，您只需要刪除其中的所有資源。 或者，如果您需要保留這些專案，您可以在範本建立的 [建置屬性] 索引標籤上指定另一個新的資源群組。

指令碼無法使用

若您看見此訊息：

資源 <URI> 無法使用。 請檢查檔案是否存在，而且 Image Builder 可以存取它。

檢查文本的統一資源標識碼 （URI）。 這必須是公開可用的位置，例如 GitHub 或 Web 服務。

Azure Compute Gallery VM 映像定義世代不相符

若您看見此訊息：

驗證失敗：Hyper-V 版本驗證發生錯誤（不支援多個 Hyper-V 版本的跨世代）。 提供的 SIG：<資源識別碼>與來源映像<版本>>不同<。

請確定來源映像的產生與您為 Azure 計算資源庫 VM 映像定義指定的世代相同。

當您選取要使用的映像時，來源映像的世代就會隨之顯示。 您可以在 Azure 入口網站、Azure CLI (使用 az sig image-definition list 參考命令)，或 PowerShell (使用 Get-AzGalleryImageDefinition Cmdlet) 中，確認 VM 映像定義的世代。

指定的子網不會停用 PrivateLinkService 網路原則

如果您收到錯誤訊息，指出「指定的子網未停用 PrivateLinkService 網路原則」，您必須停用子網上的私人服務原則。 如需詳細資訊，請參閱在子網路上停用私人服務原則。

在 Windows 10 映射上安裝或啟用其他語言的問題

您可以使用 Install-Language PowerShell Cmdlet 的自定義映射範本來新增其他語言。 如果您在 Windows 10 企業版 和 Windows 10 企業版 多工作階段映像上安裝或啟用其他語言時遇到問題，請確定：

• 您未在映像上透過群組原則停用安裝語言套件。 您可以在下列位置中找到原則設定：

  • 電腦設定>系統管理範本>控制台>區域和語言選像>限制語言套件和語言功能安裝

  • 使用者設定>系統管理範本>控制台>區域和語言選項>限制語言套件和語言功能安裝

• 您的工作階段主機可以連線到 Windows Update，以下載語言和最新的累積更新。

無法從 Azure 入口網站中的 [來源映像] 索引標籤取得進展

在 Azure 入口網站中建立自訂映像範本時，如果您選取 [Azure Compute Gallery] 作為 [來源類型]，則可能無法從 [來源映像] 索引標籤取得進展。 索引標籤名稱旁會出現紅色 X 。 因應措施是，選取 [上一步 ] 傳回 [基本] 索引 卷標，然後選取 [下一步 ] 傳回 [來源影像] 索引卷標。您現在應該能夠繼續進行下一個索引標籤，而索引標籤旁邊會出現綠色複選標記。

Azure 容器群組作業期間發生授權錯誤

自定義映像範本需要 Microsoft.ContainerInstance 訂用帳戶上註冊的資源提供者，因為相依於 Azure Image Builder。 如果您收到錯誤：

對象標識符為 'GUID' 的用戶端 '<<GUID>>' 在範圍 '/subscriptions/subscription ID>' 上沒有執行動作 'Microsoft.ContainerInstance/register/<action' 的授權，或範圍無效。

您必須在訂用 Microsoft.ContainerInstance 帳戶上註冊資源提供者。 註冊資源提供者之後，請再試一次該動作。 如需如何檢查其註冊狀態以及如何視需要註冊的詳細資訊，請參閱 Azure 資源提供者和類型。