Windows Server 2022 — Hyper-V checkpoint merge stuck for AVHDX chain — Fix & Prevention

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution — Primary Fix
7. Solution — Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

AVHDX growth consumes storage and VM performance degrades while merges never complete.

Environment & Reproduction

Windows Server 2022 build 20348 Hyper-V with frequent backup checkpoints.

Get-VMCheckpoint -VMName APP01
Get-ChildItem 'D:VMsAPP01' -Filter *.avhdx | Select Name,Length,LastWriteTime
Get-VHD -Path 'D:VMsAPP01disk01.avhdx'

Root Cause Analysis

Interrupted backup jobs, low free space, or orphaned checkpoint metadata blocks merge pipeline.

Quick Triage

Confirm available storage and checkpoint age.

Get-Volume D | Select DriveLetter,SizeRemaining
Get-VMCheckpoint -VMName APP01 | Sort CreationTime

Step-by-Step Diagnosis

Inspect chain parent paths and VMMS events for merge failure IDs.

Get-VHD -Path 'D:VMsAPP01*.avhdx'
Get-WinEvent -LogName 'Microsoft-Windows-Hyper-V-VMMS-Admin' -MaxEvents 120

Solution — Primary Fix

Gracefully stop VM, remove stale checkpoints, and trigger merge.

Stop-VM APP01 -Force
Get-VMCheckpoint -VMName APP01 | Remove-VMCheckpoint
Start-VM APP01

Solution — Alternative Approaches

Manually merge AVHDX chain offline if checkpoint metadata is inconsistent.

Merge-VHD -Path 'D:VMsAPP01disk01.avhdx' -DestinationPath 'D:VMsAPP01disk01.vhdx'
Set-VMHardDiskDrive -VMName APP01 -Path 'D:VMsAPP01disk01.vhdx'

Verification & Acceptance Criteria

No residual AVHDX files remain and VM boots cleanly.

Get-ChildItem 'D:VMsAPP01' -Filter *.avhdx
Get-VM APP01
Get-WinEvent -LogName 'Microsoft-Windows-Hyper-V-VMMS-Admin' -MaxEvents 20

Rollback Plan

Reattach previous VHDX and restore from backup if merge fails.

Set-VMHardDiskDrive -VMName APP01 -Path 'D:Backupdisk01-premerge.vhdx'
wbadmin start recovery -version:

Prevention & Hardening

Limit checkpoint retention and validate backup completion hooks.

Get-VMCheckpoint -VMName * | Group-Object VMName
Get-ScheduledTask -TaskName '*backup*'

Related Errors & Cross-Refs

Linked to CSV free-space pressure and backup software timeout settings.

Related tutorial: View the step-by-step tutorial for Windows Server 2022.

View all Windows Server 2022 tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Microsoft Learn Hyper-V checkpoint operations and merge troubleshooting.