Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Applies to: ✔️ Windows VMs
Overview
This PowerShell script is designed to assess the readiness of a Windows machine (desktop or server) for an in-place OS upgrade, with special considerations for Azure VMs. It evaluates OS version, supported upgrade paths, system disk space, and Azure security features like Trusted Launch, Secure Boot, and virtual trusted platform modules (vTPMs).
Features
- OS version detection
- Identifies whether the system is Windows 10, 11, or a Windows Server edition.
- Server upgrade path check
- Matches current server version to supported upgrade targets.
- Hardware validation
- Disk space (greater than or equal to 64 GB).
- Physical memory (greater than or equal to 4 GB).
- Azure VM security feature verification
- Trusted Launch.
- Secure Boot.
- vTPM.
- Azure Virtual Desktop detection
- Flags unsupported pooled host pool configurations.
- Upgrade recommendations
- Outputs supported upgrade paths or relevant upgrade guidance.
For more information, see Azure VM Windows OS Upgrade Assessment Script.
How to run the tool
You can run the tool in any of the following manners.
1. Download from GitHub and run within the VM
Download the scripts from GitHub and then run them manually. To access the scripts, follow the resource links in the previous sections.
2. Use prepackaged run command scripts
For more information, see Run scripts in your Windows VM by using action run commands.
Recommended workflow
- Run
Windows_OSUpgrade_Assessment_Validationto verify the OS can be upgraded. - Apply the suggested fixes or refer to the official documentation.
Additional resources
- In-place upgrade (server) for VMs running Windows Server in Azure
- In-place upgrade (client) for VMs running Windows in Azure
Contact us for help
If you have questions, you can ask Azure community support. You can also submit product feedback to Azure feedback community.
Third-party contact disclaimer
Microsoft provides third-party contact information to help you find additional information about this topic. This contact information may change without notice. Microsoft does not guarantee the accuracy of third-party contact information.