Compartilhar via

Atualizar o Azure Local por meio do PowerShell

Aplica-se a: Azure Local 2311.2 e posterior

Importante

O Azure Local, versão 23H2 (versões 2311.2 a 2509) chegará ao fim do suporte em 31 de outubro de 2025. Após essa data, você não receberá atualizações mensais de segurança e qualidade. As solicitações de suporte só estarão disponíveis para correção em uma versão com suporte.

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 foi criado por meio de uma nova implantação do Azure Local, 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 Atualizar 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 as atualizações do Azure Local.

Importante

Com base na solução que você está usando para executar o 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.

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.
  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.
  • 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		 Hora de instalar a atualização
hh:mm
Nó único ~ 03:00 ~ 01:30
4 nós Aproximadamente 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 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 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 2311 ou posterior, execute o seguinte comando em um dos computadores do 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: 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>

Etapa 3: Importar e redescobrir atualizações

Esta é uma 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 as 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 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_<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 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.

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 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.

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 o $InstanceId, pois você poderá usá-lo posteriormente para solucionar problemas de atualizações de soluções para o 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 passa por vários estados, conforme descrito em Revisar fases de atualizaçã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 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

Depois que a instalação for concluída, o Estado será alterado para Installed. Para obter mais informações sobre os vários 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 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, confira 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>

Etapa 9: Instalar atualizações de hardware

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

  • Extensão do Construtor de Soluções
  • Windows Admin Center (Centro de Administração do Windows)
  • 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 de extensão apropriadas do Construtor de Soluções são incluídas automaticamente ao instalar atualizações de recursos locais do Azure.
  • 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 do Azure Local combinada).

Windows Admin Center (Centro de Administração do Windows)

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 o Azure Local, versão 22H2. Isso significa que suas atualizações de hardware podem estar disponíveis usando Windows Admin Center. Para obter mais informações, consulte Atualizar o Azure Local, versão 22H2.

Recomendação do fornecedor de hardware

As atualizações de firmware e driver podem precisar ser executadas separadamente, se o hardware não der 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