Search
StarWind is a hyperconverged (HCI) vendor with focus on Enterprise ROBO, SMB & Edge

Creating Custom Hyper-V Gallery

  • September 13, 2018
  • 10 min read
IT Production Manager. Nicolas is primarily focused on Microsoft technologies, he is a Microsoft MVP in Cloud and Datacenter Management.
IT Production Manager. Nicolas is primarily focused on Microsoft technologies, he is a Microsoft MVP in Cloud and Datacenter Management.

wp-image-9975

Introduction

In Windows 10 Fall Creator Update, Microsoft introduced a new feature called the “Hyper-V Quick Create Wizard” which is very useful because you can create a Virtual Machine with the default settings and save time. Using this feature, you can create a VM with a single ISO file located on your system, or you can create a VM from the Online Gallery. By default, Quick Create will list a Windows 10 Developer Environment but you can easily add your own Virtual Machine Images from your local/online repository.

In this article, I will describe how to use this feature and how to add a custom VM Image into your own Gallery.

Getting Started

Open the Hyper-V Management Console and click “Quick Create…” to open the wizard an confirm that the default Online Gallery is loaded.

wp-image-9976

The new window will appear with a simple set of options:

wp-image-9977

When you open the “Hyper-V Quick Create” window, it will open all pre-set virtual hard disks located in your local repository or Online Gallery. At this step, you can only use the Windows 10 dev environment or create a new VM from a local source.

How to Add a Custom Virtual Machine Image in the Gallery?

A gallery can be hosted online or locally. A Gallery contains Virtual Disk Images described by a JSON file. So the first thing you will need is a JSON document, which describes the image you want to show up in “Quick Create” window. Below is a simple code example that you can use to add your first image. Before going deeper with the JSON code, you must create the following files:

  1. Logo image
  2. Symbol image
  3. Thumbnail image

wp-image-9978

These files are not required, but in this example, we will use these images. Once you retrieved these files, you must generate the hash for each image using the following PowerShell command:

wp-image-9979

This hash will be used by the JSON code to display the image in the “Quick Create” window. Please note the hash for each image because you will need to copy/paste it in the following JSON code.

Now, you need to store these files somewhere where the Hyper-V Manager can access it. So, it can be in a local directory, a webserver, or a network share. Usually, I like to store all the required files in the same folder as shown below, but once again, it is not mandatory:

wp-image-9980

Do not forget to store the VHDx disk in this folder and sysprep the disk. Of course, the sysprep is not mandatory to add the image in the Custom Gallery. To finish, create an empty JSON file and copy/paste the following code.

Note that if you edit it in VSCode, it will automatically provide IntelliSense.

wp-image-9981

Replace the following values:

  • name
  • publisher
  • lastUpdated
  • description
  • disk uri/hash: Here, it is important to note that you can use a website in the uri field or a network path. If you use a network path, do not forget to add two backslashes to escape the slash character.
  • logo uri/hash
  • symbol uri/hash
  • thumbnail uri/hash
  • details information (name/value)

Note that you can also add a “requirements” section.

Set the Custom Repository Location

The last step is to configure the repository location in order to load the custom images when the “Quick Create” window will appear. This task can be performed using the registry on the machine where you use the “Quick Create” feature. You can perform this task in two ways:

You can add the registry key manually:

  • Navigate to: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Virtualization\
  • Look for the GalleryLocations item.
  • Add your gallery to the “GalleryLocations” registry key

wp-image-9982

Or using Windows PowerShell. It is great to use Windows PowerShell if you need to automate the configuration:

Note: To deploy this setting on multiple machines, you can use a Group Policy Object.

It is time to test! Open the Hyper-V Management Console and Click “Quick Create“:

wp-image-9983

To modify the custom image:

  • Close the wizard
  • Modify and save the JSON file
  • Open the wizard

Note: If the custom image does not appear in the list, then there is probably a wrong path or a wrong filename in the JSON file.

Conclusion

Thanks to this new feature, you can easily use your own Virtual Machine images in the “Hyper-V Quick Create” in order to create a new Virtual Machine. You can also share your Gallery with your colleagues.

There are some scripts in GitHub that can help you to implement your custom Gallery:

https://github.com/MicrosoftDocs/Virtualization-Documentation/tree/live/hyperv-tools/vmgallery

Thanks for reading!

Hey! Found Nicolas’s article helpful? Looking to deploy a new, easy-to-manage, and cost-effective hyperconverged infrastructure?
Alex Bykovskyi
Alex Bykovskyi StarWind Virtual HCI Appliance Product Manager
Well, we can help you with this one! Building a new hyperconverged environment is a breeze with StarWind Virtual HCI Appliance (VHCA). It’s a complete hyperconverged infrastructure solution that combines hypervisor (vSphere, Hyper-V, Proxmox, or our custom version of KVM), software-defined storage (StarWind VSAN), and streamlined management tools. Interested in diving deeper into VHCA’s capabilities and features? Book your StarWind Virtual HCI Appliance demo today!