Atualizar o sistema operacional do Azure Stack HCI, versão 22H2 para a versão 23H2 por meio do PowerShell

2025-07-07

Aplica-se a: Azure Local 2311.2 e posterior

Importante

O Azure Stack HCI, versão 22H2, chegará ao fim do suporte em 31 de maio de 2025. Após esta data:

As atualizações mensais de segurança e qualidade param.
A cobrança continua para sistemas versão 22H2.
O seu sistema continua operando, incluindo cadastramento e reparo.
O Suporte da Microsoft permanece disponível apenas para assistência de atualização.

Para manter o suporte e continuar recebendo atualizações, recomendamos atualizar o sistema operacional para a versão 23H2. Se você estiver executando um cluster de extensão do Azure Stack HCI, versão 22H2 ou gerenciando o Azure Local via System Center – Virtual Machine Manager, examine a tabela de cargas de trabalho e configurações com suporte para cronogramas de atualização.

Este artigo descreve como atualizar o sistema operacional (SO) para o Azure Local da versão 22H2 para a versão 23H2 por meio do PowerShell, que é o método recomendado para atualizar o sistema operacional. Esta é a primeira etapa no processo de atualização, que atualiza apenas o sistema operacional.

Há outros métodos para atualizar o sistema operacional que incluem o uso do Windows Admin Center e da ferramenta de configuração do servidor (SConfig). Para obter mais informações sobre esses métodos, consulte Atualizar o sistema operacional Azure Stack HCI, versão 22H2 por meio do Windows Admin Center e Atualizar o Azure Local para o novo sistema operacional usando outros métodos.

Ao longo deste artigo, nos referimos à versão 23H2 do sistema operacional como a nova versão e à versão 22H2 como a versão antiga .

Importante

Para manter o serviço local do Azure em um estado com suporte, você tem até seis meses para instalar essa nova versão do sistema operacional. A atualização é aplicável a todas as instâncias locais do Azure que executam a versão 22H2. Recomendamos fortemente que você instale esta versão assim que estiver disponível.

Fluxo de trabalho de alto nível para a atualização do sistema operacional

A atualização do sistema operacional do Azure Stack HCI está disponível por meio do Windows Update e por meio da mídia que você pode baixar no portal do Azure.

Para atualizar o sistema operacional em seu sistema, siga estas etapas de alto nível:

Preencha os pré-requisitos.
Atualizar chaves do Registro.
Conecte-se ao Azure Local, versão 22H2.
Verifique as atualizações disponíveis usando o PowerShell.
Instale o novo sistema operacional usando o PowerShell.
Verifique o status das atualizações.
Depois que o sistema operacional for atualizado, execute as etapas pós-atualização do sistema operacional.

Completar os pré-requisitos

Antes de começar, verifique se:

Você tem acesso a um Azure Local executando a versão 22H2.
O sistema está registrado no Azure.
Todos os computadores em sua instância do Azure Local, versão 22H2, são íntegros e são exibidos como Online.
Você desliga máquinas virtuais (VMs). Recomendamos desligar as VMs antes de executar a atualização do sistema operacional para evitar interrupções inesperadas e danos aos bancos de dados.
Você tem acesso à atualização de software do sistema operacional Azure Stack HCI, versão 23H2 para o Azure Local. Esta atualização está disponível por meio do Windows Update ou como uma mídia para download. A mídia deve ser o arquivo ISO da versão 2503 que você pode baixar no portal do Azure.
Você tem acesso a um cliente que pode se conectar à sua instância local do Azure. Esse cliente deve estar executando o PowerShell 5.0 ou posterior.
Você executará o RepairRegistration cmdlet somente se ambas as seguintes condições se aplicarem:
- A propriedade de identidade está ausente ou não contém type = "SystemAssigned".
  - Verifique isso no JSON do Recurso no portal do Azure
  - Ou execute o cmdlet do Get-AzResource -Name <cluster_name> PowerShell
- O grupo de clusters de Gerenciamento de Nuvem não está presente. Verifique-o executando o cmdlet do Get-ClusterGroup PowerShell.
Se ambas as condições forem atendidas, execute o RepairRegistration cmdlet:
```
Register-AzStackHCI -TenantId "<tenant_ID>" -SubscriptionId "<subscription_ID>" -ComputerName "<computer_name>" -RepairRegistration
```
(Recomendado) Habilite a Inicialização Segura em computadores locais do Azure antes de atualizar o sistema operacional. Para habilitar a Inicialização Segura, siga estas etapas:
1. Drene o nó do cluster.
2. Reinicie o sistema operacional.
3. Insira o menu BIOS/UEFI.
4. Examine a seção Inicialização ou Segurança das opções de configuração UEFI Localize a opção Inicialização Segura.
5. Defina a opção como Habilitada ou Ativada.
6. Salve as alterações e reinicie o computador.
Consulte o fornecedor de hardware para obter assistência, se necessário.

Observação

O arquivo ISO 2503 só será necessário se os computadores não tiverem acesso ao Windows Update para baixar a atualização de recursos do sistema operacional. Se estiver usando esse método, depois de se conectar ao Azure Local, versão 22H2, pule para a etapa 6 em Etapa 2: Instalar o novo sistema operacional usando o PowerShell e execute as etapas restantes. Não há suporte para o uso de ferramentas de terceiros para instalar atualizações.

Etapa 0: Atualizar chaves do Registro

Para garantir que o ReFS (Sistema de Arquivos Resiliente) e as migrações dinâmicas funcionem corretamente durante e após a atualização do sistema operacional, siga estas etapas em cada computador no sistema para atualizar as chaves do Registro. Reinicialize cada computador para que as alterações entrem em vigor.

Defina RefsEnableMetadataValidation para 0:

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

Crie a chave de parâmetros se ela não existir. Se ele já existir, o comando poderá falhar com um erro, o que é esperado.
```
New-Item -Path HKLM:\SYSTEM\CurrentControlSet\Services\Vid\Parameters
```

Defina SkipSmallLocalAllocations para 0:

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

Reinicie o computador para que as alterações entrem em vigor. Na reinicialização do computador, se a chave RefsEnableMetadataValidation for substituída e os volumes ReFS não ficarem online, alterne a chave definindo primeiro RefsEnableMetadataValidation para 1 e depois novamente para 0.
Atualize e verifique se as chaves do Registro foram aplicadas em cada computador no sistema antes de passar para a próxima etapa.

Etapa 1: Conectar-se ao Azure Local

Siga estas etapas em seu cliente para se conectar a um dos computadores de sua instância local do Azure.

Execute o PowerShell como Administrador no cliente que você está usando para se conectar ao sistema.

Abra uma sessão remota do PowerShell em um computador em sua instância local do Azure. Execute o seguinte comando e forneça as credenciais do seu computador quando solicitado:

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

Aqui está um exemplo de saída:

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>

Etapa 2: Instalar o novo sistema operacional usando o PowerShell

Para instalar o novo sistema operacional usando o PowerShell, siga estas etapas:

Observação

As etapas a seguir exigem que a função CAU (Atualização com Suporte a Cluster) seja instalada e habilitada no sistema. Para obter informações sobre como instalar e habilitar esse recurso no Azure Local, consulte Visão geral da Atualização com Suporte a Cluster.

Execute os cmdlets a seguir em cada computador do sistema.
```
Set-WSManQuickConfig
Enable-PSRemoting
```
Para testar se o sistema está configurado corretamente para aplicar atualizações de software usando a CAU (Atualização com Suporte a Cluster), execute o Test-CauSetup cmdlet, que notifica você sobre quaisquer avisos ou erros:
```
Test-CauSetup -ClusterName <System name>
```
Valide o hardware e as configurações executando o Test-Cluster cmdlet em um dos computadores do sistema. Se alguma das verificações de condição falhar, resolva-as antes de prosseguir para a próxima etapa.
```
Test-Cluster
```
Verifique as atualizações disponíveis:
```
Invoke-CauScan -ClusterName <SystemName> -CauPluginName "Microsoft.RollingUpgradePlugin" -CauPluginArguments @{'WuConnected'='true';} -Verbose | fl *
```
Inspecione a saída do cmdlet acima e verifique se cada computador recebe a mesma Atualização de Recursos, o que deve ser o caso.
Você precisa de um computador ou VM separado fora do sistema para executar o Invoke-CauRun cmdlet. Um computador separado garante que a orquestração não seja interrompida quando os computadores forem reinicializados.

Importante

O sistema no qual você executa Invoke-CauRun deve estar executando o Windows Server 2022.
```
Invoke-CauRun -ClusterName <SystemName> -CauPluginName "Microsoft.RollingUpgradePlugin" -CauPluginArguments @{'WuConnected'='true';} -Verbose -EnableFirewallRules -Force
```
Se o sistema não estiver conectado ao Windows Update e a mídia de instalação local do Azure estiver disponível em um compartilhamento local, a CAU também poderá ser usada para atualizar o sistema. Certifique-se de atualizar o 'PathToSetupMedia' parâmetro com o caminho de compartilhamento para a imagem ISO.
```
Invoke-CauRun –ClusterName <SystemName> -CauPluginName Microsoft.RollingUpgradePlugin -CauPluginArguments @{ 'WuConnected'='false';'PathToSetupMedia'='\some\path\'; 'UpdateClusterFunctionalLevel'='true'; } -Force
```
Verifique se há mais atualizações e instale-as.

Aguarde a conclusão da atualização e verifique o status da atualização.

Etapa 3: verificar o status de uma atualização

Para obter as informações resumidas sobre uma atualização em andamento, execute o Get-CauRun cmdlet:

Get-CauRun -ClusterName <SystemName>

Aqui está um exemplo de saída:

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

Valide a integridade do sistema executando o Test-Cluster cmdlet em um dos computadores no sistema. Se alguma das verificações de condição falhar, resolva-as antes de prosseguir para a próxima etapa.
```
Test-Cluster
```
Verifique se as chaves do Registro ainda são aplicadas em cada computador no sistema antes de passar para a próxima etapa.

Para verificar se a chave do Registro existe:
```
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" 
```
Para reaplicar as chaves do Registro, se necessário, e reinicializar cada computador para que as alterações entrem em vigor:
```
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "RefsEnableMetadataValidation" -Value 0 -Type DWord  -ErrorAction Stop
```
Se a atualização do sistema operacional falhar, execute o seguinte comando para recuperar a execução da CAU:
```
Invoke-CauRun –ForceRecovery -Force
```

Agora você está pronto para executar as etapas pós-atualização do sistema operacional para o seu sistema.

Próximas etapas

Saiba como executar as etapas pós-atualização do sistema operacional para o Azure Local.