Mettre à niveau le système d’exploitation Azure Stack HCI, version 22H2 vers la version 23H2 via PowerShell

2025-07-07

S’applique à : Azure Local 2311.2 et les versions ultérieures

Importante

Azure Stack HCI, version 22H2 atteint la fin du support le 31 mai 2025. Après cette date :

Les mises à jour de sécurité et de qualité mensuelles s’arrêtent.
La facturation continue pour les systèmes version 22H2.
Votre système continue de fonctionner, y compris l’inscription et la réparation.
Le support Microsoft reste disponible uniquement pour l’assistance de mise à niveau.

Pour rester pris en charge et continuer à recevoir des mises à jour, nous vous recommandons de mettre à niveau votre système d’exploitation vers la version 23H2. Si vous exécutez un cluster étendu Azure Stack HCI version 22H2 ou que vous gérez Azure Local via System Center - Virtual Machine Manager, passez en revue la table des charges de travail et des configurations prises en charge pour connaître les chronologies de mise à jour.

Cet article explique comment mettre à niveau le système d’exploitation pour Azure Local de la version 22H2 vers la version 23H2 via PowerShell, qui est la méthode recommandée pour mettre à niveau le système d’exploitation. Il s’agit de la première étape du processus de mise à niveau, qui met à niveau uniquement le système d’exploitation.

Il existe d’autres méthodes pour mettre à niveau le système d’exploitation qui incluent l’utilisation de Windows Admin Center et de l’outil de configuration du serveur (SConfig). Pour plus d’informations sur ces méthodes, consultez Mettre à niveau le système d’exploitation Azure Stack HCI, version 22H2 du système d’exploitation via Windows Admin Center et Mettre à niveau Azure Local vers un nouveau système d’exploitation à l’aide d’autres méthodes.

Tout au long de cet article, nous faisons référence au système d’exploitation version 23H2 comme nouvelle version et version 22H2 comme ancienne version.

Importante

Pour maintenir votre service local Azure dans un état pris en charge, vous avez jusqu’à six mois pour installer cette nouvelle version du système d’exploitation. La mise à jour s’applique à toutes les instances locales Azure exécutant la version 22H2. Nous vous recommandons vivement d’installer cette version dès qu’elle sera disponible.

Flux de travail de haut niveau pour la mise à niveau du système d’exploitation

La mise à jour du système d’exploitation Azure Stack HCI est disponible via Windows Update et via le média que vous pouvez télécharger à partir du Portail Azure.

Pour mettre à niveau le système d’exploitation sur votre système, procédez comme suit :

Remplissez les conditions préalables.
Mettez à jour les clés de Registre.
Connectez-vous à Azure Local, version 22H2.
Recherchez les mises à jour disponibles à l’aide de PowerShell.
Installez un nouveau système d’exploitation à l’aide de PowerShell.
Vérifiez l’état des mises à jour.
Après la mise à niveau du système d'exploitation, effectuez les étapes post-mise à niveau.

Répondre aux prérequis

Avant de commencer, assurez-vous que :

Vous avez accès à une version 22H2 d’Azure Local en cours d’exécution.
Le système est inscrit dans Azure.
Toutes les machines de votre instance Azure Local, version 22H2 sont saines et s’affichent en ligne.
Vous arrêtez des machines virtuelles (VMs). Nous vous recommandons d’arrêter les machines virtuelles avant d’effectuer la mise à niveau du système d’exploitation pour éviter des pannes inattendues et des dommages aux bases de données.
Vous avez accès à la mise à jour logicielle du système d’exploitation Azure Stack HCI version 23H2 pour Azure Local. Cette mise à jour est disponible via Windows Update ou en tant que média téléchargeable. Le média doit être le fichier ISO version 2503 que vous pouvez télécharger à partir du portail Azure.
Vous avez accès à un client qui peut se connecter à votre instance Locale Azure. Ce client doit exécuter PowerShell 5.0 ou version ultérieure.
Vous exécutez l’applet RepairRegistration de commande uniquement si les deux conditions suivantes s’appliquent :
- La propriété d’identité est manquante ou ne contient type = "SystemAssigned"pas .
  - Vérifiez cela dans le json de ressource dans le portail Azure
  - Ou exécutez l’applet Get-AzResource -Name <cluster_name> de commande PowerShell
- Le groupe de cluster Gestion cloud n’est pas présent. Vérifiez-le en exécutant l’applet Get-ClusterGroup de commande PowerShell.
Si ces deux conditions sont remplies, exécutez le cmdlet RepairRegistration :
```
Register-AzStackHCI -TenantId "<tenant_ID>" -SubscriptionId "<subscription_ID>" -ComputerName "<computer_name>" -RepairRegistration
```
(Recommandé) Vous activez le démarrage sécurisé sur les machines locales Azure avant de mettre à niveau le système d’exploitation. Pour activer le démarrage sécurisé, procédez comme suit :
1. Videz le nœud du cluster.
2. Redémarrez le système d’exploitation.
3. Entrez le menu BIOS/UEFI.
4. Passez en revue la section Démarrage ou sécurité des options de configuration UEFI Recherchez l’option Démarrage sécurisé.
5. Définissez l’option sur Activé ou Activé.
6. Enregistrez les modifications et redémarrez votre ordinateur.
Contactez votre fournisseur de matériel pour obtenir de l’aide si nécessaire.

Remarque

Le fichier ISO 2503 n’est requis que si les machines n’ont pas accès à Windows Update pour télécharger la mise à jour des fonctionnalités du système d’exploitation. Si vous utilisez cette méthode, après vous être connecté à Azure Local, version 22H2, passez à l’étape 6 sous l’étape 2 : Installez le nouveau système d’exploitation à l’aide de PowerShell et effectuez les étapes restantes. L'utilisation d'outils tiers pour installer les mises à niveau n'est pas prise en charge.

Étape 0 : Mettre à jour les clés de Registre

Pour garantir que le système de fichiers résilient (ReFS) et les migrations dynamiques fonctionnent correctement pendant et après la mise à niveau du système d’exploitation, procédez comme suit sur chaque ordinateur du système pour mettre à jour les clés de Registre. Redémarrez chaque ordinateur pour que les modifications prennent effet.

Défini RefsEnableMetadataValidation sur 0:

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

Créez la clé de paramètres s’il n’existe pas. S’il existe déjà, la commande peut échouer avec une erreur, ce qui est attendu.
```
New-Item -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters
```

Défini SkipSmallLocalAllocations sur 0:

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

Redémarrez l’ordinateur pour que les modifications prennent effet. Au redémarrage de la machine, si la clé RefsEnableMetadataValidation est remplacée et que les volumes ReFS ne parviennent pas à se connecter, basculez la clé en réglant d’abord RefsEnableMetadataValidation sur 1, puis revenez à 0 à nouveau.
Mettez à jour et vérifiez que les clés de Registre ont été appliquées sur chaque ordinateur du système avant de passer à l’étape suivante.

Étape 1 : Se connecter à Azure Local

Suivez ces étapes sur votre client pour vous connecter à l’une des machines de votre instance locale Azure.

Exécutez PowerShell en tant qu’administrateur sur le client que vous utilisez pour vous connecter à votre système.

Ouvrez une session PowerShell distante sur une machine sur votre instance Locale Azure. Exécutez la commande suivante et fournissez les informations d’identification de votre machine lorsque vous y êtes invité :

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

Voici un exemple de résultat :

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>

Étape 2 : Installer un nouveau système d’exploitation à l’aide de PowerShell

Pour installer le nouveau système d’exploitation à l’aide de PowerShell, procédez comme suit :

Remarque

Les étapes suivantes nécessitent l’installation et l’activation du rôle Mise à jour prenant en charge le cluster (CAU) sur le système. Pour plus d’informations sur l’installation et l’activation de cette fonctionnalité sur votre local Azure, consultez Cluster-Aware Vue d’ensemble de la mise à jour.

Exécutez les applets de commande suivantes sur chaque ordinateur du système.
```
Set-WSManQuickConfig
Enable-PSRemoting
```
Pour vérifier si le système est correctement configuré pour appliquer des mises à jour logicielles à l’aide de la mise à jour prenant en charge le cluster(CAU), exécutez l’applet Test-CauSetup de commande, ce qui vous avertit des avertissements ou des erreurs :
```
Test-CauSetup -ClusterName <System name>
```
Validez le matériel et les paramètres en exécutant l’applet Test-Cluster de commande sur l’une des machines du système. Si l’une des vérifications de condition échoue, résolvez-les avant de passer à l’étape suivante.
```
Test-Cluster
```
Recherchez les mises à jour disponibles :
```
Invoke-CauScan -ClusterName <SystemName> -CauPluginName "Microsoft.RollingUpgradePlugin" -CauPluginArguments @{'WuConnected'='true';} -Verbose | fl *
```
Inspectez la sortie de l’applet de commande ci-dessus et vérifiez que chaque machine offre la même mise à jour des fonctionnalités, ce qui doit être le cas.
Vous avez besoin d’une machine ou d’une machine virtuelle distincte en dehors du système pour exécuter l’applet Invoke-CauRun de commande. Un ordinateur distinct garantit que l’orchestration n’est pas interrompue lorsque les machines sont redémarrés.

Importante

Le système sur lequel vous exécutez Invoke-CauRun doit exécuter Windows Server 2022.
```
Invoke-CauRun -ClusterName <SystemName> -CauPluginName "Microsoft.RollingUpgradePlugin" -CauPluginArguments @{'WuConnected'='true';} -Verbose -EnableFirewallRules -Force
```
Si le système n’est pas connecté à Windows Update et que le média d’installation local Azure est disponible sur un partage local, CAU peut également être utilisé pour mettre à niveau le système. Veillez à mettre à jour le paramètre 'PathToSetupMedia' avec le chemin de partage vers l’image ISO.
```
Invoke-CauRun –ClusterName <SystemName> -CauPluginName Microsoft.RollingUpgradePlugin -CauPluginArguments @{ 'WuConnected'='false';'PathToSetupMedia'='\some\path\'; 'UpdateClusterFunctionalLevel'='true'; } -Force
```
Recherchez d’autres mises à jour et installez-les.

Attendez la fin de la mise à jour et vérifiez l’état de la mise à jour.

Étape 3 : Vérifier l’état d’une mise à jour

Pour obtenir les informations récapitulatives relatives à une mise à jour en cours, exécutez l’applet Get-CauRun de commande :

Get-CauRun -ClusterName <SystemName>

Voici un exemple de sortie :

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[] 
}

Validez l’intégrité de votre système en exécutant l’applet Test-Cluster de commande sur l’une des machines du système. Si l’une des vérifications de condition échoue, résolvez-les avant de passer à l’étape suivante.
```
Test-Cluster
```
Vérifiez que les clés de Registre sont toujours appliquées sur chaque ordinateur du système avant de passer à l’étape suivante.

Pour vérifier si la clé de Registre existe :
```
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" 
```
Pour réappliquer les clés de Registre si nécessaire et redémarrer chaque ordinateur pour que les modifications prennent effet :
```
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" -Value 0 -Type DWord  -ErrorAction Stop
```
Si la mise à niveau du système d’exploitation échoue, exécutez la commande suivante pour récupérer l'exécution de CAU :
```
Invoke-CauRun –ForceRecovery -Force
```

Vous êtes maintenant prêt à effectuer les étapes postérieures à la mise à niveau du système d’exploitation.

Étapes suivantes

Découvrez comment effectuer les étapes de mise à niveau après le système d’exploitation pour votre instance Azure Local.