Partilhar via

Atualizar o sistema operacional HCI do Azure Stack para a versão 26100.xxxx usando o PowerShell

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 são interrompidas.
  • A cobrança continua para os sistemas da versão 22H2.
  • O seu sistema continua a funcionar, incluindo o registo e a reparação.
  • 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 seu sistema operacional para a versão 23H2. Se estiver a executar um Azure Stack HCI, versão 22H2 stretch cluster ou a gerir o Azure Local através do System Center - Virtual Machine Manager, reveja a tabela Cargas de trabalho e configurações suportadas para obter os prazos de atualização.

Este artigo descreve como atualizar o sistema operacional (SO) Azure Stack HCI por meio do PowerShell. Os caminhos de atualização suportados incluem:

  • Da versão do SO 20349.xxxx a 26100.xxxx.

  • Da versão do SO 25398.xxxx para 26100.xxxx.

Importante

  • Este artigo aborda apenas as atualizações do SO. Não prossiga se a atualização da solução estiver concluída ou se o Azure Local 2311.2 ou posterior for implantado. Para verificar se o sistema já está executando a solução, execute o Get-StampInformation cmdlet. Se ele retornar a saída, seu sistema já está executando a solução, e você deve ignorar estas etapas.
  • A atualização da solução ainda não é suportada na versão 26100.xxxx do SO.

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

A atualização do sistema operacional HCI do Azure Stack está disponível somente por meio do portal do Azure.

Para atualizar o SO no seu sistema, siga estes passos de alto nível:

  1. Preencha os pré-requisitos.
  2. Atualize as chaves do Registro.
  3. Instale o novo sistema operacional usando o PowerShell.
  4. Verifique o status das atualizações.
  5. Depois que o sistema operacional for atualizado, execute as etapas de atualização pós-SO.

Pré-requisitos completos

  • Verifique se o sistema Local do Azure está executando a versão do sistema operacional 20349.3692 ou a versão do sistema operacional maior que 25398.1611.

  • Certifique-se de que o sistema está registado no Azure e que todas as máquinas no sistema estão saudáveis e online.

  • Certifique-se de desligar 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.

  • Confirme que tem acesso ao ficheiro ISO do Azure Local 2505 , que pode transferir a partir do portal do Azure.

  • Consulte o OEM do hardware para verificar a compatibilidade do driver. Confirme se todos os drivers compatíveis com o Windows Server 2025 ou o Azure Stack HCI OS, 26100.xxxx estão instalados antes da atualização.

  • Verifique se o driver da placa de interface de rede (NIC) atualmente instalado em seu sistema é mais recente do que a versão incluída por padrão (caixa de entrada) com o Azure Stack HCI OS, versão 26100.xxxx. A tabela a seguir compara as versões atual e recomendada dos drivers NIC para dois fabricantes:

    Fabricante de NIC Versão do driver da caixa de entrada Driver compatível mais recente recomendado
    Processador Intel 1.15.121.0 1.17.73.0
    NVIDIA 24.4.26429.0 25.4.50020

  • Verifique se a instância está registrada corretamente. Se a propriedade identity estiver ausente ou não contiver type = "SystemAssigned", execute o seguinte comando para reparar o registro:

    Register-AzStackHCI -TenantId "<tenant_ID>" -SubscriptionId "<subscription_ID>" -ComputerName "<computer_name>" -RepairRegistration

    Você pode verificar a propriedade de identidade no portal do Azure no JSON do recurso ou executando o seguinte cmdlet:

    Get-AzResource -Name <cluster_name> -ResourceGroupName <name of the resource group> -ResourceType "Microsoft.AzureStackHCI/clusters" -ExpandProperties

  • (Recomendado) Habilite a Inicialização Segura em máquinas locais do Azure antes de atualizar o sistema operacional. Para ativar o Arranque Seguro, siga estes passos:

    1. Esvazie o nó do cluster.
    2. Reinicie o SO.
    3. Entre no menu BIOS/UEFI.
    4. Reveja a secção Arranque ou Segurança das opções de configuração UEFI Localize a opção Arranque Seguro.
    5. Defina a opção como Ativado ou Ativado.
    6. Salve as alterações e reinicie o computador.

    Consulte o fornecedor do hardware para obter assistência, se necessário.

Atualizar chaves do Registro

Para garantir que o Sistema de Arquivos Resiliente (ReFS) funcione corretamente durante e após a atualização do sistema operacional, siga estas etapas em cada máquina do sistema para atualizar as chaves do Registro. Reinicialize cada máquina para que as alterações entrem em vigor.

  1. Definir RefsEnableMetadataValidation como 0:

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

  2. Reinicie a máquina para aplicar as alterações. Se os volumes ReFS não ficarem disponíveis após a reinicialização e a chave RefsEnableMetadataValidation for redefinida, ative/desative a chave. Defina RefsEnableMetadataValidation como 1 e, em seguida, volte para 0. Para verificar o status do volume, execute o Get-ClusterSharedVolumeState comando.

  3. Atualize e verifique se as chaves do Registro foram aplicadas em cada máquina do sistema antes de passar para a próxima etapa.

Instalar 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 em seu Azure Local, consulte Visão geral da Atualização com Suporte a Cluster.

  1. Execute os cmdlets a seguir em todas as máquinas do sistema.

    Set-WSManQuickConfig
Enable-PSRemoting

  2. 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 o notifica sobre quaisquer avisos ou erros:

    Test-CauSetup -ClusterName <System name>

  3. Valide o hardware e as configurações executando o Test-Cluster cmdlet em uma das máquinas do sistema. Se alguma das verificações de condição falhar, resolva-as antes de prosseguir para a próxima etapa. 

    Test-Cluster

  4. Extraia o conteúdo da imagem ISO e copie-o para a unidade do sistema local em cada máquina. Certifique-se de que o caminho local é o mesmo em cada máquina. Em seguida, atualize o PathToSetupMedia parâmetro com o caminho local para a imagem ISO.

    # Define ISO and destination paths 
$isoFilePath = "C:\SetupFiles\WindowsServer\ISOs\example.iso" 
$destinationPath = "C:\SetupFiles\WindowsServer\Files" 
# Mount the ISO file 
$iso = Mount-DiskImage -ImagePath $isoFilePath 
# Get the drive letter 
$driveLetter = ($iso | Get-Volume).DriveLetter 
# Create the destination directory 
New-Item -ItemType Directory -Path $destinationPath 
# Copy contents to the local directory 
Copy-Item -Path "${driveLetter}:\*" -Destination $destinationPath –Recurse 
# Dismount the ISO file 
Dismount-DiskImage -ImagePath $isoFilePath

  5. Atualize o sistema.

    Invoke-CauRun –ClusterName <SystemName> -CauPluginName Microsoft.RollingUpgradePlugin  -EnableFirewallRules -CauPluginArguments @{ 'WuConnected'='false';'PathToSetupMedia'='\some\path\'; 'UpdateClusterFunctionalLevel'='true'; } -ForceSelfUpdate -Force

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

Verificar o estado de uma atualização

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

  2. Valide a integridade do sistema executando o Test-Cluster cmdlet em uma das máquinas do sistema. Se alguma das verificações de condição falhar, resolva-as antes de prosseguir para a próxima etapa.

    Test-Cluster

  3. Verifique se as chaves do Registro ainda estão aplicadas em cada máquina do 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 reiniciar cada máquina 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 de atualização pós-SO para o seu sistema.

Problemas conhecidos

Se o sistema estiver configurado com o Network ATC antes de realizar a atualização do sistema operativo, a intenção de gestão do Network ATC pode falhar com o erro PhysicalAdapterNotFound após a atualização do sistema operativo. Para obter etapas detalhadas sobre como resolver esse problema, consulte o Guia de solução de problemas .

Próximos passos