Sdílet prostřednictvím

Aktualizace lokální instance Azure pomocí PowerShellu

  • Článek

Platí pro: Azure Local 2311.2 a novější

Důležité

Podpora pro místní Azure verze 23H2 (verze 2311.2 až 2509) bude ukončena 31. října 2025. Po tomto datu nebudete dostávat měsíční aktualizace zabezpečení a kvality. Žádosti o podporu budou k dispozici pouze pro opravy podporované verze.

Tento článek popisuje, jak pomocí PowerShellu použít aktualizaci řešení pro místní Azure.

Postup v tomto článku platí pro systémy s jedním uzlem i systémy s více uzly, na kterých běží nejnovější verze Azure Local s nainstalovaným orchestrátorem (Správce životního cyklu). Pokud byl váš systém vytvořen prostřednictvím nového nasazení Azure Local, orchestrátor se automaticky nainstaloval jako součást nasazení.

Důležité

Postup popsaný zde platí při aktualizaci stávající místní verze Azure na novější verzi. Informace o aktualizacích pro starší verze najdete v tématu Aktualizace clusterů pro Azure Stack HCI verze 22H2.

Informace o aktualizacích řešení

Aktualizace místních řešení Azure se můžou skládat z aktualizací platforem, služeb a rozšíření řešení. Další informace o jednotlivých těchto typech aktualizací najdete v tématu O aktualizacích pro místní Azure.

Důležité

Na základě řešení, které používáte ke spuštění Azure Local, můžou nejnovější aktualizace funkcí trvat týden od data dostupnosti, než budou viditelné, kvůli ověření hardwarového partnera a odhlášení.

Při instalaci aktualizace řešení tady jsou základní kroky, které provedete:

  1. Ujistěte se, že jsou splněné všechny požadavky.
  2. Připojte se ke své místní instanci Azure přes vzdálený PowerShell.
  3. Ověřte aktuální nainstalované verze softwaru a ověřte, že je váš cluster v dobrém stavu.
  4. Objevte dostupné aktualizace a vyfiltrujte aktualizace, které můžete použít pro váš systém.
  5. (Doporučeno) Předem stáhněte aktualizace a vyhodnoťte připravenost aktualizací vašeho systému.
  6. Nainstalujte aktualizace a sledujte průběh aktualizací. Podle potřeby sledujte podrobný postup.
  7. Ověřte verzi nainstalovaných aktualizací.

Doba potřebná k instalaci aktualizací se liší podle následujících faktorů:

  • Obsah aktualizace.
  • Zatížení vašeho systému.
  • Počet počítačů ve vašem systému.
  • Typ použitého hardwaru.
  • Používá se rozšíření řešení.

Přibližné časové odhady typického systému s jedním nebo více uzly jsou shrnuté v následující tabulce:

Systém a čas Čas kontroly stavu
hh:mm		 Čas instalace aktualizace
hh:mm
Jeden uzel ~ 03:00 V přibližně 01:30
4 uzly Přibližně 05:00 ~ 04:00

Důležité

Použití nástrojů třetích stran k instalaci aktualizací se nepodporuje.

Požadavky

Než začnete, ujistěte se, že:

  • Máte přístup k místnímu systému Azure, na kterém běží verze 2311 nebo vyšší. Systém by měl být zaregistrovaný v Azure.
  • Máte přístup ke klientovi, který se může připojit k Azure Local.
  • Máte přístup k aktualizaci řešení přes síť.

Připojení k místnímu prostředí Azure

Postupujte podle těchto kroků v klientovi a připojte se k jednomu z počítačů v místním prostředí Azure.

  1. Spusťte PowerShell jako správce na klientovi, kterého používáte pro připojení ke svému systému.

  2. Otevřete vzdálenou relaci PowerShellu k počítači ve vašem místním prostředí Azure. Po zobrazení výzvy spusťte následující příkaz a zadejte přihlašovací údaje počítače:

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

    Poznámka:

    Přihlaste se pomocí přihlašovacích údajů uživatelského účtu, který používáte pro nasazení. Jedná se o účet, který jste vytvořili při přípravě služby Active Directory a použili se k nasazení azure Local.

    Rozbalením této části zobrazíte ukázkový výstup.

    Tady je příklad výstupu:

    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>

Krok 1: Potvrzení stavu softwaru a ověření stavu systému

Než zjistíte aktualizace, ujistěte se, že na vašem systému běží Azure Local 2311 nebo novější.

  1. Ujistěte se, že jste připojeni k počítači pomocí uživatelského účtu pro nasazení. Spusťte následující příkaz:

    whoami

  2. Pokud chcete zajistit, aby systém běžel na místním počítači Azure 2311 nebo novějším, spusťte na jednom z počítačů systému následující příkaz:

    Get-SolutionUpdateEnvironment
    Rozbalením této části zobrazíte ukázkový výstup. 
    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. Poznamenejte si CurrentVersion ve svém systému. Aktuální verze odráží verzi řešení, na které běží váš systém.

  4. Zkontrolujte HealthState ve vašem systému a ujistěte se, že je váš systém ve zdravém stavu. Pokud je HealthState Failure, Error nebo Warning, přečtěte si Řešení problémů s kontrolami připravenosti předtím, než budete pokračovat.

Krok 2: Zjištění aktualizací

Pokud chcete zjistit dostupné aktualizace pro váš systém, postupujte takto:

  1. Připojte se k počítači v místním prostředí Azure pomocí uživatelského účtu nasazení.

  2. Projděte si podrobnosti o aktualizacích, které lze Ready nainstalovat pomocí Get-SolutionUpdate.

    Get-SolutionUpdate | Where-Object {$_.State -like "Ready*" -or $_.State -like "Additional*"} | FL DisplayName, Description, ResourceId, State, PackageType
    Rozbalením této části zobrazíte ukázkový výstup.

    Tady je příklad výstupu:

    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

    Tato možnost může obsahovat jednu nebo více možností včetně položek pro úplné aktualizace Solution (které mohou také zahrnovat rozšíření Tvůrce řešení) a samostatné aktualizace SBE.

    Pokud v seznamu nevidíte očekávanou aktualizaci, odeberte filtr z příkazu, abyste zjistili, jestli je uvedená v non-ready stavu:

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

    Další informace naleznete v tématu O fázích aktualizace , kde najdete podrobnosti o stavech aktualizací.

  3. Vyberte aktualizaci, kterou chcete nainstalovat, a poznamenejte si její ResourceId. Zkontrolujte podrobnosti o aktualizaci a ověřte, že jste vybrali požadovanou aktualizaci, kterou chcete nainstalovat.

    $Update = Get-SolutionUpdate –Id <ResourceId>
$Update
    Rozbalením této části zobrazíte ukázkový výstup.

    Tady je příklad výstupu:

    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}

    Poznámka:

    Je normální, že HealthState je Unknown u aktualizace, která ještě nebyla naplánována nebo připravena.

  4. Volitelně zkontrolujte verze součástí balíčku aktualizací.

    $Update = Get-SolutionUpdate -Id <ResourceID>
$Update.ComponentVersions
    Rozbalením této části zobrazíte ukázkový výstup.

    Tady je příklad výstupu:

    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>

Krok 3: Import a opětovné zjišťování aktualizací

Jedná se o volitelný krok. Import aktualizací může být vyžadován v jednom z následujících scénářů:

  • Aktualizace, kterou chcete nainstalovat, hlásí AdditionalContentRequiredstav. Než budete moct naplánovat aktualizaci v AdditionalContentRequiredstavu, může být potřeba nějaký další obsah. Podrobnosti o tomto stavu a aktualizacích rozšíření řešení najdete v tématu Aktualizace rozšíření Tvůrce řešení v místním prostředí Azure.

  • Aktualizace, kterou chcete nainstalovat, není uvedená, protože podpora poskytuje privátní verzi, která řeší váš problém.

  • Aktualizace je uvedená jako Ready, ale protože váš systém má omezené síťové připojení, chcete se vyhnout fázi online stahování aktualizace rozšíření řešení.

Podle těchto kroků naimportujte a objevte aktualizace řešení.

  1. Připojte se k počítači v místním prostředí Azure pomocí uživatelského účtu nasazení.

  2. Přejděte do sdílené síťové složky a získejte balíček aktualizace, který používáte. Ověřte, že importovaná aktualizace balíčku obsahuje následující soubory:

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

    Pokud je rozšíření tvůrce řešení součástí balíčku aktualizací, měli byste vidět také následující soubory:

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

  3. Stáhněte si soubory, ke kterým chcete importovat, do umístění, ke kterému má vaše místní instance Azure přístup. Pokud importujete rozšíření řešení, vždy stáhnete tři soubory, které odpovídají následujícímu vzoru pojmenování:

    Vzor názvu souboru Příklad Popis
    SBE_Discovery_<Výrobce>.xml SBE_Discovery_Contoso.xml Manifest zjišťování rozšíření řešení, který umožňuje zjišťování aktualizací.
    SBE_<Výrobce>_<Rodina>_<Verze>.xml SBE_Contoso_GenA_4.1.2410.5.xml Soubor s inventářem rozšíření řešení a podepsaným softwarovým vyúčtováním materiálů
    SBE_<Výrobce>_<Rodina>_<Verze>.zip SBE_Contoso_GenA_4.1.2410.5.zip Soubor s příponou typu řešení a obsahem payload.

  4. Vytvořte složku pro zjišťování pomocí aktualizační služby v následujícím umístění ve svazku infrastruktury vašeho systému.

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

  5. Zkopírujte aktualizační soubory do složky, kterou jste vytvořili v předchozím kroku.

  6. Balíček aktualizace můžete vyhledat ručně pomocí služby Update. Spusťte následující příkaz:

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

  7. Ověřte, že služba Update zjistí balíček aktualizace a že je k dispozici pro zahájení přípravy a instalace. Opakujte příkaz Get-SolutionUpdate, aby se aktualizace znovu objevily.

Aktualizaci si můžete stáhnout a provést sadu kontrol, abyste ověřili připravenost aktualizací clusteru bez spuštění instalace.

  1. Pokud chcete stáhnout aktualizace bez spuštění instalace, spusťte následující příkaz:

    Get-SolutionUpdate -Id <ResourceId> | Start-SolutionUpdate –PrepareOnly
    Rozbalením této části zobrazíte ukázkový výstup.

    Tady je příklad výstupu:

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

  2. Pokud chcete sledovat průběh aktualizace, monitorujte stav aktualizace. Spusťte následující příkaz:

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

    Při spuštění aktualizace dojde k následujícím akcím:

    • Začne stahování aktualizací. V závislosti na velikosti balíčku pro stahování a šířce pásma sítě může stahování trvat několik minut.
    Rozbalením této části zobrazíte ukázkový výstup.

    Tady je příklad výstupu při stahování aktualizací:

    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. Jakmile se balíček stáhne, provede se kontroly připravenosti k vyhodnocení připravenosti aktualizace vašeho systému. Další informace o kontrolách připravenosti najdete ve fázích aktualizace. Během této fáze se stav aktualizace zobrazuje jako HealthChecking.

    Rozbalením této části zobrazíte ukázkový výstup. 
    PS C:\Users\lcmuser> Get-SolutionUpdate|ft Version,State,UpdateStateProperties,HealthState

Version         State             HealthState
-------         -----             --------------------- 
10.2408.2.7     HealthChecking    InProgress

  4. Po dokončení kontrol připravenosti je systém připravený k instalaci aktualizací. Ukazatel State aktualizace se zobrazuje jako ReadyToInstall. Pokud se State aktualizace zobrazí jako HealthCheckFailed, podívejte se na řešení potíží s kontrolami připravenosti , než budete pokračovat.

Krok 5: Spuštění aktualizace

Během instalace se můžou systémové počítače restartovat a možná budete muset znovu navázat vzdálenou relaci PowerShellu, abyste mohli aktualizace monitorovat. Pokud aktualizujete jeden počítač, dojde k výpadku v místním prostředí Azure.

Spusťte aktualizaci tak, že vyberete jednu aktualizaci a předáte ji Start-SolutionUpdate.

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

Poznámka:

Pokud došlo ke přeskočení kroku 4 (a neproběhlo podobné volání Start-SolutionUpdate -PrepareOnly), volání Start-SolutionUpdate nejprve stáhne aktualizace a provede sadu kontrol, aby byla ověřena připravenost aktualizace clusteru před zahájením její instalace.

Rozbalením této části zobrazíte ukázkový výstup. 
PS C:\Users\lcmuser> $InstanceId = Get-SolutionUpdate -Id redmond/Solution10.2408.2.7 | Start-SolutionUpdate

Tím se spustí proces instalace aktualizace.

Spropitné

$InstanceId Uložte soubor tak, jak byste ho mohli použít později k řešení potíží s aktualizacemi řešení pro místní Azure.

Krok 6: Sledování průběhu aktualizace

Microsoft doporučuje sledovat průběh aktualizace clusteru na webu Azure Portal po spuštění aktualizace. Portál je výbornou volbou pro sledování průběhu aktualizace, i když je aktualizace spuštěna prostřednictvím PowerShellu, protože není ovlivněn přerušením v hlášení o stavu.

Spropitné

  • Pokud monitorování provádíte přes PowerShell, doporučujeme připojit relaci PowerShellu k poslednímu serveru v clusteru, abyste se vyhnuli předčasnému odpojení relace. Relace se odpojí při restartování systémů, takže přepnutí na monitorování z již aktualizovaného serveru může minimalizovat frekvenci odpojení.
  • Doporučujeme sledovat průběh aktualizace clusteru na webu Azure Portal, abyste se nemuseli znovu připojovat k relacím PowerShellu po restartování počítače.

Pokud chcete sledovat průběh aktualizace pomocí PowerShellu, postupujte podle těchto kroků.

  1. Pokud chcete sledovat průběh aktualizace, monitorujte stav aktualizace. Spusťte následující příkaz:

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

    Aktualizace prochází několika stavy, jak je popsáno ve fázích aktualizace revizí.

    Pomocí výše uvedeného příkazu následující příklady ukazují, jak monitorovat aktualizaci při procházení těmito fázemi pomocí State a UpdateStateProperties vlastností.

    • Stav stahování

      Krátce po zavolání Start-SolutionUpdate začne stahování aktualizací. V závislosti na velikosti balíčku pro stahování a šířce pásma sítě může stahování trvat několik minut.

      Rozbalením této části zobrazíte ukázkový výstup.

      Tady je příklad výstupu při stahování aktualizací:

      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

    • Příprava stavu

      Po stažení aktualizací je potřeba aktualizace připravit. V přípravném stavu jsou hodnoty hash aktualizačních souborů potvrzeny a soubory se extrahují k přípravě a etapování aktualizačních souborů.

      Rozbalením této části zobrazíte ukázkový výstup.

      Tady je příklad výstupu při stahování aktualizací:

      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

    • Stav kontroly zdraví

      Jakmile jsou aktualizace připravené, provede se kontroly připravenosti pro vyhodnocení připravenosti aktualizací vašeho clusteru. Další informace o kontrolách připravenosti najdete ve fázích aktualizace.

      Během této fáze se State aktualizace zobrazuje jako HealthChecking. Pokud se State aktualizace zobrazí jako HealthCheckFailed, podívejte se na řešení potíží s kontrolami připravenosti , než budete pokračovat.

      Rozbalením této části zobrazíte ukázkový výstup.

      Tady je příklad výstupu při procesu aktualizací: 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

    • Stav instalace Jakmile je systém připraven, aktualizace přejde na Installing. Během této fáze se State aktualizací zobrazuje jako Installing a UpdateStateProperties zobrazuje procento dokončené instalace.

      Rozbalením této části zobrazíte ukázkový výstup.

      Tady je příklad výstupu při procesu aktualizací: 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

Po dokončení instalace se stav změní na Installed. Další informace o různých stavech aktualizací najdete v tématu Průběh instalace a monitorování.

Krok 7: Obnovení aktualizace (v případě potřeby)

Pokud chcete obnovit dříve neúspěšnou aktualizaci přes PowerShell, použijte následující příkaz:

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

Pokud chcete obnovit dříve neúspěšnou aktualizaci z důvodu kontrol připravenosti aktualizací v Warning stavu, použijte následující příkaz:

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

Informace o řešení jiných problémů se spuštěním aktualizací najdete v tématu Řešení potíží s aktualizacemi.

Krok 8: Ověření instalace

Po instalaci aktualizací ověřte verzi řešení prostředí a verzi operačního systému.

  1. Po aktualizaci je ve stavu Installed, zkontrolujte verzi řešení prostředí. Spusťte následující příkaz:

    Get-SolutionUpdateEnvironment | ft State, CurrentVersion
    Rozbalením této části zobrazíte ukázkový výstup. 
    PS C:\Users\lcmuser> Get-SolutionUpdateEnvironment | ft State, CurrentVersion

State               CurrentVersion
-----               --------------
AppliedSuccessfully 10.2408.2.7

  2. Zkontrolujte verzi operačního systému a ověřte, že odpovídá nainstalovanému receptu. Spusťte následující příkaz:

    cmd /c ver
    Rozbalením této části zobrazíte ukázkový výstup.

    Tady je ukázkový výstup:

    PS C:\Users\lcmuser> cmd /c ver

Microsoft Windows [Version 10.0.25398.1189]
PS C:\Users\lcmuser>

Další krok