How to Create a Hyper-V VM from an ISO using PowerShell How to Create a Hyper-V VM from an ISO using PowerShell

21 Jun by Jeffery Hicks     8     Hyper-V & PowerShell

Today I have another article that continues my fascination with Hyper-V, PowerShell and spinning up new virtual machines with minimal intervention.

During a recent conference, fellow PowerShell MVP Aleksandar Nikolic did a presentation on creating a Hyper-V test lab. One of his demonstrations used a tool I had forgotten about and sparked an idea for a PowerShell script. My script will create a new Hyper-V virtual machine based on an ISO file for a Windows Server. Most of Microsoft’s installation media can be downloaded as ISO images from MSDN or TechNet. Or you might download an evaluation installation ISO of a new operating system so that you can test it out, such as Windows Server 2012. This is a great reason to use a Hyper-V virtual machine.

My script relies on a PowerShell script which you can freely download from Microsoft called Convert-WindowsImage.ps1. The script was written by Microsoft and is designed to create a bootable VHD or VHDX file from an ISO installation image. You can download the script from It will require PowerShell 3.0. I’m not going to go into the details of the script except to explain that it will extract a server version from the ISO file, create a VHD or VHDX file based on the installation media and insert an unattend.xml file. With a little planning you could create a system for cranking out new virtual machines based on a variety of unattend.xml files. You could even generate or modify the XML files on the fly. But that is beyond what I want to demonstrate in this article.

First, let me show you my script.

The script takes values for the virtual machine name and the path to the ISO file. I’ve set a default value based on an ISO file that I use. Because Windows Server installation files can contain multiple images, you need to specify the edition you wish to convert. You also need to specify the name and path for the VHD or VHDX file, including the extension. The script needs the extension so it knows what kind of disk file to create. Specify the path to an unattend.xml file which will be inserted into the new VHD. The Microsoft script will automatically mount the new VHD, copy the unattend file and automatically dismount. Finally, you will also need to specify some basic settings for the new virtual machine such as the amount of memory, the number of processors and the Hyper-V switch.

My script first calls the Convert-WindowsImage.ps1 script to create the VHD or VHDX file.

This might take up to 10 minutes depending on the size of the disk you want to create and where you are creating it. When I create a 15GB VHDX on an SSD drive it only took a few minutes. By the way, the disk files are automatically configured to be dynamically expanding. My script also supports –WhatIf and –Verbose so you can test out and verify your values.

Once I have a disk file, creating the virtual machine is very easy using New-VM with parameters gathered from the script.

In Figure 1 you can see my script in action.

Figure 1

The new VM is piped to Set-VM to configure. You could add as many additional configuration changes as you want from PowerShell. The end result is a working virtual machine with as much of the OS configured as I want using the unattend.xml file. If it helps, unattend file that I use.

My script certainly works as a stand-alone tool, although you will most likely want to adjust some of the default parameter values. I would suggest you use the script as the basis for building your own provisioning system. There are so many variables in how someone might want to spin up and provision a new virtual machine that I haven’t tried to build a perfect solution. Instead I’ve written articles on the blog that explore the process from different angles with the assumption that you will be able to pull something together.

For PowerShell help, including using the Hyper-V cmdlets, I encourage you to use the forum at


Have any questions?

Feel free to post comments or questions regarding this specific post here. Finally, if there are other PowerShell and Hyper-V topics you’d like to see me explore, please let me know by leaving a comment.


Backing up Hyper-V

If you’d like to make backing up your Hyper-V VMs easy, fast and reliable, check out Altaro Hyper-V Backup v4. It’s free for up to 2 VMs and supports Hyper-V Server 2012 R2! Need more? Download a 30-day trial of our Unlimited Edition here:

Receive all our free Hyper-V guides, checklists and ebooks first via email!

(Don’t worry, we hate spam too!)

Jeffery Hicks

Jeffery Hicks is an IT veteran with over 25 years of experience, much of it spent as an IT infrastructure consultant specializing in Microsoft server technologies with an emphasis in automation and efficiency. He is a multi-year recipient of the Microsoft MVP Award in Windows PowerShell. He works today as an independent author, trainer and consultant. Jeff has written for numerous online sites and print publications, is a contributing editor at, and is a frequent speaker at technology conferences and user groups. His latest book is PowerShell In Depth: An Administrator's Guide 2nd Ed.

8 Responses to “How to Create a Hyper-V VM from an ISO using PowerShell”

  1. Jeffery Hicks
    Jeffery Hicks

    Since Windows Server 2012 R2 Preview just came out, I used this script to quickly build a new virtual machine.

    PS C:\scripts> .\New-VMfromISO.ps1 -ISOPath G:\iso\Windows2012R2-Datacenter-Preview.iso -Edition ServerDataCenterCore -VHDPath g:\vhds\Win2012R2Core.vhdx -Name Win2012R2-Core-Baseline

    I renamed the ISO file to make it easier to type. Once I have the VM configured I’ll use it as a baseline to spin up more VMs using differencing disks.

  2. TDA

    Great guide, I’m trying to run it for W2012R2 machine BUT it doesnt work . . . it tell me that the Micrososft Script cannot be loaded because is not digitally signed.

  3. TDA

    Ok was a problem on my server, now it runs… but it create GEN1 VM – is it possible to create GEN2 VM?

  4. PowerShellN00b

    Another thing, I have see that the UNATTENDED DONT CREATE the partition in the VHDX but the other settings (serial,…) are in the VHDX… why?

  5. Thanks for reading and I’m glad you found this useful.

    A generation 2 virtual machine needs some special setup, especially if you are doing it from the console. You won’t be able to use the code in my post to create a Gen2 VM. The disk and VM have to be configured to support UEFI. But stay tuned as I am working on some new content on this topic.

    Finally, I’m not sure I understand the comment about the “don’t create the partition” in the unattend file.

  6. John

    Everything seems to work but the VM isn’t bootable. I get this error in PS. Any idea how/what to fix? thanks.

    VERBOSE: Partition Style : 0
    VERBOSE: Disk Signature : 1423167926
    VERBOSE: Partition Offset: 1048576
    ERROR : Could not get the BootMgr object from the Virtual Disks BCDStore.
    INFO : Log folder is C:\Users\ADMINI~1\AppData\Local\Temp\Convert-WindowsImage\4758eeab-519e-4d87-a8f0-d2265459142a

  7. Jeffery Hicks
    Jeffery Hicks

    John, are you trying to create a generation 2 VM? My code won’t work for that. Did you change the path for Convert-WindowsImage? My script assumes it is in C:\Scripts.

Leave a comment