Convert, Resize, and Optimize VHD and VHDX files with PowerShell

The process itself is simple. The examples shown in this blog post are being run on a Windows 10 computer which has Hyper-V enabled on it. Only specific SKU’s of Windows 10 are capable of running Hyper-V. The same process can be used on servers running Windows Server 2012 R2 or Windows Server 2016.

There are several PowerShell cmdlets for working with VHD files as shown in the following example.

The Convert-VHD cmdlet can be used to change the format (VHD to VHDX or vise-versa), Type (fixed, dynamic, and differencing), and block size of the file.

The following example converts a VHD file to a VHDX file.

Convert-VHD -Path 'D:\Hyper-V\Virtual Hard Disks\nano.vhd' -DestinationPath 'D:\Hyper-V\Virtual Hard Disks\nano.vhdx'

There are a number of parameters for the Convert-VHD cmdlet so be sure to take a look at the help for it. The BlockSizeBytes parameter is used to change the block size, the DeleteSource parameter is used to delete the source file once the destination file is created, and the VHDType parameter is used to change the type of VHD (fixed, dynamic, or differencing).

One thing to keep in mind is the conversion process is an offline operation. The help states that the file being converted can’t be attached, but what I’ve found is that it can be attached as long as the VM (virtual machine) isn’t running.

The Optimize-VHD cmdlet is used to optimize the amount of space used by dynamic virtual hard drive files. When this cmdlet is run, it compacts the virtual file as shown in the following example.

Optimize-VHD -Path 'D:\Hyper-V\Virtual Hard Disks\srv1e.vhd'

Based on the information found in the help, this cmdlet not only reclaims unused blocks, but it also rearranges the blocks to be more efficiently packed, which also reduces the size of the VHD or VHDX. It’s possible for this command to complete without shrinking the virtual file if no optimization is necessary. The Mode parameter can be used to change the default mode which is Full for VHD files and Quick for VHDX files.

The Resize-VHD cmdlet is used to shrink VHDX files or expand both VHD and VHDX files. The shrink operation will fail if a size smaller than the minimum size is specified as shown in the following example.

Get-VHD -Path 'D:\Hyper-V\Virtual Hard Disks\srv1e.vhd'

The MinimumSize parameter can be used to shrink a VHDX to it’s minimum size without having to worry about the possibility of specifying a file size that’s too small.

Resize-VHD -Path 'D:\Hyper-V\Virtual Hard Disks\srv1.vhdx' -ToMinimumSize

Take a look at the help for the Resize-VHD cmdlet to determine all of the available options.


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s