Rozwiązywanie problemów z szablonami obrazów niestandardowych w usłudze Azure Virtual Desktop

Szablony obrazów niestandardowych w usłudze Azure Virtual Desktop umożliwiają łatwe tworzenie niestandardowego obrazu, którego można użyć podczas wdrażania maszyn wirtualnych hosta sesji. Ten artykuł pomaga rozwiązać niektóre problemy, które mogą wystąpić.

Ogólne rozwiązywanie problemów podczas tworzenia obrazu

Usługa Azure Image Builder używa narzędzia Hashicorp Packer do tworzenia obrazów. Program Packer wyprowadza wszystkie wpisy dziennika do pliku o nazwie customization.log. Domyślnie ten plik znajduje się w grupie zasobów utworzonej automatycznie za pomocą konwencji IT_<ResourceGroupName>_<TemplateName>_<GUID>nazewnictwa utworzonej przez program Azure Image Builder. Tę nazwę można zastąpić, określając własną nazwę w fazie tworzenia szablonu.

W tej grupie zasobów jest konto magazynu z kontenerem obiektów blob o nazwie packerlogs. W kontenerze znajduje się folder o nazwie z identyfikatorem GUID, w którym znajduje się plik dziennika. Wpisy dla wbudowanych skryptów używanych do dostosowywania obrazu zaczynają się Starting AVD AIB Customization: {<Script name>}: {<Timestamp>}, aby ułatwić znajdowanie błędów związanych ze skryptami.

Aby uzyskać więcej informacji na temat interpretowania dzienników programu Azure Image Builder, zobacz Rozwiązywanie problemów z konstruktorem obrazów maszyn wirtualnych platformy Azure.

Ważne

pomoc techniczna firmy Microsoft nie obsługuje problemów dotyczących skryptów utworzonych przez klienta ani skryptów lub szablonów skopiowanych z repozytorium firmy Microsoft i zmodyfikowanych. Zachęcamy do współpracy i ulepszania tych narzędzi w naszym repozytorium GitHub, w którym można otworzyć problem. Aby uzyskać więcej informacji, zobacz Dlaczego nie obsługujemy skryptów klienta ani innych firm?

Grupa zasobów musi być pusta

Jeśli określisz własną grupę zasobów, która ma być używana przez narzędzie Azure Image Builder, musi być pusta przed rozpoczęciem kompilacji obrazu. Oznacza to, że jeśli chcesz ponownie użyć istniejącej grupy zasobów w tym celu, wystarczy usunąć wszystkie zawarte w niej zasoby. Alternatywnie, jeśli chcesz zachować te elementy, możesz określić inną nową grupę zasobów na karcie właściwości kompilacji tworzenia szablonu.

Skrypt jest niedostępny

Jeśli zostanie wyświetlony komunikat:

Identyfikator URI> zasobu <jest niedostępny. Sprawdź, czy plik istnieje i czy narzędzie Image Builder może uzyskać do niego dostęp.

Sprawdź identyfikator URI (Uniform Resource Identifier) dla skryptu. Musi to być publicznie dostępna lokalizacja, taka jak GitHub lub usługa internetowa.

Niezgodność definicji obrazu maszyny wirtualnej z galerii obliczeń platformy Azure

Jeśli zostanie wyświetlony komunikat:

Walidacja nie powiodła się: Błąd podczas walidacji wersji funkcji Hyper-V (generowanie krzyżowe dla wielu wersji funkcji Hyper-V nie jest obsługiwane). Podany sig: <identyfikator zasobu> ma inną wersję> generacji <funkcji Hyper-V niż wersja> obrazu <źródłowego.

Upewnij się, że generacja obrazu źródłowego jest taka sama jak generacja określona dla definicji obrazu maszyny wirtualnej z galerii obliczeń platformy Azure.

Generowanie obrazu źródłowego jest wyświetlane po wybraniu obrazu, którego chcesz użyć. Możesz sprawdzić generowanie definicji obrazu maszyny wirtualnej w witrynie Azure Portal, interfejsie wiersza polecenia platformy Azure przy użyciu polecenia az sig image-definition list reference lub programu PowerShell przy użyciu polecenia cmdlet Get-AzGalleryImageDefinition.

Zasady sieciowe usługi PrivateLinkService nie są wyłączone dla danej podsieci

Jeśli zostanie wyświetlony komunikat o błędzie "Zasady sieciowe usługi PrivateLinkService nie są wyłączone dla danej podsieci", należy wyłączyć zasady usługi prywatnej w podsieci. Aby uzyskać więcej informacji, zobacz Wyłączanie zasad usługi prywatnej w podsieci.

Problemy z instalowaniem lub włączaniem innych języków na obrazach systemu Windows 10

Inne języki można dodawać za pomocą niestandardowych szablonów obrazów, które używają polecenia cmdlet Install-Language programu PowerShell. Jeśli masz problemy z instalowaniem lub włączaniem innych języków w systemach Windows 10 Enterprise i Windows 10 Enterprise z wieloma sesjami, upewnij się, że:

• Nie wyłączono instalowania pakietów językowych według zasad grupy na obrazie. Ustawienie zasad można znaleźć w następujących lokalizacjach:

  • Szablony> administracyjne konfiguracji>komputera Panel sterowania> Opcje regionalne i językowe>ograniczają instalowanie pakietów językowych i funkcji językowych

  • Szablony> administracyjne konfiguracji>użytkownika Panel sterowania> Opcje regionalne i językowe>ograniczają instalowanie pakietów językowych i funkcji językowych

• Hosty sesji mogą łączyć się z usługą Windows Update w celu pobrania języków i najnowszych aktualizacji zbiorczych.

Nie można przejść z karty obrazu źródłowego w witrynie Azure Portal

Podczas tworzenia szablonu obrazu niestandardowego w witrynie Azure Portal możesz nie być w stanie przejść z karty Obraz źródłowy, jeśli wybierzesz galerię obliczeniową platformy Azure jako typ źródła. Obok nazwy karty zostanie wyświetlony czerwony znak X . Aby obejść ten problem, wybierz pozycję Wstecz , aby powrócić do karty Podstawy , a następnie wybierz przycisk Dalej , aby powrócić do karty Obraz źródłowy. Teraz powinien być w stanie przejść do następnej karty, a obok nazwy karty pojawi się zielony znacznik wyboru.

Wystąpił błąd autoryzacji podczas operacji grup kontenerów platformy Azure

Szablony obrazów niestandardowych wymagają dostawcy zasobów zarejestrowanego Microsoft.ContainerInstance w ramach subskrypcji ze względu na zależność od narzędzia Azure Image Builder. Jeśli zostanie wyświetlony błąd:

Klient "<GUID>" o identyfikatorze obiektu "<GUID>" nie ma autoryzacji do wykonania akcji "Microsoft.ContainerInstance/register/action" w zakresie "/subscriptions/subscriptions/<subscription ID>" lub zakres jest nieprawidłowy.

Musisz zarejestrować dostawcę Microsoft.ContainerInstance zasobów w ramach subskrypcji. Po zarejestrowaniu dostawcy zasobów spróbuj ponownie wykonać akcję. Aby uzyskać więcej informacji na temat sprawdzania stanu rejestracji i sposobu ich rejestrowania w razie potrzeby, zobacz Dostawcy zasobów i typy platformy Azure.