From 6a7554ec5f470d4e2d1cf26996fddf86db2ce84b Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Sat, 21 Nov 2026 11:06:25 +0100 Subject: [PATCH] Document PowerShell prerequisites and separate runtime updates --- README.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/README.md b/README.md index b1b7d0b..b9c2087 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,28 @@ when you add software to the install list, or when you need to repair setup. Requires Windows 10 1809 or newer, Windows 11, or Windows Server 2025, with internet access and support for WinGet. +Setup installs PowerShell using the official MSI (`--installer-type wix`), which +bundles its .NET runtime. It checks that PowerShell starts before configuring the +checkout and pins the `cc` launcher to that executable. A broken existing +installation is reported for repair rather than silently replaced. If startup +asks for .NET, keep the full error and check which executable is being launched +with `Get-Command pwsh.exe -All` in Windows PowerShell; a .NET-tool installation +or a stale PATH entry can differ from the MSI installation. + +Config Central does not update PowerShell during apply or software updates, +because replacing its own runtime can interrupt the operation. Update PowerShell +separately with Config Central and PowerShell 7 sessions closed, using the original +installation method. For an MSI installation, run this from **Windows PowerShell**: + +```powershell +winget upgrade --id Microsoft.PowerShell --exact --source winget --installer-type wix +``` + +WinGet can recognize manually installed software too. Previously the base profile +requested PowerShell upgrades, which could replace that manual installation. +The installer logs are needed to establish why a particular upgrade left it missing. +See Microsoft's [PowerShell installation and upgrade guidance](https://learn.microsoft.com/en-us/powershell/scripting/install/install-powershell-on-windows). + ## 2. Update installed software Close applications that may be updated, open PowerShell as your normal desktop