Freigeben über

Problembehandlung für benutzerdefinierte Imagevorlagen in Azure Virtual Desktop

  • Artikel

Mit benutzerdefinierten Imagevorlagen in Azure Virtual Desktop können Sie ganz einfach ein benutzerdefiniertes Image erstellen, das Sie beim Bereitstellen virtueller Sitzungshost-Computer (VMs) verwenden können. In diesem Artikel werden einige Probleme behoben, die möglicherweise auftreten.

Allgemeine Problembehandlung beim Erstellen eines Images

Azure Image Builder verwendet Hashicorp Packer zum Erstellen von Images. Packer gibt alle Protokolleinträge in eine Datei namens customization.log aus. Diese Datei befindet sich standardmäßig in einer Ressourcengruppe, die Azure Image Builder automatisch mit der Benennungskonvention IT_<ResourceGroupName>_<TemplateName>_<GUID>erstellt hat. Sie können diese Benennung überschreiben, indem Sie Ihren eigenen Namen in der Erstellungsphase der Vorlage angeben.

In dieser Ressourcengruppe befindet sich ein Speicherkonto mit einem Blobcontainer namens packerlogs. Im Container handelt es sich um einen Ordner mit einer GUID, in dem Sie die Protokolldatei finden. Einträge für integrierte Skripts, die Sie zum Anpassen Des Bildanfangs Starting AVD AIB Customization: {<Script name>}: {<Timestamp>}verwenden, um Fehler im Zusammenhang mit den Skripts zu finden.

Weitere Informationen zum Interpretieren von Azure Image Builder-Protokollen finden Sie unter "Problembehandlung bei Azure VM Image Builder".

Wichtig

Microsoft-Support behandelt keine Probleme für vom Kunden erstellte Skripts oder Skripts oder Vorlagen, die aus einem Microsoft-Repository kopiert und geändert wurden. Sie können gerne zusammenarbeiten und diese Tools in unserem GitHub-Repository verbessern, wo Sie ein Problem öffnen können. Weitere Informationen finden Sie unter Warum unterstützen wir keine Kunden- oder Drittanbieterskripts?

Ressourcengruppe muss leer sein

Wenn Sie Ihre eigene Ressourcengruppe für den zu verwendenden Azure Image Builder angeben, muss sie vor dem Start des Imagebuilds leer sein. Dies bedeutet, dass Sie nur alle darin enthaltenen Ressourcen löschen müssen, wenn Sie eine vorhandene Ressourcengruppe für diesen Zweck wiederverwenden möchten. Wenn Sie diese Elemente beibehalten müssen, können Sie auch eine weitere neue Ressourcengruppe auf der Registerkarte "Buildeigenschaften" der Vorlagenerstellung angeben.

Das Skript ist nicht verfügbar

Möglicherweise wird folgende Meldung angezeigt:

Ressourcen-URI <> ist nicht verfügbar. Überprüfen Sie, ob die Datei vorhanden ist, und dass der Image Builder darauf zugreifen kann.

Überprüfen Sie den URI (Uniform Resource Identifier) für Ihr Skript. Dies muss ein öffentlich verfügbarer Speicherort sein, z. B. GitHub oder ein Webdienst.

Möglicherweise wird folgende Meldung angezeigt:

Fehler bei der Überprüfung: Fehler bei der Hyper-V-Versionsüberprüfung (übergreifende Generation für mehrere Hyper-V-Versionen wird nicht unterstützt). Die bereitgestellte SIG: <Ressourcen-ID> weist eine andere Hyper-V-Generation-Version> <als Quellimageversion <auf>.

Stellen Sie sicher, dass die Generierung Ihres Quellimages mit der Generation übereinstimmt, die Sie für Ihre VM-Imagedefinition des Azure Compute Gallery-VM-Images angegeben haben.

Die Generierung für das Quellimage wird angezeigt, wenn Sie das zu verwendende Bild auswählen. Sie können die Generierung der VM-Imagedefinition im Azure-Portal, der Azure CLI mithilfe des Referenzbefehls az sig image-definition list oder mit PowerShell mithilfe des Cmdlets Get-AzGalleryImageDefinition überprüfen.

PrivateLinkService-Netzwerkrichtlinie ist für das angegebene Subnetz nicht deaktiviert.

Wenn Sie die Fehlermeldung "PrivateLinkService-Netzwerkrichtlinie ist für das angegebene Subnetz nicht deaktiviert" angezeigt wird, müssen Sie die Private Service-Richtlinie im Subnetz deaktivieren. Weitere Informationen finden Sie unter Deaktivieren der Richtlinie für private Dienste im Subnetz.

Probleme beim Installieren oder Aktivieren anderer Sprachen in Windows 10-Images

Andere Sprachen können von benutzerdefinierten Bildvorlagen hinzugefügt werden, die das PowerShell-Cmdlet "Install-Language" verwenden. Wenn Beim Installieren oder Aktivieren anderer Sprachen unter Windows 10 Enterprise- und Windows 10 Enterprise-Multisitzungsimages Probleme auftreten, stellen Sie folgendes sicher:

  • Sie haben die Installation von Sprachpaketen nicht durch Gruppenrichtlinien für Ihr Image deaktiviert. Die Richtlinieneinstellung finden Sie an folgenden Stellen:

    • Computerkonfiguration>Administrative Vorlagen>Systemsteuerung>Regions- und Sprachoptionen>Installation von Sprachpaketen und Sprachfeatures einschränken

    • Benutzerkonfiguration>Administrative Vorlagen>Systemsteuerung>Regions- und Sprachoptionen>Installation von Sprachpaketen und Sprachfeatures einschränken

  • Ihre Sitzungshosts können eine Verbindung mit Windows Update herstellen, um Sprachen und die neuesten kumulativen Updates herunterzuladen.

Der Fortschritt auf der Registerkarte „Quellbild“ im Azure-Portal ist nicht möglich.

Wenn Sie eine benutzerdefinierte Bildvorlage im Azure-Portal erstellen, können Sie möglicherweise nicht über die Registerkarte Quellbild fortfahren, wenn Sie die Azure Compute Gallery als Quelltyp auswählen. Ein rotes X wird neben dem Namen der Registerkarte angezeigt. Wählen Sie als Problemumgehung "Zurück " aus , um zur Registerkarte "Grundlagen " zurückzukehren, und wählen Sie dann "Weiter" aus, um zur Registerkarte "Quellbild " zurückzukehren. Sie sollten nun in der Lage sein, zur nächsten Registerkarte zu wechseln, und neben dem Namen der Registerkarte wird ein grünes Häkchen angezeigt.

Autorisierungsfehler während des Azure-Containergruppenvorgangs

Benutzerdefinierte Bildvorlagen erfordern den Ressourcenanbieter, der Microsoft.ContainerInstance aufgrund der Abhängigkeit von Azure Image Builder für Ihr Abonnement registriert ist. Bei Anzeige der Fehlermeldung

Der Client '<GUID>' mit Objekt-ID '<GUID>' verfügt nicht über die Berechtigung zum Ausführen der Aktion "Microsoft.ContainerInstance/register/action" über den Bereich "/subscriptions/<subscription ID>", oder der Bereich ist ungültig.

Sie müssen den Microsoft.ContainerInstance Ressourcenanbieter für Ihr Abonnement registrieren. Nachdem Sie den Ressourcenanbieter registriert haben, wiederholen Sie die Aktion. Weitere Informationen zum Überprüfen des Registrierungsstatus und zur Registrierung bei Bedarf finden Sie unter Azure-Ressourcenanbieter und -Typen.