Skip to main content

Upgrade To Windows Supported OS

🚀 Windows OS Upgrade — Self‑Service Guide

Chapter “Upgrade” — Workstation Lifecycle: The Image Playbook

Use this procedure to run a hands‑off, in‑place upgrade to Windows 11 23H2—our current standard build—using the NinjaRMM script Windows 11 Upgrade. The script fetches the ISO, mounts it, and performs the upgrade entirely on its own.  Always schedule it outside client business hours.

0 ️⃣ Pre‑Flight Checklist

✅

Item

Why It Matters

☐

Capture backup 

completed (see Chapter 1)

Rollback safety net

☐

Device passes

 Windows 11 hardware check

TPM 2.0 & Secure Boot required

☐

≥ 30 GB free on

 C:\

ISO + temp files

☐

User logged off; workstation idle for 2–3 hrs

Prevents file‑lock issues

1 ️⃣ Locate & Launch the Script

  1. Sign in to NinjaRMM.
  2. Go to Automation → Scripts and search Windows 11 Upgrade.
  3. Select the script, choose the target device (or group), and click Run Script.
  4. Schedule it after hours if you’re not executing immediately.
    📸 Screenshot Placeholder – Run Script Dialog

No parameters are required—the script knows which ISO/build to use.

2 ️⃣ What the Script Does

Stage

Action

1

Downloads 

the Windows 11 23H2 ISO to

 %WINDIR%\Temp

.

2

Mounts 

the ISO and launches

 setup.exe /auto upgrade

.

3

Updates a custom device field

 Windows Upgrade Progress 

from 0 → 75 %.

4

Reboots 

and finishes the upgrade (no further reporting possible until reboot completes).

3 ️⃣ Monitoring Progress

  1. Open the device in Ninja and look for the custom field Windows Upgrade Progress.
  2. You’ll see it increment (0 %, 20 %, 45 %, 60 %, up to roughly 75 %).
  3. When it stops changing, the workstation is likely rebooting and completing the upgrade.
  4. Expect the entire process to take 60–90 minutes on SSD hardware.
    📸 Screenshot Placeholder – Custom Field Showing 60 %

4 ️⃣ Post‑Upgrade Validation

  1. After the device checks back in, open Endpoint Details.
  2. Confirm OS Build now shows Windows 11 Version 23H2.
    📸 Screenshot Placeholder – Endpoint Details (OS Build)

No additional application or peripheral testing is required; these were vetted during project planning.

5 ️⃣ Troubleshooting Quick Hits

Symptom

Likely Cause

Fix

Windows Upgrade Progress 

stalls at 0 %

ISO download blocked

Allow outbound to

 *.microsoft.com 

or use VPN.

Progress reaches 75 % but device never comes back

User powered off or BitLocker recovery screen

Remote power‑cycle / provide recovery key, then rerun script if needed.

Setup error 0xC1900101 in logs

Driver/firmware conflict

Update BIOS & drivers; ensure free disk space.


Back to top