Monitorování aktualizací služby Azure Stack Hub pomocí privilegovaného koncového boduMonitor updates in Azure Stack Hub using the privileged endpoint

Pomocí privilegovaného koncového bodu můžete monitorovat průběh spuštění aktualizace centra Azure Stack.You can use the privileged endpoint to monitor the progress of an Azure Stack Hub update run. Pomocí privilegovaného koncového bodu můžete také pokračovat v neúspěšném spuštění aktualizace z posledního úspěšného kroku, protože portál Azure Stack hub nebude k dispozici.You can also use the privileged endpoint to resume a failed update run from the last successful step should the Azure Stack Hub portal become unavailable. Použití portálu centra Azure Stack je doporučená metoda pro správu aktualizací v centru Azure Stack.Using the Azure Stack Hub portal is the recommended method to manage updates in Azure Stack Hub.

Následující nové rutiny PowerShellu pro správu aktualizací jsou součástí aktualizace 1710 pro integrované systémy Azure Stack hub.The following new PowerShell cmdlets for update management are included in the 1710 update for Azure Stack Hub integrated systems.

RutinaCmdlet PopisDescription
Get-AzureStackUpdateStatus Vrátí stav aktuálně spuštěných, dokončených nebo neúspěšných aktualizací.Returns the status of the currently running, completed, or failed update. Poskytuje stav operace aktualizace na nejvyšší úrovni a dokumentu XML, který popisuje aktuální a odpovídající stav.Provides the high-level status of the update operation and an XML document that describes both the current step and the corresponding state.
Resume-AzureStackUpdate Obnoví neúspěšnou aktualizaci v místě, kde se nezdařila.Resumes a failed update at the point where it failed. V některých scénářích může být nutné před pokračováním aktualizace dokončit kroky pro zmírnění rizik.In certain scenarios, you may have to complete mitigation steps before you resume the update.

Ověřte, jestli jsou dostupné rutiny.Verify the cmdlets are available

Vzhledem k tomu, že rutiny jsou nové v balíčku aktualizace 1710 pro centrum Azure Stack, musí se proces aktualizace 1710 dostat do určitého bodu, než bude k dispozici možnost monitorování.Because the cmdlets are new in the 1710 update package for Azure Stack Hub, the 1710 update process needs to get to a certain point before the monitoring capability is available. Rutiny jsou obvykle dostupné, pokud stav na portálu pro správu označuje, že aktualizace 1710 je v kroku restartovat úložiště hostitelé .Typically, the cmdlets are available if the status in the administrator portal indicates that the 1710 update is at the Restart Storage Hosts step. Konkrétně proběhne aktualizace rutiny během kroku: krok 2,6 – aktualizace seznamu povolených PrivilegedEndpoint.Specifically, the cmdlet update occurs during Step: Running step 2.6 - Update PrivilegedEndpoint whitelist.

Můžete také zjistit, jestli jsou rutiny k dispozici programově pomocí dotazu na seznam příkazů z privilegovaného koncového bodu.You can also determine whether the cmdlets are available programmatically by querying the command list from the privileged endpoint. K provedení tohoto dotazu spusťte následující příkazy z hostitele životního cyklu hardwaru nebo z pracovní stanice privilegovaného přístupu.To do this query, run the following commands from the hardware lifecycle host or from a Privileged Access Workstation. Také se ujistěte, že je privilegovaným koncovým bodem důvěryhodný hostitel.Also, make sure the privileged endpoint is a trusted host. Další informace najdete v části Krok 1 přístupu k privilegovanému koncovému bodu.For more information, see step 1 of Access the privileged endpoint.

  1. Vytvořte relaci PowerShellu na libovolném virtuálním počítači s ERCS ve vašem prostředí centra Azure Stack (předpona-ERCS01, prefix-ERCS02 nebo prefix-ERCS03).Create a PowerShell session on any of the ERCS virtual machines (VMs) in your Azure Stack Hub environment (Prefix-ERCS01, Prefix-ERCS02, or Prefix-ERCS03). Nahraďte předponu řetězcem PŘEDPONY virtuálního počítače, který je specifický pro vaše prostředí.Replace Prefix with the VM prefix string that's specific to your environment.

    $cred = Get-Credential
    
    $pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint 
    

    Po zobrazení výzvy k zadání přihlašovacích údajů použijte účet služby < Azure Stack hub Domain > \cloudadmin nebo účet, který je členem skupiny CloudAdmins.When prompted for credentials, use the <Azure Stack Hub domain>\cloudadmin account, or an account that's a member of the CloudAdmins group. Pro účet CloudAdmin zadejte stejné heslo, které bylo zadáno během instalace pro účet správce domény AzureStackAdmin.For the CloudAdmin account, enter the same password that was provided during installation for the AzureStackAdmin domain administrator account.

  2. Získejte úplný seznam příkazů, které jsou k dispozici v privilegovaném koncovém bodu.Get the full list of commands that are available in the privileged endpoint.

    $commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command } 
    
  3. Zjistěte, jestli se privilegovaný koncový bod aktualizoval.Determine if the privileged endpoint was updated.

    $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."
     } 
    
  4. Zobrazí seznam příkazů, které jsou specifické pro modul Microsoft. AzureStack. UpdateManagement.List the commands specific to the Microsoft.AzureStack.UpdateManagement module.

    $commands | ? Source -eq $updateManagementModuleName 
    

    Například:For example:

    $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íUse the update management cmdlets

Poznámka

Spusťte následující příkazy z hostitele životního cyklu hardwaru nebo z pracovní stanice privilegovaného přístupu.Run the following commands from the hardware lifecycle host or from a Privileged Access Workstation. Také se ujistěte, že je privilegovaným koncovým bodem důvěryhodný hostitel.Also, make sure the privileged endpoint is a trusted host. Další informace najdete v části Krok 1 přístupu k privilegovanému koncovému bodu.For more information, see step 1 of Access the privileged endpoint.

Připojte se k privilegovanému koncovému bodu a přiřaďte proměnnou relace.Connect to the privileged endpoint and assign session variable

Spuštěním následujících příkazů vytvořte relaci PowerShellu na libovolném virtuálním počítači s ERCS v prostředí centra Azure Stack (předpona-ERCS01, prefix-ERCS02 nebo prefix-ERCS03) a přiřaďte proměnnou relace.Run the following commands to create a PowerShell session on any of the ERCS VMs in your Azure Stack Hub environment (Prefix-ERCS01, Prefix-ERCS02, or Prefix-ERCS03), and to assign a session variable.

$cred = Get-Credential

$pepSession = New-PSSession -ComputerName <Prefix>-ercs01 -Credential $cred -ConfigurationName PrivilegedEndpoint 

Po zobrazení výzvy k zadání přihlašovacích údajů použijte účet služby < Azure Stack hub Domain > \cloudadmin nebo účet, který je členem skupiny CloudAdmins.When prompted for credentials, use the <Azure Stack Hub domain>\cloudadmin account, or an account that's a member of the CloudAdmins group. Pro účet CloudAdmin zadejte stejné heslo, které bylo zadáno během instalace pro účet správce domény AzureStackAdmin.For the CloudAdmin account, enter the same password that was provided during installation for the AzureStackAdmin domain administrator account.

Získá stav vysoké úrovně pro aktuální běh aktualizace.Get high-level status of the current update run

Chcete-li získat stav vysoké úrovně aktuálního spuštění aktualizace, spusťte následující příkazy:To get a high-level status of the current update run, run the following commands:

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

$statusString.Value 

Mezi možné hodnoty patří:Possible values include:

  • SpuštěnoRunning
  • DokončenoCompleted
  • NeúspěšnýFailed
  • ZrušenoCanceled

Chcete-li zobrazit nejaktuálnější stav, můžete spustit tyto příkazy opakovaně.You can run these commands repeatedly to see the most up-to-date status. Nemusíte znovu navázat připojení pro kontrolu.You don't have to re-establish a connection to check again.

Získat úplný stav spuštění aktualizace s podrobnostmiGet the full update run status with details

Můžete získat souhrn úplného spuštění aktualizace jako řetězec XML.You can get the full update run summary as an XML string. Můžete napsat řetězec do souboru k vyhodnocení nebo ho převést na dokument XML a pomocí PowerShellu ho analyzovat.You can write the string to a file for examination, or convert it to an XML document and use PowerShell to parse it. Následující příkaz analyzuje soubor XML a získá hierarchický seznam aktuálně spuštěných kroků:The following command parses the XML to get a hierarchical list of the currently running steps:

[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ě (cloudová aktualizace) podřízený plán pro aktualizaci a restartování hostitelů úložiště.In the following example, the top-level step (Cloud Update) has a child plan to update and restart the storage hosts. Ukazuje, že je v plánu hostitelé restartování úložiště aktualizace služby Blob Storage na jednom z hostitelů.It shows that the Restart Storage Hosts plan is updating the Blob Storage service on one of the hosts.

[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

Obnoví neúspěšnou operaci aktualizace.Resume a failed update operation

Pokud se aktualizace nepovede, můžete pokračovat ve spuštění aktualizace, kde skončila.If the update fails, you can resume the update run where it left off.

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

Řešení potížíTroubleshoot

Privilegovaný koncový bod je k dispozici na všech virtuálních počítačích s ERCS v prostředí centra Azure Stack.The privileged endpoint is available on all ERCS VMs in the Azure Stack Hub environment. Vzhledem k tomu, že připojení není navázáno na koncový bod s vysokou dostupností, může docházet k příležitostnému přerušení, varování nebo chybovým zprávám.Because the connection isn't made to a highly available endpoint, you may experience occasional interruptions, warning, or error messages. Tyto zprávy mohou znamenat, že relace byla odpojena nebo došlo k chybě při komunikaci se službou EHK.These messages may indicate that the session was disconnected or that there was an error communicating with the ECE Service. Jde o očekávané chování.This behavior is expected. Operaci můžete opakovat za několik minut nebo vytvořit novou relaci privilegovaného koncového bodu na jednom z dalších virtuálních počítačů ERCS.You can retry the operation in a few minutes or create a new privileged endpoint session on one of the other ERCS VMs.

Další informace o řešení potíží s aktualizacemi najdete v tématu řešení potíží s Azure Stack .For more information on troubleshooting updates, see Azure Stack Troubleshooting

Další krokyNext steps