Atualizar o Azure Local, versão 23H2 por meio do PowerShell

Aplica-se a: Azure Local 2311.2 e posterior

Este artigo descreve como aplicar uma atualização de solução ao Azure Local por meio do PowerShell.

O procedimento neste artigo se aplica a sistemas de nó único e de vários nós que executam a versão mais recente do Azure Local com o orquestrador (Lifecycle Manager) instalado. Se o sistema tiver sido criado por meio de uma nova implantação do Azure Local, versão 23H2, o orquestrador foi instalado automaticamente como parte da implantação.

Importante

O procedimento descrito aqui se aplica ao atualizar sua versão local do Azure existente para uma versão mais recente. Para obter informações sobre atualizações para versões mais antigas, consulte Atualizações de clusters para o Azure Stack HCI, versão 22H2.

Sobre atualizações de solução

As atualizações da solução local do Azure podem consistir em atualizações de plataforma, serviço e extensão de solução. Para obter mais informações sobre cada um desses tipos de atualizações, consulte Sobre atualizações para o Azure Local, versão 23H2.

Quando você aplica uma atualização de solução, aqui estão as etapas de alto nível que você executa:

1. Certifique-se de que todos os pré-requisitos foram concluídos.
2. Conecte-se à sua instância local do Azure por meio do PowerShell remoto.
3. Confirme as versões atuais do software instalado e verifique se o cluster está em boa integridade.
4. Descubra as atualizações disponíveis e filtre as que você pode aplicar ao seu sistema.
5. (Recomendado) Pré-carregar as atualizações e avaliar a preparação da atualização do sistema.
6. Instale as atualizações e acompanhe o progresso das atualizações. Monitore o progresso detalhado conforme necessário.
7. Verifique a versão das atualizações instaladas.

O tempo necessário para instalar as atualizações varia de acordo com os seguintes fatores:

• Conteúdo da atualização.
• Carregue em seu sistema.
• Número de máquinas em seu sistema.
• Tipo de hardware usado.
• Extensão da solução usada.

As estimativas de tempo aproximadas para um sistema típico de um ou vários nós estão resumidas na tabela a seguir:

Sistema/Hora	Hora da verificação de integridade hh:mm:ss	Hora de instalar a atualização hh:mm:ss
Nó único	~ 03:00	~ 01:30
4 nós	~ 05:00	~ 04:00

Importante

Não há suporte para o uso de ferramentas de terceiros para instalar atualizações.

Pré-requisitos

Antes de começar, verifique se:

• Você tem acesso a um sistema Azure Local, versão 23H2, que está executando a versão 2311 ou superior. O sistema deve ser registrado no Azure.
• Você tem acesso a um cliente que pode se conectar ao seu Azure Local.
• Você tem acesso à atualização da solução pela rede.

Conectar-se ao Azure Local

Siga estas etapas em seu cliente para se conectar a um dos computadores em seu Azure Local.

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

2. Abra uma sessão remota do PowerShell em um computador em seu Azure Local. Execute o seguinte comando e forneça as credenciais do seu computador quando solicitado:

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

   Observação

   Entre usando suas credenciais de conta de usuário de implantação. Essa é a conta que você criou ao preparar do Active Directory e usada para implantar o Azure Local.

   Expanda esta seção para ver um exemplo de saída.

   Veja 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 1: confirmar o software e verificar a integridade do sistema

Antes de descobrir as atualizações, verifique se o sistema está executando o Azure Local, versão 23H2, software versão 2311 ou posterior.

1. Verifique se você está conectado ao computador usando a conta de usuário de implantação. Execute o comando a seguir:

   whoami
   

2. Para garantir que o sistema esteja executando o Azure Local, versão 23H2, execute o seguinte comando em um dos computadores do seu sistema:

   Get-SolutionUpdateEnvironment
   

   Expanda esta seção para ver um exemplo de saída.

   PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment
   ResourceId : redmond 
   SbeFamily : GenA 
   HardwareModel : Contoso680 
   LastChecked : 10/2/2024 12:38:21 PM 
   PackageVersions : {Solution: 10.2408.0.29, Services: 10.2408.0.29, Platform: 1.0.0.0, SBE: 4.1.2409.1} 
   CurrentVersion : 10.2408.0.29 
   CurrentSbeVersion : 4.1.2409.1 
   LastUpdated : 
   State : UpdateAvailable 
   HealthState : Success 
   HealthCheckResult : {Storage Subsystem Summary, Storage Pool Summary, Storage Services Physical Disks Summary, Storage 
   Services Physical Disks Summary...} 
   HealthCheckDate : 10/2/2024 10:46:44 AM 
   AdditionalData : 
   

3. Observe o CurrentVersion em seu sistema. A versão atual reflete a versão da solução em que o sistema está em execução.

4. Revise o HealthState no seu sistema e verifique se o sistema está em bom estado. Se o HealthState for Failure, Error ou Warning, consulte Verificações de preparação de solução de problemas antes de prosseguir.

Etapa 2: descubra as atualizações

Siga estas etapas para descobrir as atualizações disponíveis para seu sistema:

1. Conecte-se a um computador em seu Azure Local usando a conta de usuário de implantação.

2. Examine os detalhes das atualizações que estejam Ready para instalar usando Get-SolutionUpdate.

   Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType 
   

   Expanda esta seção para ver um exemplo de saída.

   Veja um exemplo de saída:

   PS C:\Users\lcmuser> Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType
   
   DisplayName           : 2024.10 Cumulative Update
   ResourceId            : redmond/Solution10.2408.2.7
   Version               : 10.2408.2.7
   State                 : Ready
   PackageType           : Solution
   
   DisplayName           : SBE_Contoso_GenA_4.1.2410.5
   ResourceId            : redmond/SBE4.1.2410.5
   Version               : 4.1.2410.5
   State                 : AdditionalContentRequired
   PackageType           : SBE
   

   Isso pode listar uma ou mais opções, incluindo entradas para atualizações de Solution completas (que também podem incluir uma extensão do Construtor de Soluções) e atualizações SBE autônomas.

   Se você não vir uma atualização esperada listada, remova o filtro do comando para ver se ele está listado no estado non-ready.

   Get-SolutionUpdate | FL DisplayName, Description, ResourceId, State, PackageType 
   

   Para obter mais informações, consulte Sobre as fases de Atualização para obter detalhes sobre os estados de atualização.

3. Selecione a atualização que deseja instalar e anote seu ResourceId. Examine os detalhes da atualização para confirmar se você selecionou a atualização desejada para instalar.

   $Update = Get-SolutionUpdate –Id <ResourceId>
   $Update
   

   Expanda esta seção para ver um exemplo de saída.

   Veja um exemplo de saída:

   PS C:\Users\lcmuser> $Update = Get-SolutionUpdate –Id redmond/Solution10.2408.2.7
   PS C:\Users\lcmuser> $Update
   ResourceId            : redmond/Solution10.2408.2.7
   InstalledDate         : 
   Description           :
   State                 : Ready
   KbLink                : https://learn.microsoft.com/en-us/azure-stack/hci/
   MinVersionRequired    : 10.2408.0.0
   MinSbeVersionRequired : 2.0.0.0
   PackagePath           : C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\Updates\Packages\Solution10.2408
                           .2.2
   PackageSizeInMb       : 1278
   DisplayName           : 2024.10 Cumulative Update
   Version               : 10.2408.2.7
   SbeVersion            : 4.1.2410.5
   Publisher             : Microsoft
   ReleaseLink           : https://learn.microsoft.com/en-us/azure-stack/hci/
   AvailabilityType      : Online
   PackageType           : Solution
   Prerequisites         : {}
   UpdateStateProperties : The update requires additional content distributed by the OEM.
   AdditionalProperties  : {SBEReleaseLink, SBENotifyMessage, SBEFamily, SBEPublisher...}
   ComponentVersions     : {Services: 10.2408.2.7, Platform: 10.2408.2.7, SBE: 4.1.2410.5}
   RebootRequired        : Unknown
   HealthState           : Unknown
   HealthCheckResult     : 
   HealthCheckDate       : 1/1/0001 12:00:00 AM
   BillOfMaterials       : {PlatformUpdate, ServicesUpdate}
   

   Observação

   É normal HealthState ser Unknown para uma atualização que ainda não foi agendada ou preparada.

4. Opcionalmente, revise as versões dos componentes do pacote de atualização.

   $Update = Get-SolutionUpdate -Id <ResourceID>
   $Update.ComponentVersions
   

   Expanda esta seção para ver um exemplo de saída.

   Veja um exemplo de saída:

   PS C:\Users\lcmuser> $Update = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7
   
   PS C:\Users\lcmuser> $Update.ComponentVersions
   
   PackageType Version      LastUpdated
   ----------- -------      -----------
   Services    10.2408.2.7
   Platform    10.2408.2.7
   SBE         4.1.2410.5
   
   PS C:\Users\lcmuser>
   
   

Agora você pode prosseguir para Baixar e instalar as atualizações.

Etapa 3: Importar e redescobrir atualizações

Esta etapa é opcional. A importação de atualizações pode ser necessária em um dos seguintes cenários:

• A atualização que você deseja instalar relata um estado AdditionalContentRequired. Algum conteúdo extra pode ser necessário antes de agendar a atualização no estado AdditionalContentRequired. Para obter detalhes sobre esse estado e sobre atualizações de extensão de solução, consulte Atualizações de Extensão de Solução no Azure Local, versão 23H2.

• A atualização que você deseja instalar não está listada porque o Suporte está fornecendo uma versão privada para resolver um problema que você está enfrentando.

• A atualização é listada como Ready, mas como seu sistema tem conectividade de rede limitada, você deseja evitar a fase de download online da atualização de extensão da solução.

Siga estas etapas para importar e saber quais são as atualizações da solução.

1. Conecte-se a um computador em seu Azure Local usando a conta de usuário de implantação.

2. Vá para o compartilhamento de rede e adquira o pacote de atualização que você usa. Verifique se o pacote de atualização a ser importado contém os seguintes arquivos:

   • SolutionUpdate.xml
   • SolutionUpdate.zip
   • AS_Update_10.2408.2.7.zip

   Se uma extensão do construtor de soluções fizer parte do pacote de atualização, você também deverá ver os seguintes arquivos:

   • SBE_Contoso_GenA_4.1.2410.5.xml
   • SBE_Contoso_GenA_4.1.2410.5.zip
   • SBE_Discovery_Contoso.xml

3. Baixe os arquivos que você pretende importar para um local que sua instância local do Azure pode acessar. Se você estiver importando uma extensão de solução, sempre baixará três arquivos que correspondem ao seguinte padrão de nomenclatura:

   Padrão de nome de arquivo	Exemplo	Descrição
   SBE_Discovery_<Manufacturer>.xml	SBE_Discovery_Contoso.xml	Um manifesto de descoberta de extensão de solução que permite a descoberta de atualizações.
   SBE_<Manufacturer>_<Family>_<Version>.xml	SBE_Contoso_GenA_4.1.2410.5.xml	Um arquivo com inventário de extensões de solução e Lista de Materiais de software assinada
   SBE_<Manufacturer>_<Family>_<Version>.zip	SBE_Contoso_GenA_4.1.2410.5.zip	Um arquivo com conteúdo de extensão de solução

4. Crie uma pasta para descoberta pelo serviço de atualização no seguinte local no volume de infra-estrutura do sistema.

   New-Item C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\import -ItemType Directory 
   

5. Copie os arquivos de atualização para a pasta que você criou na etapa anterior.

6. Descubra manualmente o pacote de atualização usando o serviço de atualização. Execute o comando a seguir:

   Add-SolutionUpdate -SourceFolder C:\ClusterStorage\Infrastructure_1\Shares\SU1_Infrastructure_1\import
   

7. Verifique se o serviço de atualização descobre o pacote de atualização e se ele está disponível para iniciar a preparação e a instalação. Repita o comando Get-SolutionUpdate para redescobrir as atualizações.

Etapa 4: (Recomendado) Pré-carregamento e verificação de preparação de atualização

Você pode baixar a atualização e executar um conjunto de verificações para verificar a preparação de atualização do cluster sem iniciar a instalação.

1. Para baixar as atualizações sem iniciar a instalação, execute o seguinte comando:

   Get-SolutionUpdate -Id <ResourceId> | Start-SolutionUpdate –PrepareOnly
   

   Expanda esta seção para ver um exemplo de saída.

   Veja um exemplo de saída:

   PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate –PrepareOnly
   redmond/SBE4.1.2410.9/<GUID>
   

2. Para acompanhar o progresso da atualização, monitore o estado da atualização. Execute o comando a seguir:

   Get-SolutionUpdate -Id <ResourceId> | ft Version,State,UpdateStateProperties,HealthState
   

   Quando a atualização é iniciada, ocorrem as seguintes ações:

   • O download das atualizações começa. Dependendo do tamanho do pacote de download e da largura de banda da rede, o download pode levar vários minutos.
   Expanda esta seção para ver um exemplo de saída.

   Aqui está um exemplo de saída quando as atualizações estão sendo baixadas:

   PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | ft Version,State,HealthState
   
   Version              State          HealthState
   -------              -----          ---------------------
   10.2408.2.7          Downloading    InProgress
   

3. Depois que o pacote é baixado, as verificações de preparação são executadas para avaliar a prontidão de atualização do seu sistema. Para obter mais informações sobre as verificações de preparação, consulte Fases de atualização. Durante essa fase, o estado da atualização é exibido como HealthChecking.

   Expanda esta seção para ver um exemplo de saída.

   PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState
   
   Version         State             HealthState
   -------         -----             --------------------- 
   10.2408.2.7     HealthChecking    InProgress
   

4. Quando as verificações de preparação forem concluídas, o sistema estará pronto para instalar atualizações. O State da atualização é mostrado como ReadyToInstall. Se o State da atualização for exibido como HealthCheckFailed, consulte Solucionar problemas de verificações de preparação antes de continuar.

Etapa 5: Iniciar a atualização

Durante a instalação, os computadores do sistema podem ser reinicializados e talvez seja necessário estabelecer a sessão remota do PowerShell novamente para monitorar as atualizações. Se estiver atualizando um único computador, o Azure Local apresentará um tempo de inatividade.

Inicie uma atualização selecionando uma única atualização e passando-a para Start-SolutionUpdate.

$InstanceId = Get-SolutionUpdate -Id <ResourceId>  | Start-SolutionUpdate

Observação

Se a etapa 4 tiver sido ignorada (e se você não fez uma chamada semelhante para Start-SolutionUpdate -PrepareOnly), chamar Start-SolutionUpdate primeiro baixa as atualizações e executa um conjunto de verificações para verificar a preparação de atualização do cluster antes de iniciar a instalação da atualização.

Expanda esta seção para ver um exemplo de saída.

PS C:\Users\lcmuser> $InstanceId = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate

Isso inicia o processo para instalar a atualização.

Dica

Salve a $InstanceId, pois você poderia usá-la mais tarde para resolver problemas com atualizações de solução do Azure Local.

Etapa 6: Acompanhar o progresso da atualização

A Microsoft recomenda acompanhar o progresso da atualização do cluster no portal do Azure após o início da atualização. O portal é uma ótima opção para acompanhar o progresso da atualização mesmo quando a atualização é iniciada por meio do PowerShell, pois não está sujeita às interrupções no relatório de status.

Dica

• Se estiver monitorando por meio do PowerShell, recomendamos que você conecte sua sessão do PowerShell ao último servidor em seu cluster para evitar que a sessão se desconecte antecipadamente. As sessões se desconectam à medida que os sistemas são reinicializados, portanto, alternar para monitorar de um servidor já atualizado pode minimizar a frequência de desconexões.
• Recomendamos que você acompanhe o progresso da atualização de cluster no portal do Azure para evitar ter que se reconectar às sessões do PowerShell após uma reinicialização do computador.

Siga estas etapas para acompanhar o progresso da atualização usando o PowerShell.

1. Para acompanhar o progresso da atualização, monitore o estado da atualização. Execute o comando a seguir:

   Get-SolutionUpdate -Id <ResourceId> | ft Version,State,UpdateStateProperties,HealthState
   

   A atualização progride por vários estados, conforme descrito nas Fases de atualização da revisão.

   Usando o comando acima, os exemplos a seguir mostram como monitorar a atualização à medida que ela progride por essas fases usando as propriedades State e UpdateStateProperties.

   • Estado Baixando

     Assim que Start-SolutionUpdate é chamado, o download das atualizações começa. Dependendo do tamanho do pacote de download e da largura de banda da rede, o download pode levar vários minutos.

     Expanda esta seção para ver um exemplo de saída.

     Aqui está um exemplo de saída quando as atualizações estão sendo baixadas:

     PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,UpdateStateProperties,HealthState
     
     Version              State         HealthState
     -------              -----         ------------
     10.2408.2.7          Downloading   Unknown
     

   • Estado Preparando

     Depois que as atualizações são baixadas, as atualizações precisam ser preparadas. No estado de preparação, os hashes dos arquivos de atualização são confirmados e os arquivos são extraídos para preparar e organizar arquivos de atualização.

     Expanda esta seção para ver um exemplo de saída.

     Aqui está um exemplo de saída quando as atualizações estão sendo baixadas:

     PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState
     
     Version              State       HealthState
     -------              -----       -----------
     10.2408.2.7          Preparing   Unknown
     

   • Estado HealthChecking

     Depois que as atualizações são preparadas, verificações de preparação são executadas para avaliar a preparação da atualização do cluster. Para obter mais informações sobre as verificações de preparação, consulte Fases de atualização.

     Durante essa fase, o State da atualização é exibido como HealthChecking. Se o State da atualização for exibido como HealthCheckFailed, consulte Solucionar problemas de verificações de preparação antes de continuar.

     Expanda esta seção para ver um exemplo de saída.

     Aqui está um exemplo de saída quando as atualizações estão em andamento HealthChecking:

     PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState
     
     Version              State           HealthState
     -------              -----           -----------
     10.2408.2.7          HealthChecking  Unknown
     

   • Estado de instalação Quando o sistema estiver pronto, a atualização faz a transição para Installing. Durante essa fase, o State das atualizações é mostrado como Installing e UpdateStateProperties mostra o percentual da instalação concluída.

     Expanda esta seção para ver um exemplo de saída.

     Aqui está um exemplo de saída quando as atualizações estão em andamento Installing:

     PS C:\Users\lcmuser> Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 |ft Version,State,HealthState
     
     Version              State       HealthState
     -------              -----       -----------
     10.2408.2.7          Installing   Unknown
     

Quando a instalação estiver concluída, o estado mudará para Installed. Para obter mais informações sobre os vários estados das atualizações, consulte Progresso e monitoramento da instalação.

Etapa 7: retomar a atualização (se necessário)

Para retomar uma execução de atualização com falha anterior por meio do PowerShell, use o seguinte comando:

Get-SolutionUpdate -Id <ResourceId>  | Start-SolutionUpdate

Para retomar uma atualização com falha anterior devido a verificações de preparação de atualização em um estado Warning, use o seguinte comando:

Get-SolutionUpdate -Id <ResourceId>  | Start-SolutionUpdate -IgnoreWarnings    

Para solucionar outros problemas de execução de atualização, consulte Solucionar problemas de atualizações.

Etapa 8: Verificar a instalação

Depois que as atualizações forem instaladas, verifique a versão da solução do ambiente e a versão do sistema operacional.

1. Depois que a atualização estiver no Installed estado, verifique a versão da solução de ambiente. Execute o comando a seguir:

   Get-SolutionUpdateEnvironment | ft State, CurrentVersion
   

   Expanda esta seção para ver um exemplo de saída.

   PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion
   
   State               CurrentVersion
   -----               --------------
   AppliedSuccessfully 10.2408.2.7
   
   

2. Verifique a versão do sistema operacional para confirmar se ela corresponde à receita que você instalou. Execute o comando a seguir:

   cmd /c ver
   

   Expanda esta seção para ver um exemplo de saída.

   Aqui está um exemplo de saída:

   PS C:\Users\lcmuser> cmd /c ver
   
   Microsoft Windows [Version 10.0.25398.1189]
   PS C:\Users\lcmuser>
   

Próxima etapa

• Se você tiver problemas durante o processo de atualização, consulte Solucionar problemas de atualizações.

• Saiba mais sobre como Atualizar a versão 22H2 quando o orquestrador não está instalado.