Frissítések monitorozása az Azure Stack Hubban a kiemelt végpont használatávalMonitor updates in Azure Stack Hub using the privileged endpoint

Az emelt szintű végpont használatával figyelheti az Azure stack hub frissítési futtatásának állapotát.You can use the privileged endpoint to monitor the progress of an Azure Stack Hub update run. A rendszerjogosultságú végpontot is használhatja a sikertelen frissítés futtatásának folytatásához az utolsó sikeres lépés után, ha az Azure Stack hub-portál elérhetetlenné válik.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. Az Azure Stack hub portál használata ajánlott módszer a frissítések Azure Stack hub-ban való kezeléséhez.Using the Azure Stack Hub portal is the recommended method to manage updates in Azure Stack Hub.

A következő új PowerShell-parancsmagok szerepelnek az Update Managementhez Azure Stack hub integrált rendszerek 1710-es frissítésében.The following new PowerShell cmdlets for update management are included in the 1710 update for Azure Stack Hub integrated systems.

ParancsmagCmdlet LeírásDescription
Get-AzureStackUpdateStatus A jelenleg futó, befejezett vagy sikertelen frissítés állapotát adja vissza.Returns the status of the currently running, completed, or failed update. A frissítési művelet magas szintű állapotát és egy olyan XML-dokumentumot biztosít, amely az aktuális lépést és a megfelelő állapotot is leírja.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 Egy sikertelen frissítés folytatása azon a ponton, ahol a művelet sikertelen volt.Resumes a failed update at the point where it failed. Bizonyos esetekben előfordulhat, hogy a frissítés folytatása előtt el kell végeznie a kockázatcsökkentő lépéseket.In certain scenarios, you may have to complete mitigation steps before you resume the update.

Ellenőrizze, hogy elérhetők-e a parancsmagokVerify the cmdlets are available

Mivel a parancsmagok a Azure Stack hub 1710-es frissítési csomagjához tartoznak, a 1710 frissítési folyamatnak egy bizonyos pontra kell jutnia ahhoz, hogy elérhető legyen a figyelési funkció.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. A parancsmagok jellemzően akkor érhetők el, ha a felügyeleti portálon lévő állapot azt jelzi, hogy az 1710-es frissítés a Storage-gazdagépek újraindítása lépéssel történik.Typically, the cmdlets are available if the status in the administrator portal indicates that the 1710 update is at the Restart Storage Hosts step. A parancsmag frissítése a lépés végrehajtása során következik be : a 2,6-es lépés – a PrivilegedEndpoint engedélyezési listájának frissítése.Specifically, the cmdlet update occurs during Step: Running step 2.6 - Update PrivilegedEndpoint whitelist.

Azt is meghatározhatja, hogy a parancsmagok programozott módon elérhetők-e a parancsok a Kiemelt végpontról történő lekérdezésével.You can also determine whether the cmdlets are available programmatically by querying the command list from the privileged endpoint. A lekérdezés végrehajtásához futtassa a következő parancsokat a hardver életciklus-gazdagépén vagy egy emelt szintű hozzáférési munkaállomáson.To do this query, run the following commands from the hardware lifecycle host or from a Privileged Access Workstation. Győződjön meg arról is, hogy a Kiemelt végpont megbízható gazdagép.Also, make sure the privileged endpoint is a trusted host. További információ: a privilegizált végpont elérésének1. lépése.For more information, see step 1 of Access the privileged endpoint.

  1. Hozzon létre egy PowerShell-munkamenetet az Azure Stack hub-környezetben található bármelyik ERCS virtuális gépen (előtag: ERCS01, prefix-ERCS02 vagy előtag-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). Cserélje le az előtagot a környezetre jellemző virtuálisgép-előtagi karakterlánccal.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 
    

    Amikor a rendszer kéri a hitelesítő adatokat, használja az < Azure stack hub tartományi > \cloudadmin-fiókot vagy egy olyan fiókot, amely tagja a CloudAdmins csoportnak.When prompted for credentials, use the <Azure Stack Hub domain>\cloudadmin account, or an account that's a member of the CloudAdmins group. A CloudAdmin fiók esetében adja meg ugyanazt a jelszót, amelyet a Azurestack tartományi rendszergazdai fiók telepítésekor adott meg.For the CloudAdmin account, enter the same password that was provided during installation for the AzureStackAdmin domain administrator account.

  2. A privilegizált végponton elérhető parancsok teljes listájának beolvasása.Get the full list of commands that are available in the privileged endpoint.

    $commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command } 
    
  3. Annak megállapítása, hogy a Kiemelt végpont frissítve lett-e.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. A Microsoft. AzureStack. UpdateManagement modulhoz tartozó parancsok listázása.List the commands specific to the Microsoft.AzureStack.UpdateManagement module.

    $commands | ? Source -eq $updateManagementModuleName 
    

    Például: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
    

Az Update Management-parancsmagok használataUse the update management cmdlets

Megjegyzés

Futtassa az alábbi parancsokat a hardver életciklus-gazdagépről vagy egy emelt szintű hozzáférési munkaállomásról.Run the following commands from the hardware lifecycle host or from a Privileged Access Workstation. Győződjön meg arról is, hogy a Kiemelt végpont megbízható gazdagép.Also, make sure the privileged endpoint is a trusted host. További információ: a privilegizált végpont elérésének1. lépése.For more information, see step 1 of Access the privileged endpoint.

Kapcsolódás a privilegizált végponthoz és a munkamenet-változó társításaConnect to the privileged endpoint and assign session variable

A következő parancsok futtatásával hozzon létre egy PowerShell-munkamenetet a Azure Stack hub-környezetben található egyik ERCS virtuális gépen (előtag: ERCS01, előtag-ERCS02 vagy előtag-ERCS03), és rendeljen hozzá egy munkamenet-változót.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 

Amikor a rendszer kéri a hitelesítő adatokat, használja az < Azure stack hub tartományi > \cloudadmin-fiókot vagy egy olyan fiókot, amely tagja a CloudAdmins csoportnak.When prompted for credentials, use the <Azure Stack Hub domain>\cloudadmin account, or an account that's a member of the CloudAdmins group. A CloudAdmin fiók esetében adja meg ugyanazt a jelszót, amelyet a Azurestack tartományi rendszergazdai fiók telepítésekor adott meg.For the CloudAdmin account, enter the same password that was provided during installation for the AzureStackAdmin domain administrator account.

Az aktuális frissítési Futtatás magas szintű állapotának beolvasásaGet high-level status of the current update run

Az aktuális frissítési kísérlet magas szintű állapotának lekéréséhez futtassa a következő parancsokat: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 

A lehetséges értékek a következők:Possible values include:

  • FutóRunning
  • BefejezveCompleted
  • SikertelenFailed
  • MegszakítvaCanceled

Ezeket a parancsokat többször is futtathatja a legfrissebb állapot megjelenítéséhez.You can run these commands repeatedly to see the most up-to-date status. Nem kell újból létrehoznia egy kapcsolatot az ismételt vizsgálathoz.You don't have to re-establish a connection to check again.

A teljes frissítés futtatási állapotának beolvasása részletekkelGet the full update run status with details

A teljes frissítés futtatásának összegzése XML-karakterláncként szerezhető be.You can get the full update run summary as an XML string. Megírhatja a karakterláncot egy fájlba a vizsgálathoz, vagy átalakíthatja egy XML-dokumentumba, és a PowerShell használatával elemezheti azt.You can write the string to a file for examination, or convert it to an XML document and use PowerShell to parse it. A következő parancs elemzi az XML-t, hogy beolvassa a jelenleg futó lépések hierarchikus listáját: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']")

A következő példában a legfelső szintű lépés (a felhő frissítése) egy gyermek tervet tartalmaz a tároló-gazdagépek frissítéséhez és újraindításához.In the following example, the top-level step (Cloud Update) has a child plan to update and restart the storage hosts. Azt mutatja, hogy az újraindítási tárolók terve frissíti a Blob Storage szolgáltatást az egyik gazdagépen.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

Sikertelen frissítési művelet folytatásaResume a failed update operation

Ha a frissítés sikertelen, akkor folytathatja a frissítés futtatását, ahol a szolgáltatás abbahagyta.If the update fails, you can resume the update run where it left off.

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

HibaelhárításTroubleshoot

A Kiemelt végpont az Azure Stack hub-környezetben található összes ERCS virtuális gépen elérhető.The privileged endpoint is available on all ERCS VMs in the Azure Stack Hub environment. Mivel a kapcsolódás nem egy magasan elérhető végpontra történik, időnként megszakítások, figyelmeztetés vagy hibaüzenetek merülhetnek fel.Because the connection isn't made to a highly available endpoint, you may experience occasional interruptions, warning, or error messages. Ezek az üzenetek azt jelezhetik, hogy a munkamenet le lett választva, vagy hiba történt az ECE szolgáltatással való kommunikáció során.These messages may indicate that the session was disconnected or that there was an error communicating with the ECE Service. Ez várt működés.This behavior is expected. Próbálja megismételni a műveletet néhány perc múlva, vagy hozzon létre egy új emelt szintű végponti munkamenetet az egyik másik ERCS virtuális gépen.You can retry the operation in a few minutes or create a new privileged endpoint session on one of the other ERCS VMs.

További információ a frissítések hibaelhárításáról: Azure stack hibaelhárításFor more information on troubleshooting updates, see Azure Stack Troubleshooting

További lépésekNext steps