Skip to content

Commit 3884cda

Browse files
authored
Updates from editor
1 parent ef43469 commit 3884cda

File tree

1 file changed

+26
-26
lines changed

1 file changed

+26
-26
lines changed

support/windows-server/virtualization/hyper-v-virtual-machine-backup-checkpoint-storage.md

Lines changed: 26 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
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
55
manager: dcscontentpm
66
audience: itpro
77
ms.topic: troubleshooting
@@ -12,7 +12,7 @@ ms.custom:
1212
---
1313
# Troubleshoot Hyper-V virtual machine backup, checkpoint, and storage failures
1414

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.
1616

1717
You might experience:
1818

@@ -28,7 +28,7 @@ In addition, you might encounter the following symptoms in affected environments
2828
- [VM startup or migration failures](#vm-startup-or-migration-failures)
2929
- [Storage and file system errors](#storage-and-file-system-errors)
3030

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:
3232

3333
- [Checkpoint and VSS-related issues](#checkpoint-and-vss-related-issues)
3434
- [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
4242

4343
- Backups fail to complete or hang indefinitely.
4444
- 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:
4646

4747
- > Failed to create VM recovery checkpoint … error code: 32768
4848
- > Could not create backup checkpoint for virtual machine - Error -0x800423F2
4949
- > There was a problem recovering your PC
5050
- > Import failed. … The process cannot access the file because it is being used by another process. (0x80070020)
5151
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.
5353

5454
## Checkpoint and snapshot issues
5555

5656
- 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.
5858
- 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.
6161

6262
## VM startup or migration failures
6363

@@ -67,14 +67,14 @@ The root causes of these issues can be grouped into the following categories wit
6767
- > The system cannot find the file specified. (0x2)
6868
- > An error occurred while attempting to start the selected VM. Unavailable could not initialize and update VM configuration failed.
6969
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.
7171
- VM migration, export, or import fails due to missing or corrupted files.
7272

7373
## Storage and file system errors
7474

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.
7878
- Errors such as:
7979

8080
- > 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
8383
## Checkpoint and VSS-related issues
8484

8585
- 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.
8787
- Third-party backup integration: Misconfigurations or incompatibilities between Hyper-V and backup tools such as Veeam, Druva, or Veritas.
8888

8989
### Resolution: Checkpoint and AVHDX file management
@@ -102,8 +102,8 @@ The root causes of these issues can be grouped into the following categories wit
102102
103103
1. Shut down the affected VM.
104104
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.
107107
108108
3. Advanced PowerShell merge (if needed):
109109
@@ -175,16 +175,16 @@ The root causes of these issues can be grouped into the following categories wit
175175
176176
1. Assign required rights:
177177
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.
179179
2. Update NTFS permissions:
180180
181181
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).
183183
184184
## Cluster and configuration issues
185185
186186
- 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.
188188
- Incorrect VM or storage path settings: Misconfigured paths or mismatched network adapters after a migration.
189189
190190
### Resolution: Cluster and VM configuration fixes
@@ -196,9 +196,9 @@ The root causes of these issues can be grouped into the following categories wit
196196
2. Restore or import missing VMs:
197197
198198
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:
200200
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:
202202
203203
```powershell
204204
Update-VMVersion
@@ -216,17 +216,17 @@ The root causes of these issues can be grouped into the following categories wit
216216

217217
## Other repairs and checks
218218

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.
221221
3. Restart the host to clear stale file locks if needed.
222222

223223
## Data collection
224224

225225
To assist with troubleshooting, collect the following items:
226226

227227
- Event logs: Application, system, and Hyper-V-specific logs.
228-
- PowerShell diagnostic cmdlets: `Get-VHDChain`, `Get-VMSnapshot`, `Get-VM`, `Update-VMVersion`, `icacls`, `Merge-VHD`, `Set-VHD`.
229-
- VSS tools: `vssadmin list writers`, `vssadmin list providers`.
228+
- PowerShell diagnostic cmdlets: `Get-VHDChain`, `Get-VMSnapshot`, `Get-VM`, `Update-VMVersion`, `icacls`, `Merge-VHD`, and `Set-VHD`.
229+
- VSS tools: `vssadmin list writers` and `vssadmin list providers`.
230230
- Diagnostic tools: Process Monitor (Procmon), **Handle.exe**, Process Explorer, and Troubleshooting Support Script (TSS).
231231
- Cluster logs: Failover clustering logs and System Center Virtual Machine Manager (SCVMM) job history.
232232
- Vendor-specific tools for checkpoint/snapshot cleanup.
@@ -235,5 +235,5 @@ To assist with troubleshooting, collect the following items:
235235

236236
- [Export and import virtual machines](/windows-server/virtualization/hyper-v/deploy/export-and-import-virtual-machines)
237237
- [Backing up and restoring virtual machines](/windows/win32/hyperv_v2/backing-up-and-restoring-virtual-machines)
238-
- [Antivirus exclusions for Hyper-V](antivirus-exclusions-for-hyper-v-hosts.md)
238+
- [Antivirus exclusions for Hyper-V hosts](antivirus-exclusions-for-hyper-v-hosts.md)
239239
- [PowerShell Hyper-V cmdlets](/powershell/module/hyper-v/)

0 commit comments

Comments
 (0)