Add example: Windows Server 2025 GEN1 platform image creation for Azure Stack Hub

[NeilBird]

Summary

Adds a new example under Support/create-ws2025-image-from-azure/ that walks Hub operators through downloading a Windows Server 2025 Datacenter GEN1 VHD from the Azure Marketplace and registering it as a platform image on Azure Stack Hub. This can be useful, as there is no Windows Server 2025 Marketplace image available for syndication from Azure marketplace for Azure Stack Hub.

Provided as an example only — not a supported service offering. MIT-licensed, AS-IS.

What's included

• Example_WS2025-create-image-from-Azure.ps1 — end-to-end script:

  1. Installs the required Az / AzureStack hybrid modules.
  2. Logs into public Azure via the Azure CLI and lists WS2025 GEN1 SKUs (excluding -gen2, -upgrade, and azure-edition).
  3. Creates a temp managed disk from the chosen marketplace image and downloads the VHD via AzCopy v10.
  4. Connects to the Hub admin ARM endpoint as Service Admin.
  5. Uploads the VHD to a Hub storage account.
  6. Registers it as a platform image (Add-AzsPlatformImage) and verifies.

  Supports -CleanAzModules, -ClearAzCliAccount, and -AzureLocation switches; destructive cleanup is off by default.

• _Pre-req_Install_AzCLI.ps1 — installs Azure CLI on Windows and adds it to PATH. Enforces #Requires -RunAsAdministrator and TLS 1.2.

• README.md — workflow diagram, prerequisites, parameter reference, optional-switch reference, and a detailed write-up of VM Licensing & Billing (LicenseType) vs Guest OS Activation (KMS) for WS2025 on Hub, including the supported LicenseType × activation-method matrix and common conflations.

Notes for reviewers

• Only GEN1 SKUs are surfaced (Hub doesn't support GEN2 platform images).
• README calls out two important prerequisites: the Service Admin account must be MFA-exempt (uses Connect-AzAccount -Credential), and the Hub admin endpoint certificate must be trusted on the workstation.
• No existing files are modified; this is purely additive under Support/.