Criar uma galeria de máquinas virtuais personalizada

Windows 10 Fall Creators Update e posteriores.

No Fall Creators Update, a Criação Rápida expandiu-se para incluir uma galeria de máquinas virtuais.

Embora haja um conjunto de imagens fornecidas pela Microsoft e parceiros da Microsoft, a galeria também pode listar suas próprias imagens.

Este artigo detalha:

• criando máquinas virtuais compatíveis com a galeria.
• criando uma nova fonte de galeria.
• a adição de sua origem da galeria personalizada à galeria.

Arquitetura da galeria

A galeria de máquinas virtuais é uma exibição gráfica para um conjunto de fontes de máquina virtual definidas no Registro do Windows. Cada fonte de máquina virtual é um caminho (caminho local ou URI) para um arquivo JSON com máquinas virtuais como itens de lista.

A lista de máquinas virtuais que você vê na galeria é o conteúdo completo da primeira fonte, seguido pelo conteúdo da segunda fonte, assim por diante até que todas as máquinas virtuais disponíveis sejam listadas. A lista é criada dinamicamente sempre que você inicia a galeria.

Chave do Registro: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization

Nome do valor: GalleryLocations

Tipo: REG_MULTI_SZ

Criar máquinas virtuais compatíveis com a galeria

As máquinas virtuais na galeria podem ser uma imagem de disco (.iso) ou um disco rígido virtual (.vhdx).

As máquinas virtuais feitas a partir de um disco rígido virtual têm alguns requisitos de configuração:

1. Criado para dar suporte ao firmware UEFI. Se eles forem criados usando o Hyper-V, essa será uma VM de Geração 2.
2. O disco rígido virtual deve ter pelo menos 20 GB - tenha em mente, esse é o tamanho máximo. Hyper-V não ocupará espaço que a VM não está usando ativamente.

Testando uma nova imagem de VM

A galeria de máquinas virtuais cria máquinas virtuais usando o mesmo mecanismo que a instalação de uma fonte de instalação local.

Para validar que uma imagem de máquina virtual inicializará e executará corretamente:

1. Abra a Galeria de VMs (Hyper-V Criação Rápida) e selecione Origem da Instalação Local.
2. Selecione Alterar Fonte de Instalação.
3. Escolha o .iso ou .vhdx que será usado na galeria.
4. Se a imagem for uma imagem do Linux, desmarque a opção Inicialização Segura.
5. Criar Máquina Virtual. Se a máquina virtual for inicializada corretamente, ela estará pronta para a galeria.

Criar uma nova fonte de galeria

A próxima etapa é criar uma nova fonte de galeria. Este é o arquivo JSON que lista suas máquinas virtuais e adiciona todas as informações extras que você vê na galeria.

Informações de texto:

• name - obrigatório - este é o nome que aparece na coluna esquerda e também na parte superior da visualização da máquina virtual.

• publisher – obrigatório

• descrição – obrigatório – Lista de cadeias de caracteres que descrevem a VM.

• versão – obrigatório

• lastUpdated – tem como padrão segunda-feira, 1º de janeiro, 0001.

  O formato deve ser: yyyy-mm-ddThh:mm:ssZ

  O seguinte comando do PowerShell fornecerá a data de hoje no formato apropriado e a colocará na área de transferência:

  Get-Date -UFormat "%Y-%m-%dT%TZ" | clip.exe
  

• localidade – o padrão é ficar em branco.

Fotos:

• logotipo – obrigatório
• símbolo
• miniatura

E, claro, sua máquina virtual (.iso ou .vhdx).

Para gerar os hashes, você pode usar o seguinte comando do PowerShell:

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

O modelo JSON abaixo tem itens de início e o esquema da galeria. Se você editá-lo no VSCode, ele fornecerá automaticamente o 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":  ""
            }
        }
    ]
}

Conectar sua galeria à interface do usuário da Galeria de VMs

A maneira mais fácil de adicionar sua fonte de galeria personalizada à Galeria de VMs é adicioná-la no regedit.

1. Abrir regedit.exe

2. Navegue até Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization\

3. Procure o item GalleryLocations.

   Se ele já existir, vá para o menu Editar e modifique.

   Se ele ainda não existir, vá para o menu Editar, navegue por Novo até Valor de Sequência Múltipla

4. Adicione sua galeria à chave de registro GalleryLocations.

   

Resolução de problemas

Verificar se há erros ao carregar a Galeria

A galeria de máquinas virtuais fornece relatórios de erros no Visualizador de Eventos do Windows. Para verificar se há erros:

1. Abra o Visualizador de Eventos
2. Navegue até Registros do Windows ->Aplicação
3. Procure os eventos de Source VMCreate.

Recursos

Há um punhado de scripts de galeria e auxiliares no GitHub link.

Veja uma entrada de galeria de exemplo aqui. Este é o arquivo JSON que define a galeria in-box.