Skip to content

Commit 893efc9

Browse files
Merge pull request #17996 from ManikaDhiman/md-upgrade-tweaks
Revised Upgrade prereqs
2 parents 63d7ea1 + 752405f commit 893efc9

File tree

3 files changed

+27
-6
lines changed

3 files changed

+27
-6
lines changed

azure-local/upgrade/upgrade-22h2-to-23h2-other-methods.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Upgrade Azure Stack HCI OS, version 22H2 to version 23H2 via other method
33
description: Learn how to upgrade from Azure Stack HCI OS, version 22H2 to version 23H2 using other manual methods on Azure Local.
44
author: alkohli
55
ms.topic: how-to
6-
ms.date: 05/19/2025
6+
ms.date: 05/21/2025
77
ms.author: alkohli
88
ms.reviewer: alkohli
99
ms.service: azure-local
@@ -49,7 +49,14 @@ Before you begin, make sure that:
4949
- You shut down virtual machines (VMs). We recommend shutting down VMs before performing the OS upgrade to prevent unexpected outages and damages to databases.
5050
- You have access to the Azure Stack HCI OS, version 23H2 software update. This update is available via Windows Update or as a downloadable media. The media must be version **2503** ISO that you can download from the [Azure portal](https://portal.azure.com/#view/Microsoft_Azure_HybridCompute/AzureArcCenterBlade/~/hciGetStarted).
5151
- You have access to a client that can connect to your Azure Local. This client should be running PowerShell 5.0 or later.
52-
- You run the repair registration cmdlet:
52+
- You run the `RepairRegistration` cmdlet only if both of the following conditions apply:
53+
54+
- The *identity* property is either missing or doesn’t contain `type = "SystemAssigned"`.
55+
- Check this in the Resource JSON in the Azure portal
56+
- Or run the `Get-AzResource -Name <cluster_name>` PowerShell cmdlet
57+
- The **Cloud Management** cluster group is not present. Check it by running the `Get-ClusterGroup` PowerShell cmdlet.
58+
59+
If both these conditions are met, run the `RepairRegistration` cmdlet:
5360

5461
```powershell
5562
Register-AzStackHCI -TenantId "<tenant_ID>" -SubscriptionId "<subscription_ID>" -ComputerName "<computer_name>" -RepairRegistration

azure-local/upgrade/upgrade-22h2-to-23h2-powershell.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Upgrade Azure Stack HCI OS, version 22H2 to version 23H2 via PowerShell
33
description: Learn how to use PowerShell to upgrade Azure Stack HCI OS, version 22H2 to version 23H2.
44
author: alkohli
55
ms.topic: how-to
6-
ms.date: 05/19/2025
6+
ms.date: 05/21/2025
77
ms.author: alkohli
88
ms.reviewer: alkohli
99
ms.service: azure-local
@@ -48,7 +48,14 @@ Before you begin, make sure that:
4848
- You shut down virtual machines (VMs). We recommend shutting down VMs before performing the OS upgrade to prevent unexpected outages and damages to databases.
4949
- You have access to the Azure Stack HCI, version 23H2 OS software update for Azure Local. This update is available via Windows Update or as a downloadable media. The media must be version **2503** ISO file that you can download from the [Azure portal](https://portal.azure.com/#view/Microsoft_Azure_HybridCompute/AzureArcCenterBlade/~/hciGetStarted).
5050
- You have access to a client that can connect to your Azure Local instance. This client should be running PowerShell 5.0 or later.
51-
- You run the repair registration cmdlet:
51+
- You run the `RepairRegistration` cmdlet only if both of the following conditions apply:
52+
53+
- The *identity* property is either missing or doesn’t contain `type = "SystemAssigned"`.
54+
- Check this in the Resource JSON in the Azure portal
55+
- Or run the `Get-AzResource -Name <cluster_name>` PowerShell cmdlet
56+
- The **Cloud Management** cluster group is not present. Check it by running the `Get-ClusterGroup` PowerShell cmdlet.
57+
58+
If both these conditions are met, run the `RepairRegistration` cmdlet:
5259

5360
```powershell
5461
Register-AzStackHCI -TenantId "<tenant_ID>" -SubscriptionId "<subscription_ID>" -ComputerName "<computer_name>" -RepairRegistration

azure-local/upgrade/upgrade-22h2-to-23h2-windows-admin-center.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Upgrade Azure Stack HCI OS, version 22H2 to version 23H2 via Windows Admi
33
description: Learn how to upgrade Azure Stack HCI OS, version 22H2 to version 23H2 using Windows Admin Center.
44
author: alkohli
55
ms.topic: how-to
6-
ms.date: 05/19/2025
6+
ms.date: 05/21/2025
77
ms.author: alkohli
88
ms.reviewer: alkohli
99
ms.service: azure-local
@@ -47,7 +47,14 @@ Before you begin, make sure that:
4747
- You shut down virtual machines (VMs). We recommend shutting down VMs before performing the OS upgrade to prevent unexpected outages and damages to databases.
4848
- You have access to the Azure Stack HCI OS, version 23H2 software update. This update is available via Windows Update or as a downloadable media. The media must be version **2503** ISO that you can download from the [Azure portal](https://portal.azure.com/#view/Microsoft_Azure_HybridCompute/AzureArcCenterBlade/~/hciGetStarted).
4949
- You have access to a client that can connect to your Azure Local instance. This client should have Windows Admin Center installed on it. For more information, see [Install Windows Admin Center](/windows-server/manage/windows-admin-center/deploy/install).
50-
- You run the repair registration cmdlet:
50+
- You run the `RepairRegistration` cmdlet only if both of the following conditions apply:
51+
52+
- The *identity* property is either missing or doesn’t contain `type = "SystemAssigned"`.
53+
- Check this in the Resource JSON in the Azure portal
54+
- Or run the `Get-AzResource -Name <cluster_name>` PowerShell cmdlet
55+
- The **Cloud Management** cluster group is not present. Check it by running the `Get-ClusterGroup` PowerShell cmdlet.
56+
57+
If both these conditions are met, run the `RepairRegistration` cmdlet:
5158

5259
```powershell
5360
Register-AzStackHCI -TenantId "<tenant_ID>" -SubscriptionId "<subscription_ID>" -ComputerName "<computer_name>" -RepairRegistration

0 commit comments

Comments
 (0)