Monitorování aktualizací ve službě Azure Stack Hub pomocí privilegovaného koncového bodu

Článek
03/20/2025

Privilegovaný koncový bod můžete použít k monitorování průběhu spuštění aktualizace služby Azure Stack Hub. K obnovení neúspěšné aktualizace z posledního úspěšného kroku můžete použít také privilegovaný koncový bod, pokud portál Azure Stack Hub přestane být dostupný. Použití portálu Azure Stack Hub je doporučená metoda správy aktualizací ve službě Azure Stack Hub.

Následující nové rutiny PowerShellu pro správu aktualizací jsou součástí aktualizace 1710 integrovaných systémů služby Azure Stack Hub.

Cmdlet	Popis
`Get-AzureStackUpdateStatus`	Vrátí stav aktuálně spuštěné, dokončené nebo neúspěšné aktualizace. Poskytuje stav operace aktualizace na vysoké úrovni a dokument XML, který popisuje aktuální krok i odpovídající stav.
`Resume-AzureStackUpdate`	Obnoví neúspěšnou aktualizaci v okamžiku, kdy selhala. V některých scénářích možná budete muset před pokračováním aktualizace dokončit kroky pro zmírnění rizik.

Ověřte, že jsou cmdlety k dispozici.

Vzhledem k tomu, že rutiny jsou v balíčku aktualizace 1710 pro Azure Stack Hub nové, musí se proces aktualizace 1710 dostat k určitému bodu, než bude funkce monitorování k dispozici. Typicky jsou cmdlety dostupné, pokud stav na portálu pro správu indikuje, že aktualizace 1710 je v kroku Restartování hostitelů úložiště. Konkrétně k aktualizaci cmdletu dochází během kroku: Spuštění kroku 2.6 – aktualizace seznamu povolených PrivilegedEndpoint.

Pomocí dotazu na seznam příkazů z privilegovaného koncového bodu můžete také určit, jestli jsou rutiny k dispozici prostřednictvím kódu programu. Tento dotaz provedete spuštěním následujících příkazů z hostitele životního cyklu hardwaru nebo pracovní stanice s privilegovaným přístupem. Také se ujistěte, že privilegovaný koncový bod je důvěryhodným hostitelem. Další informace najdete v kroku 1 Přístup k privilegovanému koncovému bodu.

Vytvořte relaci PowerShellu na libovolném virtuálním počítači ERCS v prostředí služby Azure Stack Hub (předpona-ERCS01, předpona-ERCS02 nebo předpona-ERCS03). Nahraďte předponu řetězcem předpony VM, který je specifický pro vaše prostředí.
```
$cred = Get-Credential

$pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
```
Po zobrazení výzvy k zadání přihlašovacích údajů použijte <doménu služby Azure Stack Hub>\cloudadmin nebo účet, který je členem skupiny CloudAdmins. Pro účet CloudAdmin zadejte stejné heslo, které jste zadali během instalace pro účet správce domény AzureStackAdmin.
Získejte úplný seznam příkazů, které jsou k dispozici v privilegovaném koncovém bodu.
```
$commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command } 
```

Zjistěte, jestli se privilegovaný koncový bod aktualizoval.

$updateManagementModuleName = "Microsoft.Azurestack.UpdateManagement"
 if (($commands | ? Source -eq $updateManagementModuleName)) {
Write-Host "Privileged endpoint was updated to support update monitoring tools."
 } else {
Write-Host "Privileged endpoint has not been updated yet. Please try again later."
 }

Vypíše příkazy specifické pro modul Microsoft.AzureStack.UpdateManagement.

$commands | ? Source -eq $updateManagementModuleName

Například:

$commands | ? Source -eq $updateManagementModuleName

CommandType     Name                                               Version    Source                                                  PSComputerName
 -----------     ----                                               -------    ------                                                  --------------
Function        Get-AzureStackUpdateStatus                         0.0        Microsoft.Azurestack.UpdateManagement                   Contoso-ercs01
Function        Resume-AzureStackUpdate                            0.0        Microsoft.Azurestack.UpdateManagement                   Contoso-ercs01

Použití rutin pro správu aktualizací

Poznámka

Z hostitele životního cyklu hardwaru nebo pracovní stanice s privilegovaným přístupem spusťte následující příkazy. Také se ujistěte, že privilegovaný koncový bod je důvěryhodným hostitelem. Další informace najdete v kroku 1 Přístup k privilegovanému koncovému bodu.

Připojení k privilegovanému koncovému bodu a přiřazení proměnné relace

Spuštěním následujících příkazů vytvořte relaci PowerShellu na libovolném virtuálním počítači ERCS v prostředí služby Azure Stack Hub (Předpona-ERCS01, Předpona-ERCS02 nebo Předpona-ERCS03) a přiřaďte proměnnou relace.

$cred = Get-Credential

$pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)

Po zobrazení výzvy k zadání přihlašovacích údajů použijte <doménu služby Azure Stack Hub>\cloudadmin nebo účet, který je členem skupiny CloudAdmins. Pro účet CloudAdmin zadejte stejné heslo, které jste zadali během instalace pro účet správce domény AzureStackAdmin.

Získat přehled o stavu aktuálního běhu aktualizace

Pokud chcete získat základní stav spuštění aktuální aktualizace, spusťte následující příkazy:

$statusString = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus -StatusOnly }

$statusString.Value

Mezi možné hodnoty patří:

Běhání
Hotový
Neúspěšný
Zrušený

Tyto příkazy můžete spouštět opakovaně, abyste viděli nejvíce up-tostavu -date. Připojení nemusíte znovu navazovat, abyste ho mohli znovu zkontrolovat.

Získání stavu úplného spuštění aktualizace s podrobnostmi

Souhrn úplného spuštění aktualizace můžete získat jako řetězec XML. Řetězec můžete napsat do souboru ke zkoumání nebo ho převést na dokument XML a pomocí PowerShellu ho parsovat. Následující příkaz parsuje XML, aby získal hierarchický seznam aktuálně spuštěných kroků:

[xml]$updateStatus = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus }

$updateStatus.SelectNodes("//Step[@Status='InProgress']")

V následujícím příkladu má krok nejvyšší úrovně (Cloud Update) podřízený plán aktualizace a restartování hostitelů úložiště. Ukazuje, že plán Restartování hostitelů úložiště aktualizuje službu Blob Storage na jednom z hostitelů.

[xml]$updateStatus = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus }

$updateStatus.SelectNodes("//Step[@Status='InProgress']") 

    FullStepIndex : 2
    Index         : 2
    Name          : Cloud Update
    Description   : Perform cloud update.
    StartTimeUtc  : 2017-10-13T12:50:39.9020351Z
    Status        : InProgress
    Task          : Task
    
    FullStepIndex  : 2.9
    Index          : 9
    Name           : Restart Storage Hosts
    Description    : Restart Storage Hosts.
    EceErrorAction : Stop
    StartTimeUtc   : 2017-10-13T15:44:06.7431447Z
    Status         : InProgress
    Task           : Task
    
    FullStepIndex : 2.9.2
    Index         : 2
    Name          : PreUpdate ACS Blob Service
    Description   : Check function level, update deployment artifacts, configure Blob service settings
    StartTimeUtc  : 2017-10-13T15:44:26.0708525Z
    Status        : InProgress
    Task          : Task

Obnovení neúspěšné operace aktualizace

Pokud se aktualizace nezdaří, můžete pokračovat ve spuštění aktualizace tam, kde skončila.

Invoke-Command -Session $pepSession -ScriptBlock { Resume-AzureStackUpdate }

Řešit problémy

Privilegovaný koncový bod je k dispozici na všech virtuálních počítačích ERCS v prostředí služby Azure Stack Hub. Vzhledem k tomu, že se připojení nepřidává ke koncovému bodu s vysokou dostupností, může docházet k občasné přerušení, upozornění nebo chybovým zprávám. Tyto zprávy můžou znamenat, že relace byla odpojena nebo že došlo k chybě při komunikaci se službou ECE. Toto chování je očekávané. Operaci můžete zkusit zopakovat během několika minut nebo vytvořit novou relaci privilegovaného koncového bodu na jednom z dalších virtuálních počítačů ERCS.

Další informace o řešení potíží s aktualizacemi najdete v tématu řešení potíží se službou Azure Stack

Další kroky

Správa aktualizací ve službě Azure Stack Hub

Sdílet prostřednictvím