From 5b2268f6b45614b24bf5c6378b8858bb7d6e16b5 Mon Sep 17 00:00:00 2001 From: Manika Dhiman Date: Tue, 25 Nov 2025 11:58:59 -0800 Subject: [PATCH 1/3] Revised upgrade docs to clarify ISO extracted content --- .../upgrade-22h2-to-23h2-powershell.md | 28 +++++++++++++++---- 1 file changed, 23 insertions(+), 5 deletions(-) diff --git a/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md b/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md index 0af0332506..ade19e1f95 100644 --- a/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md +++ b/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md @@ -3,7 +3,7 @@ title: Upgrade Azure Stack HCI OS, version 22H2 to version 23H2 via PowerShell description: Learn how to use PowerShell to upgrade Azure Stack HCI OS, version 22H2 to version 23H2. author: alkohli ms.topic: how-to -ms.date: 10/08/2025 +ms.date: 11/25/2025 ms.author: alkohli ms.reviewer: alkohli ms.service: azure-local @@ -293,6 +293,24 @@ To install the new OS using PowerShell, follow these steps: Test-Cluster ``` +1. Extract the contents of the ISO image and copy them to the local system drive on each machine. Ensure that the local path is the same on each machine. Then, update the `PathToSetupMedia` parameter with the local path to the extracted ISO contents (not the ISO file). + + ```powershell + # Define ISO and destination folder for extracted contents + $isoFilePath = "C:\SetupFiles\WindowsServer\ISOs\example.iso" + $destinationPath = "C:\SetupFiles\WindowsServer\ExtractedFiles" + # Mount the ISO file + $iso = Mount-DiskImage -ImagePath $isoFilePath + # Get the drive letter + $driveLetter = ($iso | Get-Volume).DriveLetter + # Create the destination directory + New-Item -ItemType Directory -Path $destinationPath + # Copy contents to the local directory + Copy-Item -Path "${driveLetter}:\*" -Destination $destinationPath -Recurse + # Dismount the ISO file + Dismount-DiskImage -ImagePath $isoFilePath + ``` + 1. Check for the available updates: ```PowerShell @@ -348,12 +366,12 @@ To install the new OS using PowerShell, follow these steps: Test-Cluster ``` -1. Extract the contents of the ISO image and copy them to the local system drive on each machine. Ensure that the local path is the same on each machine. Then, update the `PathToSetupMedia` parameter with the local path to the ISO image. +1. Extract the contents of the ISO image and copy them to the local system drive on each machine. Ensure that the local path is the same on each machine. Then, update the `PathToSetupMedia` parameter with the local path to the extracted ISO contents (not the ISO file). ```powershell - # Define ISO and destination paths + # Define ISO and destination folder for extracted contents $isoFilePath = "C:\SetupFiles\WindowsServer\ISOs\example.iso" - $destinationPath = "C:\SetupFiles\WindowsServer\Files" + $destinationPath = "C:\SetupFiles\WindowsServer\ExtractedFiles" # Mount the ISO file $iso = Mount-DiskImage -ImagePath $isoFilePath # Get the drive letter @@ -361,7 +379,7 @@ To install the new OS using PowerShell, follow these steps: # Create the destination directory New-Item -ItemType Directory -Path $destinationPath # Copy contents to the local directory - Copy-Item -Path "${driveLetter}:\*" -Destination $destinationPath –Recurse + Copy-Item -Path "${driveLetter}:\*" -Destination $destinationPath -Recurse # Dismount the ISO file Dismount-DiskImage -ImagePath $isoFilePath ``` From b86ec95f594728da9cf8cbb30c78eab58775e1a8 Mon Sep 17 00:00:00 2001 From: Manika Dhiman Date: Tue, 25 Nov 2025 13:29:39 -0800 Subject: [PATCH 2/3] tweaks --- azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md b/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md index ade19e1f95..1ae803ee52 100644 --- a/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md +++ b/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md @@ -293,7 +293,7 @@ To install the new OS using PowerShell, follow these steps: Test-Cluster ``` -1. Extract the contents of the ISO image and copy them to the local system drive on each machine. Ensure that the local path is the same on each machine. Then, update the `PathToSetupMedia` parameter with the local path to the extracted ISO contents (not the ISO file). +1. Extract the contents of the ISO image and copy them to the local system drive on each machine. Ensure that the local path is the same on each machine. Then, update the `PathToSetupMedia` parameter with the local path to the extracted ISO contents, not the ISO file. ```powershell # Define ISO and destination folder for extracted contents @@ -366,7 +366,7 @@ To install the new OS using PowerShell, follow these steps: Test-Cluster ``` -1. Extract the contents of the ISO image and copy them to the local system drive on each machine. Ensure that the local path is the same on each machine. Then, update the `PathToSetupMedia` parameter with the local path to the extracted ISO contents (not the ISO file). +1. Extract the contents of the ISO image and copy them to the local system drive on each machine. Ensure that the local path is the same on each machine. Then, update the `PathToSetupMedia` parameter with the local path to the extracted ISO contents, not the ISO file. ```powershell # Define ISO and destination folder for extracted contents From 259e9acee5e2c27ba51148a2e1b7e0e9fa870c4b Mon Sep 17 00:00:00 2001 From: Manika Dhiman Date: Tue, 2 Dec 2025 14:46:42 -0800 Subject: [PATCH 3/3] tweaks --- azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md b/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md index 1ae803ee52..bf3ecf2109 100644 --- a/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md +++ b/azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md @@ -3,7 +3,7 @@ title: Upgrade Azure Stack HCI OS, version 22H2 to version 23H2 via PowerShell description: Learn how to use PowerShell to upgrade Azure Stack HCI OS, version 22H2 to version 23H2. author: alkohli ms.topic: how-to -ms.date: 11/25/2025 +ms.date: 12/02/2025 ms.author: alkohli ms.reviewer: alkohli ms.service: azure-local @@ -298,7 +298,7 @@ To install the new OS using PowerShell, follow these steps: ```powershell # Define ISO and destination folder for extracted contents $isoFilePath = "C:\SetupFiles\WindowsServer\ISOs\example.iso" - $destinationPath = "C:\SetupFiles\WindowsServer\ExtractedFiles" + $destinationPath = "C:\SetupFiles\WindowsServer\ExtractedFilesFolder" # Mount the ISO file $iso = Mount-DiskImage -ImagePath $isoFilePath # Get the drive letter @@ -371,7 +371,7 @@ To install the new OS using PowerShell, follow these steps: ```powershell # Define ISO and destination folder for extracted contents $isoFilePath = "C:\SetupFiles\WindowsServer\ISOs\example.iso" - $destinationPath = "C:\SetupFiles\WindowsServer\ExtractedFiles" + $destinationPath = "C:\SetupFiles\WindowsServer\ExtractedFilesFolder" # Mount the ISO file $iso = Mount-DiskImage -ImagePath $isoFilePath # Get the drive letter