Where Are My Hyper-V Checkpoints Stored?

Table of contents

When creating a Hyper-V checkpoint, it is crucial to know where the checkpoint files are being saved, especially since checkpoint files can fill up storage. When trying to find where the checkpoint files are being stored in your Hyper-V environment, it is important to understand what types of files are generated when creating a checkpoint. This is because components of the checkpoint are stored in two separate locations. The AVHDX file is stored with the VHD storage and the checkpoint configuration files are stored with the VM’s active configuration files.

Hyper-V Checkpoint Configuration Files

The checkpoint configuration files are the files that store the settings and state of the VM at the point in time when the checkpoint is created. They consist of an XML file, a .BIN file, and a .VSV file. By default they are stored in the following location:

%systemroot%ProgramDataMicrosoftWindowsHyper-VSnapshots

If you want to double check where the checkpoint files are being stored in your Hyper-V environment, open up Hyper-V Manager, right click on your host, and select Hyper-V settings:

1-cplocations

On the left hand side, select Virtual Machines. The location of your checkpoints will be the path that is displayed on the right hand side:

2-cplocations

In my example, I have my host configured to save the VM configuration files (and checkpoint configuration files) to:

C:ClusterStoragevolume1vms

When the first checkpoint is created, a sub folder called “Snapshots” is automatically created in this path. If we take a look at that location we can see the files that are stored when a Hyper-V checkpoint is created. Also note that for each checkpoint a folder is created and named with the checkpoint GUID. An XML file with the same GUID naming scheme is created at the root of the snapshots folder:

3-cplocations

This XML file contains all the information about the VM configuration, such as the resource information, checkpoint locations, etc. Right now I have two checkpoints created for a single VM. I have changed the resources assigned to the VM in between each checkpoint. If I open up both XML files and search for memory, I can see the value for assigned memory size is different for each checkpoint state:

4-cplocations

Looking deeper into the checkpoint folder structure, within each GUID checkpoint folder, there is a BIN and VSV file:

5-cplocations

The BIN and VSV files contains the memory contents and the device state, respectively, of the VM when the Hyper-V checkpoint was created. Because these files essentially save information pertaining to the running state of the VM, these files are only created if the checkpoint was taken while the VM was powered on. So, if the VM was powered off while all checkpoints were taken, there would be no VSV or BIN files.

AVHDX File Location

The AVHDX file is stored in a separate location. This is the differencing disk file that is used for the checkpoint. All change data is written to this disk and the default stored location depends on the OS version:

Windows Server 2012R2 or Windows 8.1 – C:UsersPublicDocumentsHyper-VVirtual Hard Disks

Windows Server 2012 and Windows 8 – C:ProgramDataMicrosoftWindowsHyper-VNew Virtual MachineVirtual Hard Disks

To change the default location, right click on the Hyper-V host and select Hyper-V Settings again. This time on the left hand side select Virtual Hard Disks. The default location will be displayed on the right hand side:

6-cplocations

In this example, I’ve changed the default location to be:

C:clusterstoragevolume1vhds

If we look in this folder we can see the AVHDX file created for each checkpoint created for the Luke-APP VM:

7-cplocations

Changing Default Save Locations for Multiple Hyper-V Hosts

Unless you have System Center Virtual Machine Manager, you will have to manually change the default location for VMs and VHDs on each host. If you have 20 hosts, that gets a little tedious. Luckily, PowerShell can help us change this setting easily.

To change the default virtual hard disk path on multiple hosts we’ll use the Set-VMHost cmdlet. First we need to get a list of our Hyper-V hosts to reference in the cmdlet. Depending on how large of list of Hyper-V hosts you have, you can either use a CSV file or simply type in the names of the hosts. In this example, I will make a variable listing my two Hyper-V hosts by typing the following command:

$hosts = "Luke-HV03","Luke-HV04"

8-cplocations

Just to make sure the variable contains all of our hosts we will enter the $host variable into the console to confirm:

9-cplocations

To change the path of the default folder for VHDs simply type the following command:

Set-VMHost –ComputerName $hosts –VirtualHardDiskPath “C:ClusterStorageVolume1NewVHDs"

10-cplocations

To change the path of the default folder for storing virtual machine configuration files, type in the following command:

Set-VMHost –ComputerName $hosts –VirtualMachinePath “C:ClusterStorageVolume1NewVMs"

11-cplocations

Now when we look at the default locations for both settings on our hosts they show the updated changes:

12-cplocations

13-cplocations

Note that the folders must already be created and accessible by each host in order to set the default folder to be that location.

 

Altaro Hyper-V Backup
Share this post

Not a DOJO Member yet?

Join thousands of other IT pros and receive a weekly roundup email with the latest content & updates!

10 thoughts on "Where Are My Hyper-V Checkpoints Stored?"

  • kyrian says:

    great article, except for the typo where the powershell command for the virtualmachinepath. ( “Set-VMHost –ComputerName $hosts –VirtualHARDDISKPath “C:ClusterStorageVolume1NewVMs”” should be “Set-VMHost –ComputerName $hosts –VirtualMACHINEPath “C:ClusterStorageVolume1NewVMs”).

    great commands when using a cluster and no SCVMM is installed or configured. *thumbs up*

  • kyrian says:

    great article, except for the typo where the powershell command for the virtualmachinepath. ( “Set-VMHost –ComputerName $hosts –VirtualHARDDISKPath “C:ClusterStorageVolume1NewVMs”” should be “Set-VMHost –ComputerName $hosts –VirtualMACHINEPath “C:ClusterStorageVolume1NewVMs”).

    great commands when using a cluster and no SCVMM is installed or configured. *thumbs up*

  • GCumming says:

    Good information.

    I took a checkpoint of my VM’s while they were running. However, when I looked in the Snapshot folder where the XML file should be, they are empty. What would cause that?

    They are brand new VM’s, with no roles installed. It is in a practice lab so I want to be able to return them to a un-used state.

    Thanks

Leave a comment or ask a question

Your email address will not be published. Required fields are marked *

Your email address will not be published.

Notify me of follow-up replies via email

Yes, I would like to receive new blog posts by email

What is the color of grass?

Please note: If you’re not already a member on the Dojo Forums you will create a new account and receive an activation email.