Aggiornare il sistema operativo Azure Stack HCI versione 22H2 alla versione 23H2 tramite PowerShell

2025-07-07

Si applica a: Azure Local 2311.2 e versioni successive

Importante

Azure Stack HCI, versione 22H2 raggiungerà la fine del supporto il 31 maggio 2025. Dopo questa data:

Gli aggiornamenti mensili di sicurezza e qualità si fermano.
La fatturazione continua per i sistemi 22H2.
Il sistema continua a funzionare, inclusa la registrazione e la riparazione.
Il supporto tecnico Microsoft rimane disponibile solo per l'assistenza per l'aggiornamento.

Per rimanere supportati e continuare a ricevere gli aggiornamenti, è consigliabile aggiornare il sistema operativo alla versione 23H2. Se si esegue un cluster esteso di Azure Stack HCI versione 22H2 o si gestisce Un cluster locale di Azure tramite System Center Virtual Machine Manager, vedere la tabella Carichi di lavoro e configurazioni supportati per le sequenze temporali degli aggiornamenti.

Questo articolo descrive come aggiornare il sistema operativo (OS) per Azure Local dalla versione 22H2 alla versione 23H2 tramite PowerShell, che è il metodo consigliato per aggiornare il sistema operativo. Questo è il primo passaggio del processo di aggiornamento, che aggiorna solo il sistema operativo.

Esistono altri metodi per aggiornare il sistema operativo che includono l'uso di Windows Admin Center e lo strumento di configurazione del server (SConfig). Per altre informazioni su questi metodi, vedere Aggiornare il sistema operativo Azure Stack HCI versione 22H2 tramite Windows Admin Center e Aggiornare Azure locale a un nuovo sistema operativo usando altri metodi.

In questo articolo si fa riferimento alla versione del sistema operativo 23H2 come la nuova versione e la versione 22H2 come la versione precedente .

Importante

Per mantenere il servizio locale di Azure in uno stato supportato, sono disponibili fino a sei mesi per installare questa nuova versione del sistema operativo. L'aggiornamento è applicabile a tutte le istanze locali di Azure che eseguono la versione 22H2. È consigliabile installare questa versione non appena diventa disponibile.

Flusso di lavoro generale per l'aggiornamento del sistema operativo

L'aggiornamento del sistema operativo Azure Stack HCI è disponibile tramite Windows Update e tramite i supporti che è possibile scaricare dal portale di Azure.

Per aggiornare il sistema operativo, seguire questi passaggi generali:

Completare i prerequisiti.
Aggiornare le chiavi del Registro di sistema.
Connettersi ad Azure Locale versione 22H2.
Verificare la disponibilità di aggiornamenti con PowerShell.
Installare un nuovo sistema operativo con PowerShell.
Controllare lo stato degli aggiornamenti.
Dopo l'aggiornamento del sistema operativo, eseguire i passaggi successivi all'aggiornamento del sistema operativo.

Completare prerequisiti

Prima di iniziare, verificare che:

Hai accesso a un'istanza locale di Azure che esegue la versione 22H2.
Il sistema è registrato in Azure.
Tutti i computer nell'istanza locale di Azure, versione 22H2 sono integri e vengono visualizzati come Online.
Tu arresti le macchine virtuali. È consigliabile arrestare le macchine virtuali prima di eseguire l'aggiornamento del sistema operativo per evitare interruzioni impreviste e danni ai database.
È possibile accedere all'aggiornamento software del sistema operativo Azure Stack HCI versione 23H2 per Azure Locale. Questo aggiornamento è disponibile tramite Windows Update o come supporto scaricabile. Il supporto deve essere la versione 2503 del file ISO che è possibile scaricare dal portale di Azure.
È possibile accedere a un client in grado di connettersi all'istanza locale di Azure. Questo client deve eseguire PowerShell 5.0 o versione successiva.
Eseguire il RepairRegistration cmdlet solo se si applicano entrambe le condizioni seguenti:
- La proprietà Identity è mancante o non contiene type = "SystemAssigned".
  - Controllare questo valore nel file JSON della risorsa nel portale di Azure
  - In alternativa, eseguire il Get-AzResource -Name <cluster_name> cmdlet di PowerShell
- Il gruppo di cluster Di gestione cloud non è presente. Controllarlo eseguendo il Get-ClusterGroup cmdlet di PowerShell.
Se vengono soddisfatte entrambe queste condizioni, eseguire il RepairRegistration cmdlet :
```
Register-AzStackHCI -TenantId "<tenant_ID>" -SubscriptionId "<subscription_ID>" -ComputerName "<computer_name>" -RepairRegistration
```
(Scelta consigliata) Prima di aggiornare il sistema operativo, abilitare l'avvio protetto nei computer locali di Azure. Per abilitare l'avvio protetto, seguire questa procedura:
1. Svuotare il nodo del cluster.
2. Riavviare il sistema operativo.
3. Immettere il menu BIOS/UEFI.
4. Esaminare la sezione Avvio o sicurezza delle opzioni di configurazione UEFI Individuare l'opzione Avvio protetto.
5. Impostare l'opzione su Abilitato o Attivato.
6. Salvare le modifiche e riavviare il computer.
Rivolgersi al fornitore dell'hardware per assistenza, se necessario.

Nota

Il file ISO 2503 è necessario solo se i computer non hanno accesso a Windows Update per scaricare l'aggiornamento delle funzionalità del sistema operativo. Se si usa questo metodo, dopo la connessione ad Azure Locale, versione 22H2, andare al passaggio 6 in Passaggio 2: Installare un nuovo sistema operativo usando PowerShell ed eseguire i passaggi rimanenti. L'uso di strumenti di terze parti per installare gli aggiornamenti non è supportato.

Passaggio 0: Aggiornare le chiavi del Registro di sistema

Per garantire il corretto funzionamento di Resilient File System (ReFS) e delle migrazioni in tempo reale durante e dopo l'aggiornamento del sistema operativo, seguire questa procedura in ogni computer del sistema per aggiornare le chiavi del Registro di sistema. Riavviare ogni computer per rendere effettive le modifiche.

Impostare RefsEnableMetadataValidation su 0:

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

Creare la chiave dei parametri se non esiste. Se esiste già, il comando potrebbe fallire generando un errore, come previsto.
```
New-Item -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters
```

Impostare SkipSmallLocalAllocations su 0:

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

Riavviare il computer per rendere effettive le modifiche. Al riavvio del computer, se la chiave RefsEnableMetadataValidation viene sovrascritta e i volumi ReFS non riescono a entrare in linea, modificare la voce impostandola prima su RefsEnableMetadataValidation e poi di nuovo su 1.
Aggiornare e verificare che le chiavi del Registro di sistema siano state applicate a ogni computer del sistema prima di passare al passaggio successivo.

Passaggio 1: Connettersi ad Azure Locale

Seguire questa procedura nel client per connettersi a uno dei computer dell'istanza locale di Azure.

Eseguire PowerShell come amministratore nel client usato per connettersi al sistema.

Aprire una sessione remota di PowerShell in un computer nell'istanza locale di Azure. Eseguire il comando seguente e specificare le credenziali del computer quando richiesto:

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

Di seguito è riportato un output di esempio:

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>

Passaggio 2: Installare un nuovo sistema operativo con PowerShell

Per installare il nuovo sistema operativo con PowerShell, seguire questa procedura:

Nota

I passaggi seguenti richiedono che il ruolo di "Aggiornamento Intelligente per il Cluster (CAU)" sia installato e abilitato nel sistema. Per informazioni su come installare e abilitare questa funzionalità in Locale di Azure, vedere Cluster-Aware Panoramica dell'aggiornamento.

Eseguire i cmdlet seguenti in ogni computer del sistema.
```
Set-WSManQuickConfig
Enable-PSRemoting
```
Per verificare se il sistema è configurato correttamente per applicare gli aggiornamenti software tramite Aggiornamento consapevole del cluster (CAU), eseguire il Test-CauSetup cmdlet, che ti informa di eventuali avvisi o errori.
```
Test-CauSetup -ClusterName <System name>
```
Convalidare l'hardware e le impostazioni eseguendo il Test-Cluster cmdlet in uno dei computer del sistema. Se uno dei controlli delle condizioni ha esito negativo, risolverle prima di procedere alla fase successiva.
```
Test-Cluster
```
Verificare la disponibilità degli aggiornamenti:
```
Invoke-CauScan -ClusterName <SystemName> -CauPluginName "Microsoft.RollingUpgradePlugin" -CauPluginArguments @{'WuConnected'='true';} -Verbose | fl *
```
Esaminare l'output del cmdlet precedente e verificare che a ogni computer sia offerto lo stesso Aggiornamento delle funzionalità, come dovrebbe essere.
Per eseguire il cmdlet, è necessario un computer o una macchina virtuale separata all'esterno del Invoke-CauRun sistema. Un computer separato garantisce che l'orchestrazione non venga interrotta quando i computer vengono riavviati.

Importante

Il sistema in cui si esegue Invoke-CauRun deve eseguire Windows Server 2022.
```
Invoke-CauRun -ClusterName <SystemName> -CauPluginName "Microsoft.RollingUpgradePlugin" -CauPluginArguments @{'WuConnected'='true';} -Verbose -EnableFirewallRules -Force
```
Se il sistema non è connesso a Windows Update e il supporto di installazione locale di Azure è disponibile in una condivisione locale, è possibile utilizzare CAU per aggiornare il sistema. Assicurarsi di aggiornare il 'PathToSetupMedia' parametro con il percorso di condivisione all'immagine ISO.
```
Invoke-CauRun –ClusterName <SystemName> -CauPluginName Microsoft.RollingUpgradePlugin -CauPluginArguments @{ 'WuConnected'='false';'PathToSetupMedia'='\some\path\'; 'UpdateClusterFunctionalLevel'='true'; } -Force
```
Verificare la presenza di altri aggiornamenti e installarli.

Attendere il completamento dell'aggiornamento e controllare lo stato dell'aggiornamento.

Passaggio 3: Controllare lo stato di un aggiornamento

Per ottenere le informazioni di riepilogo su un aggiornamento in corso, eseguire il Get-CauRun cmdlet :

Get-CauRun -ClusterName <SystemName>

Ecco un output di esempio:

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

Convalidare l'integrità del sistema eseguendo il Test-Cluster cmdlet in uno dei computer del sistema. Se uno dei controlli delle condizioni ha esito negativo, risolverle prima di procedere alla fase successiva.
```
Test-Cluster
```
Verificare che le chiavi del Registro di sistema siano ancora applicate a ogni computer del sistema prima di passare al passaggio successivo.

Per verificare se la chiave del Registro di sistema esiste:
```
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" 
```
Per riapplicare le chiavi del Registro di sistema, se necessario e riavviare ogni computer per rendere effettive le modifiche:
```
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" -Value 0 -Type DWord  -ErrorAction Stop
```
Se l'aggiornamento del sistema operativo non riesce, eseguire il comando seguente per ripristinare l'esecuzione di CAU:
```
Invoke-CauRun –ForceRecovery -Force
```

È ora possibile eseguire i passaggi di aggiornamento post-sistema operativo per il sistema.

Passaggi successivi

Informazioni su come eseguire i passaggi di aggiornamento post-sistema operativo per l'ambiente locale di Azure.