Atualizar Azure Local usando o PowerShell

Aplica-se a: implantações hiperconvergadas de Azure Local

Este artigo descreve como aplicar uma atualização de solução ao seu Azure Local usando o PowerShell.

O procedimento neste artigo se aplica a sistemas de nó único e vários nós que executam a versão mais recente do Azure Local com o orquestrador (Lifecycle Manager) instalado. Se você criou seu sistema implantando Azure Local, o orquestrador foi instalado automaticamente como parte da implantação.

Important

O procedimento descrito aqui se aplica ao atualizar sua versão de Azure Local existente para uma versão mais recente.

Sobre atualizações de solução

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

Important

Com base na solução que você está usando para executar Azure Local, as atualizações de recursos mais recentes podem levar uma semana a partir da data de disponibilidade antes de serem visíveis, devido à validação e à aprovação do parceiro de hardware.

Ao aplicar uma atualização de solução, siga estas etapas de alto nível:

1. Certifique-se de concluir todos os pré-requisitos.
2. Conecte-se à sua instância de Azure Local por meio do PowerShell remoto.
3. Confirme as versões de software instaladas no momento 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.
8. Instalar atualizações de hardware.

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

• Conteúdo da atualização
• Carregar em seu sistema
• Número de computadores em seu sistema
• Tipo de hardware usado
• Extensão da solução usada

A tabela a seguir resume as estimativas de tempo aproximadas para um sistema típico com um ou vários nós:

System/Time	Tempo para verificar a integridade hh:mm	Tempo para instalar a atualização hh:mm
Nó único	~ 00:17	Por volta das 04:00
4-nodes	~ 00:22	~ 06:00

Important

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

Prerequisites

Antes de começar, certifique-se de que cumpre os seguintes pré-requisitos:

• Você tem acesso a um sistema de Azure Local que está executando a versão 2311 ou superior. O sistema é registrado em 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.

Conecte-se ao seu Azure Local

Note

• Quando você atualiza para a solução versão 2601 ou posterior, a rede lógica de infraestrutura aparece em Azure. Para obter mais informações, consulte Infrastructure logic network como um componente do gerenciamento de VM 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 seu 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 da máquina quando solicitado:

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

   Note

   Entre usando suas credenciais de conta de usuário de implantação. Essa conta é criada ao preparar Active Directory e é usada para implantar 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á em execução com o Azure Local 2311 ou posterior.

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

   whoami
   

2. Para garantir que o sistema esteja em execução Azure Local 2311 ou posterior, execute o seguinte comando em um dos computadores em 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, confira Solução de problemas das verificações de preparação antes de continuar.

Etapa 2: Confira 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
   

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

   Se você não vir uma atualização esperada listada, remova o filtro do comando para ver se ele está listado em um 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 você quer 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}
   

   Note

   É normal que HealthState seja Unknown para atualização que ainda não esteja agendada ou preparada.

4. Opcionalmente, examine 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>
   
   

Etapa 3: Importar e redescobrir atualizações

Esta etapa é opcional. Talvez seja necessário importar atualizações em um dos seguintes cenários:

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

• 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 obtenha o pacote de atualização que você deseja usar. 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, os seguintes arquivos também estarão disponíveis:

   • 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 Azure Local pode acessar. Se você estiver importando uma extensão de solução, sempre baixe três arquivos que correspondam ao seguinte padrão de nomenclatura:

   Padrão de nome de arquivo	Example	Description
   SBE_Discovery_<Fabricante>.xml	SBE_Discovery_Contoso.xml	Um manifesto de descoberta de extensão de solução que permite a descoberta de atualizações.
   <SBE_Fabricante>_<Família>_<Versão>.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_<Fabricante>_<Família>_<Versão>.zip	SBE_Contoso_GenA_4.1.2410.5.zip	Um arquivo com conteúdo de extensão de solução

4. Crie uma pasta a ser descoberta pelo serviço de atualização no seguinte local do volume de infraestrutura 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 Atualizar. Execute o seguinte comando:

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

7. Verifique se o serviço de atualização descobriu 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 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 andamento da atualização, monitore o estado da atualização. Execute o seguinte comando:

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

   Quando a atualização é iniciada, ocorre o seguinte:

   • O processo começa a baixar as atualizações. 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.

   Este é um exemplo do que é exibido durante o download das atualizações:

   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, o sistema executa verificações de preparação para avaliar a preparação da atualização do seu sistema. Para obter mais informações sobre as verificações de preparação, consulte As fases de atualização. Durante essa fase, o estado da atualização é mostrado 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 aparecer como HealthCheckFailed, consulte Resolução de problemas de verificações de preparação antes de prosseguir.

Note

Se você executou a verificação de preparação de atualização usando o -PrepareOnly parâmetro, deverá atualizar usando o PowerShell. Não há suporte para mover para Azure portal para iniciar a atualização e pode levar a problemas inesperados.

Etapa 5: Iniciar a atualização

Durante a instalação, os computadores do sistema podem ser reinicializados. Talvez seja necessário estabelecer a sessão remota do PowerShell novamente para monitorar as atualizações. Se você estiver atualizando uma única máquina, seu Azure Local terá 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

Note

Se você ignorar a etapa 4 (e não fizer uma chamada semelhante à Start-SolutionUpdate -PrepareOnly), chamar Start-SolutionUpdate primeiro baixará as atualizações e executará 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

Esse comando inicia o processo para instalar a atualização.

Tip

Salve o valor $InstanceId. Você pode usá-lo mais tarde para solucionar problemas nas atualizações de solução para Azure Local.

Etapa 6: Acompanhar o progresso da atualização

Acompanhe 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 a interrupções no relatório de status.

Tip

• Para monitorar usando o PowerShell, conecte sua sessão do PowerShell ao último servidor em seu cluster para evitar que a sessão seja desconectada antecipadamente. As sessões se desconectam à medida que os sistemas são reinicializados, portanto, alternar para monitorar de um servidor já atualizado minimiza a frequência de desconexões.
• Acompanhe o progresso da atualização do cluster no portal 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 andamento da atualização, monitore o estado da atualização. Execute o seguinte comando:

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

   A atualização progride por vários estados, conforme descrito em Noções básicas sobre as fases de atualização.

   Os exemplos a seguir mostram como monitorar a atualização conforme ela avança 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.

     Este é um exemplo do que é exibido durante o download das atualizações:

     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, o processo prepara as atualizações. No estado de preparação, o processo de atualização confirma os hashes dos arquivos de atualização e extrai arquivos para preparar e organizar arquivos de atualização.

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

     Este é um exemplo do que é exibido durante o download das atualizações:

     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 estiverem preparadas, as verificações de preparação serã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 As fases de atualização.

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

     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 fará 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 for concluída, o Estado será alterado para Installed. Para obter mais informações sobre os diferentes estados das atualizações, consulte o progresso e o monitoramento da instalação.

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

Para retomar uma atualização que falhou anteriormente, execute o seguinte comando no PowerShell:

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

Para retomar uma atualização que falhou anteriormente porque as verificações de preparação de atualização estão em um Warning estado, execute o seguinte comando:

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

Para obter ajuda 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 exibir o estado Installed, verifique a versão da solução de ambiente. Execute o seguinte comando:

   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 instalada. Execute o seguinte comando:

   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>
   

Etapa 9: Instalar atualizações de hardware

Há vários métodos para instalar atualizações de hardware para Azure Local dependendo do suporte da instância Azure Local.

• Extensão do Construtor de Soluções
• Windows Admin Center
• Recomendação do fornecedor de hardware

Extensão do Construtor de Soluções

Para sistemas que dão suporte a extensões do Construtor de Soluções:

• As atualizações apropriadas da Extensão do Construtor de Soluções são incluídas automaticamente ao instalar atualizações de recursos do Azure Local.
• As atualizações de extensão do Construtor de Soluções podem ser instaladas separadamente (as atualizações de hardware podem ser instaladas sem uma atualização Azure Local combinada).

Windows Admin Center

Se o hardware não der suporte à experiência de atualização da Extensão do Construtor de Soluções, o processo de atualização do hardware permanecerá semelhante ao processo usado com Azure Local, versão 22H2. Isso significa que as atualizações de hardware podem estar disponíveis usando Windows Admin Center. Para obter mais informações, consulte Update Azure Local, versão 22H2.

Recomendação do fornecedor de hardware

Suas atualizações de firmware e driver podem precisar ser executadas separadamente, se o hardware não oferecer suporte a atualizações de hardware usando pacotes de extensão do Construtor de Soluções ou Windows Admin Center. Siga as recomendações do seu fornecedor de hardware.

Para determinar se seu sistema dá suporte à extensão do construtor de soluções e para obter detalhes sobre como instalar atualizações de hardware, consulte Sobre atualizações de software da Extensão do Construtor de Soluções.

Próxima etapa

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