You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: support/windows-server/virtualization/hyper-v-virtual-machine-backup-checkpoint-storage.md
+26-26Lines changed: 26 additions & 26 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
title: Troubleshoot Hyper-V Virtual Machine Backup, Checkpoint, and Storage Failures
3
-
description: Provides a comprehensive guide to troubleshooting common issues encountered with Hyper-V virtual machine (VM) backup, checkpoint management, and storage failures in Windows Server environments.
4
-
ms.date: 08/19/2025
3
+
description: Provides a comprehensive guide to troubleshooting common issues with Hyper-V VM backup, checkpoint management, and storage failures in Windows Server environments.
4
+
ms.date: 08/22/2025
5
5
manager: dcscontentpm
6
6
audience: itpro
7
7
ms.topic: troubleshooting
@@ -12,7 +12,7 @@ ms.custom:
12
12
---
13
13
# Troubleshoot Hyper-V virtual machine backup, checkpoint, and storage failures
14
14
15
-
This article provides a comprehensive guide to troubleshooting common issues encountered with Hyper-V virtual machine (VM) backup, checkpoint management, and storage failures in Windows Server environments (Windows Server 2016, Windows Server 2019, and Windows Server 2022). These issues often arise during backup or restore operations, checkpoint creation or merging, VM startup, and storage connectivity. They can impact both production and disaster recovery workflows in standalone Hyper-V hosts, clustered setups, and environments integrated with third-party backup tools. Timely identification and resolution are critical to maintaining VM availability, data integrity, and backup reliability.
15
+
This article provides a comprehensive guide to troubleshooting common issues encountered with Hyper-V virtual machine (VM) backup, checkpoint management, and storage failures in Windows Server environments (Windows Server 2016, Windows Server 2019, and Windows Server 2022). These issues often arise during backup or restore operations, checkpoint creation or merging, VM startup, and storage connectivity. They can impact both production and disaster recovery workflows in standalone Hyper-V hosts, clustered setups, and environments integrated with third-party backup tools. Timely identifying and resolving these issues is critical to maintaining VM availability, data integrity, and backup reliability.
16
16
17
17
You might experience:
18
18
@@ -28,7 +28,7 @@ In addition, you might encounter the following symptoms in affected environments
28
28
-[VM startup or migration failures](#vm-startup-or-migration-failures)
29
29
-[Storage and file system errors](#storage-and-file-system-errors)
30
30
31
-
The root causes of these issues can be grouped into the following categories with corresponding resolutions provided:
31
+
The root causes of these issues can be grouped into the following categories, with corresponding resolutions provided:
32
32
33
33
-[Checkpoint and VSS-related issues](#checkpoint-and-vss-related-issues)
34
34
-[File system and storage problems](#file-system-and-storage-problems)
@@ -42,22 +42,22 @@ The root causes of these issues can be grouped into the following categories wit
42
42
43
43
- Backups fail to complete or hang indefinitely.
44
44
- Restore operations from checkpoints or images fail.
45
-
- Error messages from backup software (such as Veeam, Druva, Rubrik, or Veritas) including:
45
+
- Error messages from backup software (such as Veeam, Druva, Rubrik, or Veritas) include:
46
46
47
47
-> Failed to create VM recovery checkpoint … error code: 32768
48
48
-> Could not create backup checkpoint for virtual machine - Error -0x800423F2
49
49
-> There was a problem recovering your PC
50
50
-> Import failed. … The process cannot access the file because it is being used by another process. (0x80070020)
51
51
52
-
- Event log entries such as Event ID 8229 (host) and 12293 (guest) indicating Volume Shadow Copy Service (VSS) writer errors.
52
+
- Event log entries, such as Event ID 8229 (host) and 12293 (guest), indicate Volume Shadow Copy Service (VSS) writer errors.
53
53
54
54
## Checkpoint and snapshot issues
55
55
56
56
- Unable to create new checkpoints or merge existing ones.
57
-
-Accumulation of AVHDX files on disk, even when not visible in Hyper-V Manager.
57
+
-VHDX files accumulate on disk, even when not visible in Hyper-V Manager.
58
58
- Errors such as: "The process cannot access the file because it is being used by another process. (0x80070020)".
59
-
- Orphaned or hidden checkpoints blocking backup or VM operations.
60
-
- VMs stuck in saved, paused, or critical states.
59
+
- Orphaned or hidden checkpoints block backup or VM operations.
60
+
- VMs are stuck in saved, paused, or critical states.
61
61
62
62
## VM startup or migration failures
63
63
@@ -67,14 +67,14 @@ The root causes of these issues can be grouped into the following categories wit
67
67
-> The system cannot find the file specified. (0x2)
68
68
-> An error occurred while attempting to start the selected VM. Unavailable could not initialize and update VM configuration failed.
69
69
70
-
- VMs not visible in Hyper-V Manager or Failover Cluster Manager.
70
+
- VMs aren't visible in Hyper-V Manager or Failover Cluster Manager.
71
71
- VM migration, export, or import fails due to missing or corrupted files.
72
72
73
73
## Storage and file system errors
74
74
75
-
- Event logs showing IDs 9, 39, 129, 3280, 55, 51, or 513 related to storage, disk, or file system corruption.
76
-
- Storage volume running out of space due to large AVHDX files.
77
-
- VHD/VHDX files missing, inaccessible, or corrupted.
75
+
- Event logs show IDs 9, 39, 129, 3280, 55, 51, or 513 related to storage, disk, or file system corruption.
76
+
- Storage volume runs out of space due to large AVHDX files.
77
+
- VHD/VHDX files are missing, inaccessible, or corrupted.
78
78
- Errors such as:
79
79
80
80
-> Cannot connect to virtual machine configuration storage
@@ -83,7 +83,7 @@ The root causes of these issues can be grouped into the following categories wit
83
83
## Checkpoint and VSS-related issues
84
84
85
85
- Orphaned or unmerged checkpoints: Caused by incomplete backup operations, hidden/invisible checkpoints, or AVHDX chain corruption.
86
-
- VSS writer failures or timeouts: VSS writers in failed or timed-out states, often due to overlapping backup jobs or VSS operations.
86
+
- VSS writer failures or timeouts: VSS writers in failed or timeout states, often due to overlapping backup jobs or VSS operations.
87
87
- Third-party backup integration: Misconfigurations or incompatibilities between Hyper-V and backup tools such as Veeam, Druva, or Veritas.
88
88
89
89
### Resolution: Checkpoint and AVHDX file management
@@ -102,8 +102,8 @@ The root causes of these issues can be grouped into the following categories wit
102
102
103
103
1. Shut down the affected VM.
104
104
2. In Hyper-V Manager, select the VM, and then select **Actions** > **Edit Disk** to open the **Edit Virtual Hard Disk Wizard** window.
105
-
3. On the **Locate Disk** tab, select **Browse** to locate the AVHDX file, then select **Next**.
106
-
4. On the **Choose Action** tab, select **Merge** > **To the parent virtual hard disk**, then select **Next** to complete the wizard.
105
+
3. On the **Locate Disk** tab, select **Browse** to locate the AVHDX file, and then select **Next**.
106
+
4. On the **Choose Action** tab, select **Merge** > **To the parent virtual hard disk**, and then select **Next** to complete the wizard.
107
107
108
108
3. Advanced PowerShell merge (if needed):
109
109
@@ -175,16 +175,16 @@ The root causes of these issues can be grouped into the following categories wit
175
175
176
176
1. Assign required rights:
177
177
178
-
Ensure **NT Virtual Machine\\Virtual Machines** has **Log on as a Service** rights via Group Policy or Local Security Policy.
178
+
Ensure the **NT Virtual Machine\\Virtual Machines** account has **Log on as a Service** rights via Group Policy or Local Security Policy.
179
179
2. Update NTFS permissions:
180
180
181
181
Use `icacls` to verify and grant **Full Control** to VM service accounts.
182
-
3. Configure antivirus exclusions by following the [Microsoft antivirus exclusions for Hyper-V](antivirus-exclusions-for-hyper-v-hosts.md).
182
+
3. Configure antivirus exclusions by following the [Microsoft antivirus exclusions for Hyper-V hosts](antivirus-exclusions-for-hyper-v-hosts.md).
183
183
184
184
## Cluster and configuration issues
185
185
186
186
- Cluster role or metadata corruption: Caused by improper failovers, role removal, or unsynchronized cluster states.
187
-
- Configuration version mismatch: VM config versions below the required minimum after migrations or upgrades.
187
+
- Configuration version mismatch: VM configuration versions below the required minimum after migrations or upgrades.
188
188
- Incorrect VM or storage path settings: Misconfigured paths or mismatched network adapters after a migration.
189
189
190
190
### Resolution: Cluster and VM configuration fixes
@@ -196,9 +196,9 @@ The root causes of these issues can be grouped into the following categories wit
196
196
2. Restore or import missing VMs:
197
197
198
198
In Hyper-V Manager, use **Import Virtual Machine** and locate the exported/imported files.
199
-
3. Update VM configuration version:
199
+
3. Update the VM configuration version:
200
200
201
-
In Hyper-V Manager, right-click the VM, and select **Upgrade Configuration Version**. Or use the following PowerShell cmdlet:
201
+
In Hyper-V Manager, right-click the VM and select **Upgrade Configuration Version**. Or use the following PowerShell cmdlet:
202
202
203
203
```powershell
204
204
Update-VMVersion
@@ -216,17 +216,17 @@ The root causes of these issues can be grouped into the following categories wit
216
216
217
217
## Other repairs and checks
218
218
219
-
1. Clean up saved states: Delete `.vmrs` and `.vmgs` files in the VM folder if stuck in a "Saved" state.
220
-
2. Check and fix cluster resource states: Use PowerShell cmdlets like `Get-ClusterResource` to inspect and repair cluster roles.
219
+
1. Clean up saved states. Delete `.vmrs` and `.vmgs` files in the VM folder if stuck in a "Saved" state.
220
+
2. Check and fix cluster resource states. Use PowerShell cmdlets like `Get-ClusterResource` to inspect and repair cluster roles.
221
221
3. Restart the host to clear stale file locks if needed.
222
222
223
223
## Data collection
224
224
225
225
To assist with troubleshooting, collect the following items:
226
226
227
227
- Event logs: Application, system, and Hyper-V-specific logs.
0 commit comments