Backup EnginebackupEngine
Docs/Server Backup/Hyper-V

Hyper-V VM Backup

Back up Hyper-V virtual machines with image-level, application-aware, and instant recovery capabilities.

Overview

BackupEngine provides agentless, image-level backup of Hyper-V virtual machines. The agent runs on the Hyper-V host and uses the Windows Volume Shadow Copy Service (VSS) to create application-consistent snapshots of running VMs without downtime or performance impact.

  • Supports Hyper-V on Windows Server 2016, 2019, 2022, and Windows 10/11 Pro with Hyper-V role.
  • Back up entire VMs including virtual disks (VHDX), configuration, snapshots, and saved state.
  • Application-aware VSS ensures consistency for SQL Server, Exchange, and Active Directory running inside VMs.
  • Available on Server plans only. The Hyper-V tab appears when the Hyper-V role is detected.

Discovering VMs on the Host

Before configuring a backup set, confirm the agent can see the Hyper-V role and enumerate the VMs you intend to protect.

  • Open the Hyper-V tab in the desktop agent.
  • The role-detection banner at the top shows whether Hyper-V is present and the agent has the rights to enumerate VMs.
  • The VM list shows every VM with name, state (Running / Off / Saved), generation (Gen1 / Gen2), assigned memory, and disk count.

Configuring VM Backups

Hyper-V backup-set creation is GUI-only — the wizard handles VM selection, application-aware VSS, retention, multi-destination fan-out, and scheduling. Once a Hyper-V backup set exists, you can trigger runs from the CLI using its set name.

  • Auto-protect: Automatically includes any new VMs created on the host. No manual intervention needed.
  • Selective: Choose specific VMs from the list. New VMs are not included until manually added.
  • Exclude list: Remove specific VMs from auto-protect (e.g., test or development VMs).
  • Per-VM scheduling: Set different backup schedules for different VMs based on criticality.

ℹ Note

This is GUI-only — wizard fields like auto-protect, exclude list, and per-VM scheduling are not exposed on the CLI in v1.11.0. BackupEngine uses Hyper-V's built-in VSS writer to create consistent snapshots; the VM continues running during the backup with no noticeable performance impact in most workloads.

Application-Aware Processing

When application-aware processing is enabled, BackupEngine coordinates with VSS writers inside the guest VM to ensure that applications like SQL Server and Exchange flush their buffers and create a consistent state before the snapshot is taken.

  • SQL Server: Ensures all committed transactions are flushed to disk. Transaction logs are truncated after a successful backup.
  • Active Directory: Ensures the AD database (NTDS.DIT) is in a consistent state.
  • Exchange Server: Ensures mailbox database consistency and truncates transaction logs.
  • Requires Hyper-V Integration Services to be installed and running in the guest VM.

⚠ Warning

If Integration Services are not available or the guest VSS writer fails, BackupEngine falls back to a crash-consistent snapshot. This is equivalent to powering off the VM — the backup is valid but applications may need to perform recovery on startup.

Setting Up a Hyper-V Backup Set

Use the Hyper-V backup wizard in the desktop agent to create a backup set. The wizard walks you through selecting VMs, configuring backup options, choosing a destination, and scheduling.

  • Step 1: Select VMs — Choose which virtual machines to protect. You can select specific VMs or enable auto-protect to automatically include new VMs.
  • Step 2: Backup Options — Toggle application-aware VSS processing (recommended for databases and directory services). Set retention policy (e.g., keep 30 days of backups).
  • Step 3: Destination — Choose where backups are sent: iDrive e2 (cloud) or a local NAS/network share.
  • Step 4: Schedule — Set when backups run (daily, weekly, or continuous). Adjust timing to minimize host impact.
  • Step 5: Review — Review your choices and click Create Backup Set. The first backup starts immediately.

ℹ Note

The wizard saves a backup set that the normal scheduler will use. Once created, you can edit the backup set from the main Hyper-V tab without re-running the wizard. CLI-driven set create/edit is not in v1.11.0.

Running a Hyper-V Backup

Once a Hyper-V backup set exists, both the GUI and the CLI can trigger ad-hoc runs.

  • Open the Hyper-V tab.
  • Find the saved backup set. The card shows the included VMs, schedule, destination(s), and last-run status.
  • Click Run Now to trigger a manual run; click View to see the per-run diagnostic log.

Restoring Virtual Machines

BackupEngine offers multiple restore options for Hyper-V VMs to fit different recovery scenarios.

  • Full VM Restore: Restores the entire VM including all virtual disks, configuration, and snapshots to the original or a different host.
  • Individual Disk Restore: Restore a specific VHDX file without restoring the entire VM.
  • File-Level Restore: Mount the VM backup and browse individual files from inside the guest file system without restoring the full VM.
  • Instant Recovery: Boot the VM directly from the backup storage for immediate availability while the full restore completes in the background.

ℹ Note

Hyper-V restore is GUI-only — the CLI's restore command is for file-path restores and does not orchestrate VM-level recovery, file-level mount, or instant recovery. Use the desktop agent's Restore tab for all VM restore scenarios. See Restoring Hyper-V Virtual Machines for a detailed walkthrough including the auto-generated RESTORE_INFO.txt PowerShell commands.

Incremental Chains and Synthetic Full

BackupEngine supports RCT-based incremental chains with synthetic-full promotion at the chain cap, so long-running protection of large VMs costs near-zero bandwidth on chain rolls.

ℹ Note

For incremental backup chains and synthetic full promotion, see Hyper-V Incremental Backup & Chain Promotion.