Dev tracker: VM Gen1-to-Gen2 conversion toolkit

[kristopherjturner]

Solution: VM Generation 1 to Generation 2 Conversion Toolkit

Tracking issue for the overall development of the VM conversion toolkit for Azure Local.

Current Status

• Repository structure and standards (Plan 1)
• MkDocs Material documentation site deployed (Plan 2 — migrated from AsciiDoc)
• CI/CD with GitHub Actions (deploy-docs.yml)
• Vale linting integrated
• Documentation migrated from AsciiDoc to Markdown
• PowerShell scripts for Azure Local conversion path (scripts/azurelocal/)
• PowerShell scripts for Hyper-V conversion path (scripts/hyperv/)
• Script refinement and testing:
  • 01-Setup-ConversionEnvironment.ps1
  • 02-Convert-MBRtoGPT.ps1
  • 03-Convert-Gen1toGen2.ps1
  • 04-Batch-ConvertVMs.ps1
  • 05-Reconnect-AzureLocalVM.ps1
• Pester test coverage for all scripts
• CI pipeline for script validation
• Error handling and rollback improvements
• Logging standardization
• Documentation — prerequisites deep dive
• Documentation — troubleshooting guide expansion
• Documentation — batch conversion best practices
• Support for additional VM configurations (Linux, data disks, etc.)

Conversion Paths

1. Azure Local — Convert Arc VMs from Gen1 to Gen2 in-place
2. Hyper-V — Convert standalone Hyper-V VMs from Gen1 to Gen2

Key Docs

• Gen1 vs Gen2 differences
• Azure Local runbook
• Hyper-V runbook