Edit

What's new in Azure Migrate for Azure Local

This article lists the various features and improvements that are available in virtual machine (VM) migration to Azure Local (formerly Azure Stack HCI). This article applies to both Hyper-V (Preview) and VMware VM migrations.

Applies to: Azure Local 2503 and later

February 2026

This release includes these features and improvements:

  • Secure boot migration support for eligible VMs - Secure Boot settings are now preserved during migration for eligible UEFI (Generation 2) VMs. If Secure Boot is enabled on the source VM, it remains enabled on Azure Local after migration, helping maintain workload security posture.
  • Azure portal bug fix - Resolved a bug in the Azure portal where Azure Local logical networks and storage paths that are in a different subscription than the Azure Local instance weren't showing up as options during migration. These resources now show up correctly in the replication wizard.

January 2026

This release includes these features and improvements:

  • Register new target appliance when original appliance is in a bad state - You can now register a new target appliance if the original appliance becomes unresponsive or enters a bad state. This change allows migrations to continue without requiring a new Azure Migrate project. The 1:1 relationship between source and target appliance in the Azure Migrate project still applies, so the new target appliance replaces the original target appliance for all VMs in the project.
  • Fix for VM IP address discovery overwrite issue - Resolved a bug where IP address discovery data for certain VMs was cleared prior to migration due to discovery inconsistencies.
  • Improved error messaging for static IP migration issues - Enhanced error messages and validation guidance for scenarios involving static IP address migrations.

December 2025

This release includes these features and improvements.

  • Replication deployment bug fixed – Resolved an issue where some older Azure Migrate projects were incorrectly blocked during replication deployment despite the project being in a healthy state.

  • Unnecessary replication job failures resolved – Fixed a bug that caused repeated Create Replication Policy errors and unnecessary job failures when initiating VM replication.

November 2025

This release includes these features and improvements:

  • Key bug fix for Hyper-V migration boot failures - Fixed a critical issue that caused some VMs migrated from Hyper-V to fail at boot due to mismatched source and target data.
  • Improved Hyper-V source environment cleanup - Enhanced the cleanup process for Hyper-V environments and resolved problems where snapshot creation failed or old snapshots weren't removed when the snapshot name exceeded 100 characters.
  • Support for migrating Hyper-V VMs hosted on SOFS - Added support for discovering and replicating Hyper-V source VMs whose virtual disks are stored on external Scale-Out File Server (SOFS) shares. Previously, replication failed because the source appliance couldn't read disks hosted on SOFS. With this release, replication and migration work as long as the source Hyper-V credentials have read access to the SOFS shares. This feature only enables Azure Migrate to read from SOFS during replication. After migration, VMs run on Azure Local storage.
  • Replication workflows in deployments - Replication workflow and validation now execute through the standard Azure deployment model, providing improved visibility, consistent execution, and full tracking through the Activity Log and target resource group.
  • Pagination on replication, events, and jobs pages - Improved performance and usability by adding paginated views to replication, events, and jobs pages in the Azure portal.
  • Force delete now available for replications and migrations - You can now forcefully stop replications and complete migrations if your target appliance becomes unresponsive or the migrate project is in a bad state. For more information, see Can I forcefully stop replications or complete migrations?

Screenshot of force stop replication option for Azure Migrate replications to Azure Local.

October 2025

This release marks the General Availability (GA) of Azure Migrate support for migrating VMware VMs to Azure Local. No user changes are needed to get the GA capabilities.

This milestone highlights several capabilities shaped by customer and partner feedback during the preview, including:

  • Static IP address retention for Windows and Linux VMs via scripts.

  • PowerShell migration support for scripting and automation.

  • Advanced compute and disk customization options during migration.

For more information, see Overview of Azure Migrate based VMware migration for Azure Local.

September 2025

This release includes these features and improvements:

  • Improved PowerShell validation – Fixed an issue in the Az.Migrate PowerShell module where VM replications were blocked if source disk names contained reserved words. Replications now proceed correctly by using validated target VM names for disk naming.

  • Additional PowerShell reliability improvements – Fixed an issue that required -PhysicalSectorSize when replicating VHD disks and enhanced ARM ID validation for resources in PowerShell migrations.

August 2025

This release includes these features and improvements:

  • Tag updates for Data Replication Vault – You can now correctly create and update tags for the Azure Migrate Data Replication Vault resource in the Azure portal. This improvement makes organization, tag-based policies, and automation better.

  • Azure portal UX improvements – Fixed a set of minor issues across Azure Migrate blades for Azure Local to make replication and migration flows smoother and more reliable.

July 2025

This release includes these features and improvements:

  • PowerShell support for replication and migration – You can now use the Azure Migrate PowerShell module to replicate and migrate VMs to Azure Local. This support enables automation and scripting for streamlined migration workflows. For more information, see Migrate VMs to Azure Local using PowerShell.

  • Monitor migrations via diagnostic settings – You can now enable diagnostic settings in Azure Migrate to monitor Azure Local migrations. This feature provides improved observability and troubleshooting capabilities. For more information, see Monitor Azure Local migrations using diagnostic settings.

June 2025

This release includes these features and improvements:

  • Improved cleanup for failed replications – Fixed an issue where failed replication jobs left data on the target Azure Local instance. The process now properly removes the leftover data when replication fails.

  • Static IP address migration Windows script improvements – Made several improvements to the Windows VM static IP migration script:

    • Updated the scheduled task execution policy to resolve permission problems.
    • Improved handling of file paths that contain spaces.
    • Implemented automatic cleanup to retain only the three most recent log files.
  • Improved error resolution guidance – Enhanced error messaging and added detailed resolution steps for common problems, including replication failures.

  • Stricter static IP validation – Added error handling to prevent Network Interface Card (NIC) creation if the specified static IP is outside the defined pool range.

  • Generation 1 VM Guest Management Enablement Message – Added a warning message in the portal to ensure that generation 1 VMs are powered off before enabling guest management.

    Screenshot showing the warning message in the portal when enabling guest management on generation 1 VMs.

May 2025

This release includes these features and improvements:

  • Improved error messaging - Improved service error messaging, recommended actions, and troubleshooting guidance.
  • Bug fix for missing resources – Fixed bug to surface NotFound errors for missing Azure Local resources.
  • Appliance error improvements – Updated appliance error messages to correctly identify which migrate appliance is unresponsive.
  • Static IP support enhancements – Enabled static IP migrations to support multiple IP pools on a single logical network.

April 2025

This release includes these features and improvements:

  • Linux VM static IP migration support – Azure Migrate to Azure Local migrations now offers scripts that preserve static IP addresses during Linux virtual machine (VM) migrations. See Maintain static IP addresses during migration.

Note

Although Linux VM static IP migration support was introduced in April 2025, migration package scripts are still required to preserve static IP settings.

  • Customizable physical sector size on migrated disks – You can now select either 512B or 4KB physical sector sizes for migrated disks, enabling better alignment with your workload and storage configuration.

  • Critical bug fixes – Resolved several user-reported issues, including:

    • An Azure portal issue where more than 10 VMs weren't displayed on the Replication summary page.

    • A timeout bug affecting certain migrations.

  • User experience enhancements – Multiple UX improvements were introduced to streamline migration workflows:

    • Added a banner in the Select VMs for replication view that explains how to enable VMs for replication.

    • Implemented a paginated Replication Summary view to improve performance and searchability.

  • Documentation updates – Updated screenshots and guidance throughout the Azure Migrate documentation to reflect the latest portal UI and feature set.

March 2025

This release includes these features and improvements:

  • Critical bug fixes (released in version 2503) – Azure Local version 2503 includes fixes for two major issues that previously affected migrated VMs:

    • A bug that prevented cleanup of the seed ISO on generation 1 VMs, resulting in migration failure.

    • An issue where VMs failed to migrate due to a gallery image provisioning failure.

    View the full list of Fixed issues in 2503.

  • Smarter replication experience – Starting with this release, Azure portal automatically includes or excludes VMs from replication based on migration eligibility. This improvement reduces setup errors and simplifies replication.

  • Expanded target resource group options – You can now create and select VM resource groups across subscriptions, not just within the Azure Local target instance's resource group, thus giving you more flexibility in how and where VMs are deployed.

    Screenshot showing the Replicate screen in Azure Migrate.

  • Enhanced security – This release has backend API updates to improve the security posture of Azure Migrate to Azure Local.

  • More resilient error handling – This release has improved handling of common failure scenarios, including:

    • Auto-cancelling Azure Arc operations that exceed expected completion times.

    • Preserving data integrity during retries of failed migrations.

  • Improved error messaging – This release includes enhanced error messages with clearer explanations and actionable resolution steps.