Upgrade von Azure Stack HCI OS, Version 22H2 auf Version 23H2 über PowerShell

2025-07-07

Gilt für: Azure Local 2311.2 und höher

Wichtig

Azure Stack HCI, Version 22H2, wird am 31. Mai 2025 das Ende des Supports erreichen. Nach diesem Datum:

Monatliche Sicherheits- und Qualitätsupdates werden beendet.
Die Abrechnung wird für Version 22H2-Systeme fortgesetzt.
Ihr System funktioniert weiterhin, einschließlich Registrierung und Reparatur.
Der Microsoft-Support bleibt nur für Upgradeunterstützung verfügbar.

Um weiterhin Unterstützung zu erhalten und Updates zu beziehen, empfehlen wir, Ihr Betriebssystem auf Version 23H2 zu aktualisieren. Wenn Sie einen Stretch-Cluster mit Azure Stack HCI, Version 22H2, betreiben oder Azure Local über System Center – Virtual Machine Manager verwalten, entnehmen Sie der Tabelle "Unterstützte Workloads und Konfigurationen" Informationen zu den Zeitplänen für Updates.

In diesem Artikel wird beschrieben, wie Sie das Betriebssystem (Os) für Azure Local von Version 22H2 auf Version 23H2 über PowerShell aktualisieren. Dies ist die empfohlene Methode zum Upgrade des Betriebssystems. Dies ist der erste Schritt im Upgradeprozess, der nur das Betriebssystem aktualisiert.

Es gibt weitere Methoden zum Aktualisieren des Betriebssystems, das Windows Admin Center und das Serverkonfigurationstool (SConfig) enthält. Weitere Informationen zu diesen Methoden finden Sie unter Upgrade des Azure Stack HCI OS, Version 22H2 OS über Windows Admin Center und Upgrade von Azure Local auf ein neues Betriebssystem mit anderen Methoden.

In diesem Artikel beziehen wir uns auf die Betriebssystemversion 23H2 als neue Version und Version 22H2 als alte Version.

Wichtig

Damit Ihr lokaler Azure-Dienst in einem unterstützten Zustand bleibt, haben Sie bis zu sechs Monate Zeit, um diese neue Betriebssystemversion zu installieren. Das Update gilt für alle lokalen Azure-Instanzen, die Version 22H2 ausführen. Es wird dringend empfohlen, diese Version zu installieren, sobald sie verfügbar ist.

Hoher Workflow für das Betriebssystemupgrade

Das Azure Stack HCI-Betriebssystemupdate ist über das Windows Update und über die Medien verfügbar, die Sie aus dem Azure-Portal herunterladen können.

Führen Sie die folgenden allgemeinen Schritte aus, um das Betriebssystem auf Ihrem System zu aktualisieren:

Erfüllen Sie die Voraussetzungen.
Registrierungsschlüssel aktualisieren.
Stellen Sie eine Verbindung mit Azure Local, Version 22H2, her.
Suchen Sie mithilfe von PowerShell nach den verfügbaren Updates.
Installieren Sie ein neues Betriebssystem mit PowerShell.
Überprüfen Sie den Status der Updates.
Führen Sie nach dem Upgrade des Betriebssystems Schritte nach dem Upgrade des Betriebssystems aus.

Erfüllen der Voraussetzungen

Stellen Sie Folgendes sicher, bevor Sie beginnen:

Sie haben Zugriff auf eine azure Local running Version 22H2.
Das System wird in Azure registriert.
Alle Computer in Ihrer azure Local, Version 22H2-Instanz, sind fehlerfrei und werden als Online angezeigt.
Fahren Sie die virtuellen Computer (Virtual Machines, VM) herunter. Es wird empfohlen, virtuelle Computer vor dem Ausführen des Betriebssystemupgrades herunterzufahren, um unerwartete Ausfälle und Schäden an Datenbanken zu verhindern.
Sie haben Zugriff auf das Azure Stack HCI, Version 23H2 OS-Softwareupdate für Azure Local. Dieses Update ist über Windows Update oder als herunterladbare Medien verfügbar. Die Medien müssen version 2503 ISO-Datei sein, die Sie aus dem Azure-Portal herunterladen können.
Sie haben Zugriff auf einen Client, der eine Verbindung mit Ihrer lokalen Azure-Instanz herstellen kann. Dieser Client sollte PowerShell 5.0 oder höher ausführen.
Sie führen das RepairRegistration Cmdlet nur aus, wenn beide der folgenden Bedingungen gelten:
- Die Identitätseigenschaft fehlt oder enthält type = "SystemAssigned"nicht.
  - Überprüfen Sie dies im Ressourcen-JSON im Azure-Portal.
  - Oder führen Sie das Get-AzResource -Name <cluster_name> PowerShell-Cmdlet aus.
- Die Cloudverwaltungsclustergruppe ist nicht vorhanden. Überprüfen Sie dies, indem Sie das Get-ClusterGroup PowerShell-Cmdlet ausführen.
Wenn beide Bedingungen erfüllt sind, führen Sie das RepairRegistration Cmdlet aus.
```
Register-AzStackHCI -TenantId "<tenant_ID>" -SubscriptionId "<subscription_ID>" -ComputerName "<computer_name>" -RepairRegistration
```
(Empfohlen) Sie aktivieren den sicheren Start auf lokalen Azure-Computern, bevor Sie das Betriebssystem aktualisieren. Führen Sie die folgenden Schritte aus, um den sicheren Start zu aktivieren:
1. Entwässern Sie den Clusterknoten.
2. Starten Sie das Betriebssystem neu.
3. Geben Sie das BIOS/UEFI-Menü ein.
4. Überprüfen Sie den Abschnitt "Start " oder "Sicherheit " der UEFI-Konfigurationsoptionen, um die Option "Sicherer Start" zu finden.
5. Legen Sie die Option auf "Aktiviert " oder "Ein" fest.
6. Speichern Sie die Änderungen, und starten Sie den Computer neu.
Wenden Sie sich bei Bedarf an Ihren Hardwareanbieter, um Unterstützung zu erhalten.

Hinweis

Die ISO-Datei 2503 ist nur erforderlich, wenn die Computer keinen Zugriff auf Windows Update haben, um das Betriebssystemfeatureupdate herunterzuladen. Wenn Sie diese Methode verwenden, fahren Sie nach der Verbindung mit Azure Local, Version 22H2, mit Schritt 6 unter Schritt 2 fort : Installieren eines neuen Betriebssystems mit PowerShell und führen Sie die verbleibenden Schritte aus. Drittanbietertools zum Installieren von Upgrades werden nicht unterstützt.

Schritt 0: Aktualisieren von Registrierungsschlüsseln

Führen Sie die folgenden Schritte auf jedem Computer im System aus, um sicherzustellen, dass reFS (Resilient File System) und Livemigrationen während und nach dem Betriebssystemupgrade ordnungsgemäß funktionieren, um Registrierungsschlüssel zu aktualisieren. Starten Sie jeden Computer neu, damit die Änderungen wirksam werden.

Setze RefsEnableMetadataValidation auf 0:

Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" -Value 0 -Type DWord  -ErrorAction Stop

Erstellen Sie den Parameterschlüssel, falls er nicht vorhanden ist. Wenn er bereits vorhanden ist, schlägt der Befehl möglicherweise mit einem Fehler fehl, der erwartet wird.
```
New-Item -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters
```

Setze SkipSmallLocalAllocations auf 0:

New-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters -Name SkipSmallLocalAllocations -Value 0 -PropertyType DWord

Starten Sie den Computer neu, damit die Änderungen wirksam werden. Wenn der RefsEnableMetadataValidation-Schlüssel beim Neustart des Computers außer Kraft gesetzt wird und ReFS-Volumes nicht online geschaltet werden, schalten Sie den Schlüssel um, indem Sie zunächst RefsEnableMetadataValidation auf 1 und dann wieder auf 0 festlegen.
Aktualisieren und überprüfen Sie, ob die Registrierungsschlüssel auf jedem Computer im System angewendet wurden, bevor Sie zum nächsten Schritt wechseln.

Schritt 1: Herstellen einer Verbindung mit Azure Local

Führen Sie die folgenden Schritte auf Ihrem Client aus, um eine Verbindung mit einem der Computer Ihrer lokalen Azure-Instanz herzustellen.

Führen Sie PowerShell als Administrator auf dem Client aus, den Sie zum Herstellen einer Verbindung mit Ihrem System verwenden.

Öffnen Sie eine PowerShell-Remotesitzung auf einem Computer in Ihrer lokalen Azure-Instanz. Führen Sie den folgenden Befehl aus, und geben Sie die Anmeldeinformationen Ihres Computers an, wenn Sie dazu aufgefordert werden:

$cred = Get-Credential
Enter-PSSession -ComputerName "<Computer IP>" -Credential $cred

Hier ist eine Beispielausgabe:

PS C:\Users\Administrator> $cred = Get-Credential

cmdlet Get-Credential at command pipeline position 1
Supply values for the following parameters:
Credential
PS C:\Users\Administrator> Enter-PSSession -ComputerName "100.100.100.10" -Credential $cred 
[100.100.100.10]: PS C:\Users\Administrator\Documents>

Schritt 2: Installieren eines neuen Betriebssystems mit PowerShell

Führen Sie die folgenden Schritte aus, um das neue Betriebssystem mit PowerShell zu installieren:

Hinweis

Bei den folgenden Schritten muss die CAU-Rolle (Cluster-Aware Updating) installiert und auf dem System aktiviert sein. Informationen zum Installieren und Aktivieren dieses Features auf Ihrem lokalen Azure finden Sie in der Übersicht über clusterbasierte Aktualisierungen.

Führen Sie die folgenden Cmdlets auf jedem Computer im System aus.
```
Set-WSManQuickConfig
Enable-PSRemoting
```
Um zu testen, ob das System ordnungsgemäß für die Anwendung von Softwareupdates mit Cluster-Aware Updating (CAU) eingerichtet ist, führen Sie das Test-CauSetup Cmdlet aus, das Sie über Warnungen oder Fehler benachrichtigt:
```
Test-CauSetup -ClusterName <System name>
```
Überprüfen Sie die Hardware und Einstellungen, indem Sie das Test-Cluster Cmdlet auf einem der Computer im System ausführen. Wenn eine der Bedingungsprüfungen fehlschlägt, lösen Sie sie auf, bevor Sie mit dem nächsten Schritt fortfahren.
```
Test-Cluster
```
Suchen Sie nach den verfügbaren Updates:
```
Invoke-CauScan -ClusterName <SystemName> -CauPluginName "Microsoft.RollingUpgradePlugin" -CauPluginArguments @{'WuConnected'='true';} -Verbose | fl *
```
Überprüfen Sie die Ausgabe des obigen Cmdlets, und überprüfen Sie, ob jedem Computer das gleiche Featureupdate angeboten wird. Dies sollte der Fall sein.
Sie benötigen einen separaten Computer oder einen virtuellen Computer außerhalb des Systems, um das Invoke-CauRun Cmdlet auszuführen. Ein separater Computer stellt sicher, dass die Orchestrierung beim Neustart der Computer nicht unterbrochen wird.

Wichtig

Das System, auf dem Sie ausführen, muss Windows Server 2022 ausführen Invoke-CauRun .
```
Invoke-CauRun -ClusterName <SystemName> -CauPluginName "Microsoft.RollingUpgradePlugin" -CauPluginArguments @{'WuConnected'='true';} -Verbose -EnableFirewallRules -Force
```
Wenn das System nicht mit Windows Update verbunden ist und das lokale Azure-Installationsmedium auf einer lokalen Freigabe verfügbar ist, kann CAU auch zum Upgrade des Systems verwendet werden. Achten Sie darauf, den 'PathToSetupMedia' Parameter mit dem Freigabepfad zum ISO-Image zu aktualisieren.
```
Invoke-CauRun –ClusterName <SystemName> -CauPluginName Microsoft.RollingUpgradePlugin -CauPluginArguments @{ 'WuConnected'='false';'PathToSetupMedia'='\some\path\'; 'UpdateClusterFunctionalLevel'='true'; } -Force
```
Suchen Sie nach weiteren Updates, und installieren Sie diese.

Warten Sie, bis das Update abgeschlossen ist, und überprüfen Sie den Status des Updates.

Schritt 3: Überprüfen des Status eines Updates

Führen Sie das Get-CauRun Cmdlet aus, um die Zusammenfassungsinformationen zu einem update in Bearbeitung zu erhalten:

Get-CauRun -ClusterName <SystemName>

Hier ist eine Beispielausgabe:

RunId                   : <Run ID> 
RunStartTime            : 10/13/2024 1:35:39 PM 
CurrentOrchestrator     : NODE1 
NodeStatusNotifications : { 
Node      : NODE1 
Status    : Waiting 
Timestamp : 10/13/2024 1:35:49 PM 
} 
NodeResults             : { 
Node                     : NODE2 
Status                   : Succeeded 
ErrorRecordData          : 
NumberOfSucceededUpdates : 0 
NumberOfFailedUpdates    : 0 
InstallResults           : Microsoft.ClusterAwareUpdating.UpdateInstallResult[] 
}

Überprüfen Sie den Status Ihres Systems, indem Sie das Test-Cluster Cmdlet auf einem der Computer im System ausführen. Wenn eine der Bedingungsprüfungen fehlschlägt, lösen Sie sie auf, bevor Sie mit dem nächsten Schritt fortfahren.
```
Test-Cluster
```
Stellen Sie sicher, dass die Registrierungsschlüssel noch auf jedem Computer im System angewendet werden, bevor Sie zum nächsten Schritt wechseln.

So überprüfen Sie, ob der Registrierungsschlüssel vorhanden ist:
```
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" 
```
So wenden Sie die Registrierungsschlüssel bei Bedarf erneut an, und starten Sie jeden Computer neu, damit die Änderungen wirksam werden:
```
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" -Value 0 -Type DWord  -ErrorAction Stop
```
Wenn das Betriebssystemupgrade fehlschlägt, führen Sie den folgenden Befehl aus, um die CAU-Ausführung wiederherzustellen:
```
Invoke-CauRun –ForceRecovery -Force
```

Sie können jetzt die Upgradeschritte nach dem Betriebssystem für Ihr System ausführen.

Nächste Schritte

Erfahren Sie, wie Sie die Upgradeschritte nach dem Betriebssystem für Ihr Lokales Azure ausführen.