Skip to content

Azure Local VM Conversion Toolkit ​

Azure Local VM Conversion Toolkit

WARNING

Work in progress, not yet verified end to end on a live cluster. Do not use in production. Script 05 runs az stack-hci-vm reconnect-to-azure and needs a stack-hci-vm extension version that provides it (az stack-hci-vm -h). The Hyper-V path does not use Azure. Version 0.1.0, not released or tagged.

Azure Migrate keeps the source generation (a Gen 1 source stays Gen 1), and Gen 1 VMs have limitations in Azure Local VM management. That is why this toolkit exists. If Gen 1 is acceptable, Azure Migrate (with its Arc-reuse feature) is the tool for that.

Convert Gen 1 virtual machines to Gen 2 on Azure Local and Hyper-V environments.

Overview ​

This toolkit provides automated scripts for converting Generation 1 VMs to Generation 2, enabling UEFI boot, Secure Boot, vTPM, and Trusted Launch capabilities.

WARNING

Conversion is a destructive, one-way operation. Always take full backups before proceeding. Read the Gen 1 vs Gen 2 guide before deciding to convert.

Quick Navigation ​

GuideDescription
Gen 1 vs Gen 2Understand the differences and decide whether to convert
PrerequisitesSystem requirements and preparation checklist
Getting StartedChoose your conversion path and get started
Azure Local RunbookStep-by-step conversion on Azure Local
Hyper-V RunbookStep-by-step conversion on standalone Hyper-V
TroubleshootingCommon issues and solutions

Repository ​

Released under the MIT License.