Uw Lokale Versie 23H2 van Azure bijwerken via PowerShell

Van toepassing op: Azure Local, versie 23H2

In dit artikel wordt beschreven hoe u een oplossingsupdate kunt toepassen op uw Lokale Azure Via PowerShell.

De procedure in dit artikel is van toepassing op systemen met één knooppunt en meerdere knooppunten waarop de nieuwste versie van Azure Local wordt uitgevoerd waarop de orchestrator (Lifecycle Manager) is geïnstalleerd. Als uw systeem is gemaakt via een nieuwe implementatie van Azure Local, versie 23H2, is de orchestrator automatisch geïnstalleerd als onderdeel van de implementatie.

Belangrijk

De hier beschreven procedure is alleen van toepassing bij het bijwerken van één versie van Azure Local, versie 23H2 naar een andere hogere versie. Zie Updateclusters voor Azure Local versie 22H2 voor meer informatie over updates voor oudere versies.

Over oplossingsupdates

De updates voor lokale Azure-oplossingen kunnen bestaan uit updates voor platform-, service- en oplossingsuitbreidingen. Zie Over updates voor Azure Local versie 23H2 voor meer informatie over elk van deze typen updates.

Wanneer u een oplossingsupdate toepast, zijn dit de stappen op hoog niveau die u uitvoert:

1. Zorg ervoor dat alle vereisten zijn voltooid.
2. Maak verbinding met uw lokale Azure-exemplaar via externe PowerShell.
3. Bevestig de huidige geïnstalleerde softwareversies en controleer of uw cluster in goede staat is.
4. Ontdek de updates die beschikbaar zijn en filter de updates die u op uw systeem kunt toepassen.
5. (Aanbevolen) Download de updates vooraf en beoordeel de updategereedheid van uw systeem.
6. Installeer de updates en volg de voortgang van de updates. Bewaak zo nodig de gedetailleerde voortgang.
7. Controleer de versie van de geïnstalleerde updates.

De tijd die nodig is om de updates te installeren, is afhankelijk van de volgende factoren:

• Inhoud van de update.
• Laad uw systeem.
• Aantal computers in uw systeem.
• Type gebruikte hardware.
• Gebruikte oplossingsuitbreiding.

De geschatte tijdschattingen voor een typisch systeem met één of meerdere knooppunten worden samengevat in de volgende tabel:

Systeem/tijd	Tijd voor statuscontrole uu:mm:ss	Tijd om update te installeren uu:mm:ss
Eén knooppunt	~ 03.00	~ 01:30
4 knooppunten	~ 05:00	~ 04:00

Belangrijk

Het gebruik van hulpprogramma's van derden voor het installeren van updates wordt niet ondersteund.

Vereisten

Zorg voordat u begint voor het volgende:

• U hebt toegang tot een Lokaal Azure-systeem, versie 23H2 waarop 2311 of hoger wordt uitgevoerd. Het systeem moet worden geregistreerd in Azure.
• U hebt toegang tot een client die verbinding kan maken met uw Lokale Azure-client.
• U hebt toegang tot de oplossingsupdate via het netwerk.

Verbinding maken met uw lokale Azure-app

Volg deze stappen op uw client om verbinding te maken met een van de machines in azure Local.

1. Voer PowerShell uit als beheerder op de client die u gebruikt om verbinding te maken met uw systeem.

2. Open een externe PowerShell-sessie naar een computer op uw lokale Azure-computer. Voer de volgende opdracht uit en geef de referenties van uw computer op wanneer u hierom wordt gevraagd:

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

   Notitie

   Meld u aan met de inloggegevens van uw implementatie-account. Dit is het account dat u hebt gemaakt bij het voorbereiden van Active Directory- en wordt gebruikt om Azure Local te implementeren.

   Vouw deze sectie uit om een voorbeelduitvoer te zien.

   Hier volgt een voorbeeld van uitvoer:

   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>
   

Stap 1: Software bevestigen en de systeemstatus controleren

Voordat u de updates ontdekt, moet u ervoor zorgen dat op uw systeem Azure Local, versie 23H2, softwareversie 2311 of hoger wordt uitgevoerd.

1. Zorg ervoor dat u bent verbonden met de machine met behulp van het gebruikersaccount voor de implementatie. Voer de volgende opdracht uit:

   whoami
   

2. Voer de volgende opdracht uit op een van de computers van uw systeem om ervoor te zorgen dat het systeem Azure Local, versie 23H2, uitvoert:

   Get-SolutionUpdateEnvironment
   

   Vouw deze sectie uit om een voorbeelduitvoer te zien.

   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. Noteer de CurrentVersion op uw systeem. De huidige versie weerspiegelt de oplossingsversie waarop uw systeem wordt uitgevoerd.

4. Controleer de HealthState op uw systeem en verifieer of uw systeem in goede staat is. Als de HealthState Failure, Error, of Warningis, raadpleeg dan Problemen met gereedheidscontroles oplossen voordat u verdergaat.

Stap 2: De updates detecteren

Volg deze stappen om de beschikbare updates voor uw systeem te detecteren:

1. Maak verbinding met een machine op uw Azure Local met behulp van het implementatiegebruikersaccount.

2. Bekijk de details van updates die Ready zijn om te installeren met behulp van Get-SolutionUpdate.

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

   Vouw deze sectie uit om een voorbeelduitvoer te zien.

   Hier volgt een voorbeeld van uitvoer:

   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
   

   Dit kan een of meer opties bevatten, inclusief vermeldingen voor zowel volledige Solution-updates (die mogelijk ook een Solution Builder-extensie bevatten) als zelfstandige SBE-updates.

   Als er geen verwachte update wordt weergegeven, verwijdert u het filter uit de opdracht om te zien of het wordt vermeld in non-ready status:

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

   Zie Over updatefasen voor meer informatie over updatestatussen.

3. Selecteer de update die u wilt installeren en noteer de bijbehorende ResourceId. Controleer de details van de update om te bevestigen dat u de gewenste update hebt geselecteerd die u wilt installeren.

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

   Vouw deze sectie uit om een voorbeelduitvoer te zien.

   Hier volgt een voorbeeld van uitvoer:

   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}
   

   Notitie

   Het is normaal dat HealthStateUnknown is voor een update die nog niet is gepland of voorbereid.

4. Controleer eventueel de versies van de onderdelen van het updatepakket.

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

   Vouw deze sectie uit om een voorbeelduitvoer te zien.

   Hier volgt een voorbeeld van uitvoer:

   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>
   
   

U kunt nu doorgaan met downloaden en installeren van de updates.

Stap 3: Updates importeren en opnieuw ontdekken

Dit is een optionele stap. Het importeren van updates kan vereist zijn in een van de volgende scenario's:

• De update die u wilt installeren, rapporteert een AdditionalContentRequiredstatus. Er is mogelijk extra inhoud vereist voordat u de update in de status AdditionalContentRequiredkunt plannen. Zie Solution Extension-updates op Azure Local, versie 23H2voor meer informatie over deze status en over updates voor oplossingsuitbreidingen.

• De update die u wilt installeren, wordt niet vermeld omdat ondersteuning u een privérelease biedt om een probleem op te lossen dat u ondervindt.

• De update wordt vermeld als Ready, maar omdat uw systeem beperkte netwerkconnectiviteit heeft, wilt u de online downloadfase van de update van de oplossingsuitbreiding voorkomen.

Volg deze stappen om uw oplossingsupdates te importeren en te detecteren.

1. Maak verbinding met een machine op uw Azure Local met behulp van het implementatiegebruikersaccount.

2. Ga naar de netwerkshare en haal het updatepakket op dat u gebruikt. Controleer of het updatepakket dat u importeert de volgende bestanden bevat:

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

   Als een bouwerextensie voor oplossingen deel uitmaakt van het updatepakket, ziet u ook de volgende bestanden:

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

3. Download de bestanden die u wilt importeren naar een locatie waartoe uw Lokale Azure-exemplaar toegang heeft. Als u een oplossingsextensie importeert, downloadt u altijd drie bestanden die overeenkomen met het volgende naamgevingspatroon:

   Bestandsnaampatroon	Voorbeeld	Beschrijving
   SBE_Discovery_<Fabrikant>.xml	SBE_Discovery_Contoso.xml	Een detectiemanifest voor oplossingsuitbreidingen waarmee updatedetectie mogelijk is.
   SBE_<Manufacturer>_<Family>_<versie>.xml	SBE_Contoso_GenA_4.1.2410.5.xml	Een bestand met inventaris van de oplossingsextensie en ondertekende softwarefactuur van materialen
   SBE_<Fabrikant>_<Familie>_<Versie>.zip	SBE_Contoso_GenA_4.1.2410.5.zip	Een bestand met een payload van een oplossingsextensie

4. Maak een map voor detectie door de updateservice op de volgende locatie in het infrastructuurvolume van uw systeem.

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

5. Kopieer de updatebestanden naar de map die u in de vorige stap hebt gemaakt.

6. Ontdek het updatepakket handmatig met behulp van de Update-service. Voer de volgende opdracht uit:

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

7. Controleer of de Update-service het updatepakket detecteert en of het beschikbaar is om de voorbereiding en installatie te starten. Herhaal de Get-SolutionUpdate opdracht om de updates opnieuw te ontdekken.

Stap 4: (Aanbevolen) Vooraf downloaden en de gereedheid van updates controleren

U kunt de update downloaden en een reeks controles uitvoeren om de gereedheid van de update van uw cluster te controleren zonder de installatie te starten.

1. Voer de volgende opdracht uit om de updates te downloaden zonder de installatie te starten:

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

   Vouw deze sectie uit om een voorbeelduitvoer te zien.

   Hier is een uitvoervoorbeeld:

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

2. Als u de voortgang van de update wilt bijhouden, controleert u de updatestatus. Voer de volgende opdracht uit:

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

   Wanneer de update wordt gestart, vinden de volgende acties plaats:

   • Het downloaden van de updates wordt gestart. Afhankelijk van de grootte van het downloadpakket en de netwerkbandbreedte kan het downloaden enkele minuten duren.
   Vouw deze sectie uit om een voorbeelduitvoer te zien.

   Hier volgt een voorbeeld van uitvoer wanneer de updates worden gedownload:

   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. Zodra het pakket is gedownload, worden gereedheidscontroles uitgevoerd om de gereedheid van uw systeem te beoordelen. Zie Updatefasen voor meer informatie over de gereedheidscontroles. Tijdens deze fase wordt de status van de update weergegeven als HealthChecking.

   Vouw deze sectie uit om een voorbeelduitvoer te zien.

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

4. Wanneer de gereedheidscontroles worden uitgevoerd, is het systeem klaar om updates te installeren. De State van de update wordt weergegeven als ReadyToInstall. Als de State van de update wordt weergegeven als HealthCheckFailed, raadpleeg dan Probleemoplossing voor gereedheidscontroles voordat u verdergaat.

Stap 5: De update starten

Tijdens de installatie kunnen de systeemcomputers opnieuw worden opgestart en moet u mogelijk de externe PowerShell-sessie opnieuw tot stand brengen om de updates te controleren. Als u één machine bijwerkt, ondervindt uw Azure Local een downtime.

Start een update door één update te selecteren en door te geven aan Start-SolutionUpdate.

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

Notitie

Als stap 4 is overgeslagen (en u geen vergelijkbare aanroep naar Start-SolutionUpdate -PrepareOnlyhebt gedaan), zal Start-SolutionUpdate eerst de updates downloaden en een reeks controles uitvoeren om de gereedheid van uw cluster voor de update te controleren voordat u de update-installatie start.

Vouw deze sectie uit om een voorbeelduitvoer te zien.

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

Hiermee start u het proces voor het installeren van de update.

Tip

Sla de op, omdat u deze later kunt gebruiken om oplossingsupdates voor lokale Azure-op te lossen.

Stap 6: Voortgang van update bijhouden

Microsoft raadt u aan de voortgang van clusterupdates bij te houden in Azure Portal nadat de update is gestart. De portal is een uitstekende optie voor het bijhouden van de voortgang van updates, zelfs wanneer de update wordt gestart via PowerShell, omdat deze niet onderhevig is aan de onderbrekingen in statusrapportage.

Fooi

• Als u de bewaking via PowerShell gebruikt, raden we u aan om uw PowerShell-sessie te verbinden met de laatste server in uw cluster om te voorkomen dat de sessie vroeg wordt verbroken. De sessies worden verbroken wanneer de systemen opnieuw worden opgestart, dus door over te schakelen naar een al bijgewerkte server kan de frequentie van de verbrekingen worden geminimaliseerd.
• U wordt aangeraden de voortgang van de clusterupdate bij te houden in Azure Portal om te voorkomen dat u opnieuw verbinding moet maken met PowerShell-sessies na het opnieuw opstarten van de computer.

Volg deze stappen om de voortgang van de update bij te houden met behulp van PowerShell.

1. Als u de voortgang van de update wilt bijhouden, controleert u de updatestatus. Voer de volgende opdracht uit:

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

   De update doorloopt verschillende statussen, zoals beschreven in Updatefasen beoordelen.

   Met behulp van de bovenstaande opdracht laten de volgende voorbeelden zien hoe u de update kunt bewaken terwijl deze fasen doorlopen met behulp van de eigenschappen State en UpdateStateProperties.

   • Status downloaden

     Kort nadat Start-SolutionUpdate wordt aangeroepen, wordt het downloaden van de updates gestart. Afhankelijk van de grootte van het downloadpakket en de netwerkbandbreedte kan het downloaden enkele minuten duren.

     Vouw deze sectie uit om een voorbeelduitvoer te zien.

     Hier volgt een voorbeeld van uitvoer wanneer de updates worden gedownload:

     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
     

   • Voorbereidende status

     Zodra de updates zijn gedownload, moeten de updates worden voorbereid. In de voorbereidingsstatus worden de hashes van de updatebestanden bevestigd en worden bestanden geëxtraheerd om bestanden voor te bereiden en bij te werken.

     Vouw deze sectie uit om een voorbeelduitvoer te zien.

     Hier volgt een voorbeeld van uitvoer wanneer de updates worden gedownload:

     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
     

   • Gezondheidscontrole status

     Zodra de updates zijn voorbereid, worden gereedheidscontroles uitgevoerd om de gereedheid van uw cluster te beoordelen. Zie Updatefasen voor meer informatie over de gereedheidscontroles.

     Tijdens deze fase wordt de State van de update weergegeven als HealthChecking. Als de State van de update wordt weergegeven als HealthCheckFailed, bekijkt u Problemen oplossen met gereedheidscontroles voordat u verdergaat.

     Vouw deze sectie uit om een voorbeelduitvoer te zien.

     Hier volgt een voorbeeld van uitvoer wanneer de updates worden uitgevoerd 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
     

   • Installatiestatus Wanneer het systeem gereed is, wordt de update overgestapt op Installing. Tijdens deze fase wordt het State van de updates weergegeven als Installing, en geeft UpdateStateProperties het percentage van de voltooide installatie weer.

     Vouw deze sectie uit om een voorbeelduitvoer te zien.

     Hier is een voorbeeld van de output wanneer de updates worden uitgevoerd 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
     

Zodra de installatie is voltooid, wordt de status gewijzigd in Installed. Zie de voortgang en bewaking van de installatie voor meer informatie over de verschillende statussen van de updates.

Stap 7: De update hervatten (indien nodig)

Gebruik de volgende opdracht om een eerder mislukte update te hervatten via PowerShell:

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

Gebruik de volgende opdracht om een eerder mislukte update te hervatten vanwege controles van updategereedheid in een Warning status:

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

Zie Problemen met updates oplossenom andere problemen met het uitvoeren van updates op te lossen.

Stap 8: De installatie controleren

Nadat de updates zijn geïnstalleerd, controleert u de oplossingsversie van de omgeving en de versie van het besturingssysteem.

1. Nadat de update de Installed status heeft, controleert u de versie van de omgevingsoplossing. Voer de volgende opdracht uit:

   Get-SolutionUpdateEnvironment | ft State, CurrentVersion
   

   Vouw deze sectie uit om een voorbeelduitvoer te zien.

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

2. Controleer de versie van het besturingssysteem om te bevestigen dat deze overeenkomt met het recept dat u hebt geïnstalleerd. Voer de volgende opdracht uit:

   cmd /c ver
   

   Vouw deze sectie uit om een voorbeelduitvoer te zien.

   Hier volgt een voorbeelduitvoer:

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

Volgende stap

• Zie Problemen met updates oplossenals u problemen ondervindt tijdens het updateproces.

• Meer informatie over het Updateversie 22H2 wanneer de orchestrator niet geïnstalleerd is.