AzureInPlaceUpgrade
Commands
Every cmdlet with its syntax, parameters, required permissions and examples — generated from the module's own help, so this page and Get-Help can never disagree.
Install-Module AzureInPlaceUpgrade -AllowPrereleaseTest-InPlaceUpgradeReadinessRun the read-only preflight for an in-place upgrade of one Azure VMNeeds Microsoft.Compute/virtualMachines/read, Microsoft.Compute/virtualMachines/instanceView/read, Microsoft.Compute/virtualMachines/runCommand/action, Microsoft.Compute/locations/publishers/artifacttypes/offers/skus/versions/read (Reader is not enough because of runCommand/action; Virtual Machine Contributor is far more than needed - use a custom role with these four actions)Start-InPlaceUpgradeSnapshot one Azure VM, attach the upgrade media and start Windows Setup unattendedNeeds Microsoft.Compute/virtualMachines/read, write, instanceView/read, runCommand/action; Microsoft.Compute/disks/read, write, delete; Microsoft.Compute/snapshots/read, write; Microsoft.Compute/locations/publishers/artifacttypes/offers/skus/versions/read; Microsoft.Resources/subscriptions/resourceGroups/read (the Bicep deployment ships a custom role with these actions plus Microsoft.Resources/tags/write, which the runbook - not this function - needs)Complete-InPlaceUpgradeCheck a VM whose upgrade was started and report Completed, InProgress or FailedNeeds Microsoft.Compute/virtualMachines/read, write, instanceView/read, runCommand/action; Microsoft.Compute/disks/read, deleteInvoke-InPlaceUpgradeStart an in-place upgrade and wait for it to finish, in one callNeeds The union of Start-InPlaceUpgrade and Complete-InPlaceUpgradeGet-InPlaceUpgradeTargetResolve an upgrade target and its supported source versions from the target matrixNeeds no permissions