Partilhar via

Solucionar problemas de modelos de imagem personalizados na Área de Trabalho Virtual do Azure

  • Artigo

Os modelos de imagem personalizados na Área de Trabalho Virtual do Azure permitem que você crie facilmente uma imagem personalizada que pode ser usada ao implantar máquinas virtuais (VMs) de host de sessão. Este artigo ajuda a solucionar alguns problemas que você pode encontrar.

Solução de problemas gerais ao criar uma imagem

O Azure Image Builder usa o Hashicorp Packer para criar imagens. O Packer envia todas as entradas de log para um arquivo chamado customization.log. Por padrão, esse arquivo está localizado em um grupo de recursos que o Azure Image Builder criou automaticamente com a convenção IT_<ResourceGroupName>_<TemplateName>_<GUID>de nomenclatura. Você pode substituir essa nomenclatura especificando seu próprio nome na fase de criação do modelo.

Neste grupo de recursos está uma conta de armazenamento com um contêiner de blob chamado packerlogs. No contêiner há uma pasta nomeada com um GUID na qual você encontrará o arquivo de log. As entradas para scripts internos que você usa para personalizar sua imagem começam Iniciando a personalização do AVD AIB: {Nome do script}: {Timestamp}, para ajudá-lo a localizar quaisquer erros relacionados aos scripts.

Para saber como interpretar os logs do Azure Image Builder, consulte Solucionar problemas do Azure VM Image Builder.

Importante

O Suporte da Microsoft não lida com problemas de scripts criados por clientes ou quaisquer scripts ou modelos copiados de um repositório da Microsoft e modificados. Você é bem-vindo para colaborar e melhorar essas ferramentas em nosso repositório GitHub, onde você pode abrir um problema. Para obter mais informações, consulte Por que não oferecemos suporte a scripts de clientes ou de terceiros?

O grupo de recursos deve estar vazio

Se você especificar seu próprio grupo de recursos para o Azure Image Builder usar, ele precisará estar vazio antes que a compilação da imagem seja iniciada. Isso significa que, se você quiser reutilizar um grupo de recursos existente para essa finalidade, precisará apenas excluir todos os recursos dentro dele. Como alternativa, se você precisar manter esses itens, poderá especificar outro novo grupo de recursos na guia de propriedades de compilação da criação do modelo.

O script não está disponível

Se vir a mensagem O URI> do recurso <não está disponível. Verifique se o arquivo existe e se o Image Builder pode acessá-lo, verifique o URI (Uniform Resource Identifier) do seu script. Este precisa ser um local disponível publicamente, como o GitHub ou um serviço Web.

Se vir a mensagem Falha na validação: Erro com a validação da versão do Hyper-V (não há suporte para geração cruzada para várias versões do Hyper-V). O SIG: <ID> de Recursos fornecido tem uma versão> de Geração <do Hyper-V diferente da versão> da imagem <de origem, certifique-se de que a geração da imagem de origem é a mesma que a geração especificada para a definição de imagem da VM da Galeria de Computação do Azure.

A geração da imagem de origem é mostrada quando você seleciona a imagem que deseja usar. Você pode verificar a geração da definição de imagem da VM no portal do Azure, na CLI do Azure usando o comando az sig image-definition list reference ou no PowerShell usando o cmdlet Get-AzGalleryImageDefinition .

A Diretiva de Rede PrivateLinkService não está desabilitada para uma determinada sub-rede

Se você receber a mensagem de erro iniciando que a diretiva de rede PrivateLinkService não está desabilitada para a sub-rede fornecida, será necessário desabilitar a diretiva de serviço privado na sub-rede. Para obter mais informações, consulte Desabilitar a política de serviço privado na sub-rede.

Problemas ao instalar ou ativar idiomas adicionais em imagens do Windows 10

Idiomas adicionais podem ser adicionados por modelos de imagem personalizados, que usam o cmdlet Install-Language PowerShell. Se você tiver problemas para instalar ou habilitar idiomas adicionais em imagens de várias sessões do Windows 10 Enterprise e do Windows 10 Enterprise, certifique-se de que:

  • Não desativou a instalação de pacotes de idiomas por política de grupo na sua imagem. A definição de política pode ser encontrada nos seguintes locais:

    • Configuração do>Computador Modelos Administrativos>Painel de Controle Opções>>Regionais e de Idioma Restringir Pacote de Idiomas e Instalação de Recursos de Idioma

    • Configuração do>Usuário Modelos Administrativos>Painel de Controle Opções>>Regionais e de Idioma Restringir Pacote de Idiomas e Instalação de Recurso de Idioma

  • Os anfitriões de sessão podem ligar-se ao Windows Update para transferir idiomas e atualizações cumulativas mais recentes.

Não é possível progredir a partir da guia da imagem de origem no portal do Azure

Quando cria um modelo de imagem personalizado no portal do Azure, poderá não conseguir progredir a partir do separador Imagem de origem se selecionar a Galeria de Computação do Azure como o tipo de Origem. Um vermelho X aparece ao lado do nome da guia. Como solução alternativa, selecione Anterior para retornar à guia Noções básicas e, em seguida, selecione Avançar para retornar à guia Imagem de origem. Agora você deve ser capaz de progredir para a próxima guia e uma marca de seleção verde aparece ao lado do nome da guia.

Ocorreu um erro de autorização durante a operação dos Grupos de Contentores do Azure

Os modelos de imagem personalizados requerem o fornecedor de recursos registado Microsoft.ContainerInstance na sua subscrição devido à dependência do Azure Image Builder. Se você receber o erro The client '<GUID>' with object id '<GUID>' does not have authorization to perform action 'Microsoft.ContainerInstance/register/action' over scope '/subscriptions/<subscription ID>' or the scope is invalid, você precisa registrar o Microsoft.ContainerInstance provedor de recursos em sua assinatura. Depois de registrar o provedor de recursos, tente a ação novamente. Para obter informações sobre como verificar o status de registro e como registrá-los, se necessário, consulte Provedores e tipos de recursos do Azure.