Delen via


Updates bewaken in Azure Stack Hub met behulp van het bevoegde eindpunt

U kunt het bevoegde eindpunt gebruiken om de voortgang van een Azure Stack Hub-updateuitvoering te controleren. U kunt ook het bevoegde eindpunt gebruiken om een mislukte updateuitvoering uit de laatste geslaagde stap te hervatten als de Azure Stack Hub-portal niet beschikbaar is. Het gebruik van de Azure Stack Hub-portal is de aanbevolen methode voor het beheren van updates in Azure Stack Hub.

De volgende nieuwe PowerShell-cmdlets voor updatebeheer zijn opgenomen in de 1710-update voor geïntegreerde Azure Stack Hub-systemen.

Cmdlet Beschrijving
Get-AzureStackUpdateStatus Retourneert de status van de momenteel uitgevoerde, voltooide of mislukte update. Biedt de status op hoog niveau van de updatebewerking en een XML-document dat zowel de huidige stap als de bijbehorende status beschrijft.
Resume-AzureStackUpdate Hiermee wordt een mislukte update hervat op het punt waar deze is mislukt. In bepaalde scenario's moet u mogelijk de beperkingsstappen voltooien voordat u de update hervat.

Controleer of de cmdlets beschikbaar zijn

Omdat de cmdlets nieuw zijn in het updatepakket 1710 voor Azure Stack Hub, moet het updateproces van 1710 een bepaald punt bereiken voordat de bewakingsmogelijkheid beschikbaar is. De cmdlets zijn doorgaans beschikbaar als de status in de beheerdersportaal aangeeft dat de update 1710 zich bij de stap Opslaghosts opnieuw opstarten bevindt. Met name de cmdlet-update vindt plaats tijdens stap: stap 2.6 - PrivilegedEndpoint allowlist bijwerken.

U kunt ook bepalen of de cmdlets programmatisch beschikbaar zijn door een query uit te voeren op de opdrachtlijst vanaf het bevoegde eindpunt. Voer de volgende opdrachten uit vanaf de host van de hardwarelevenscyclus of vanaf een Privileged Access Workstation om deze query uit te voeren. Zorg er ook voor dat het bevoegde eindpunt een vertrouwde host is. Voor meer informatie, zie stap 1 van Toegang tot het geprivilegieerde eindpunt.

  1. Maak een PowerShell-sessie op een van de virtuele ERCS-machines (VM's) in uw Azure Stack Hub-omgeving (voorvoegsel-ERCS01, voorvoegsel-ERCS02 of voorvoegsel-ERCS03). Vervang het voorvoegsel door de tekenreeks voor het VM-voorvoegsel dat specifiek is voor uw omgeving.

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

    Wanneer u om referenties wordt gevraagd, gebruikt u het <Azure Stack Hub-domein>\cloudadmin-account of een account dat lid is van de CloudAdmins-groep. Voer voor het CloudAdmin-account hetzelfde wachtwoord in dat is opgegeven tijdens de installatie voor het Beheerdersaccount van het AzureStackAdmin-domein.

  2. Haal de volledige lijst met opdrachten op die beschikbaar zijn in het bevoegde eindpunt.

    $commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command } 
    
  3. Bepaal of het bevoegde eindpunt is bijgewerkt.

    $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. Geef de opdrachten weer die specifiek zijn voor de module Microsoft.AzureStack.UpdateManagement.

    $commands | ? Source -eq $updateManagementModuleName 
    

    Bijvoorbeeld:

    $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
    

De cmdlets voor updatebeheer gebruiken

Notitie

Voer de volgende opdrachten uit vanaf de host van de hardwarelevenscyclus of vanaf een Privileged Access Workstation. Zorg er ook voor dat het bevoegde eindpunt een vertrouwde host is. Voor meer informatie, zie stap 1 van Toegang tot het bevoorrechte eindpunt.

Verbinding maken met het bevoegde eindpunt en sessievariabele toewijzen

Voer de volgende opdrachten uit om een PowerShell-sessie te maken op een van de ERCS-VM's in uw Azure Stack Hub-omgeving (voorvoegsel-ERCS01, voorvoegsel-ERCS02 of voorvoegsel-ERCS03) en om een sessievariabele toe te wijzen.

$cred = Get-Credential

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

Wanneer u om referenties wordt gevraagd, gebruikt u het <Azure Stack Hub-domein>\cloudadmin-account of een account dat lid is van de CloudAdmins-groep. Voer voor het CloudAdmin-account hetzelfde wachtwoord in dat is opgegeven tijdens de installatie voor het Beheerdersaccount van het AzureStackAdmin-domein.

Status op hoog niveau van de huidige updateuitvoering ophalen

Voer de volgende opdrachten uit om een status op hoog niveau van de huidige updateuitvoering op te halen:

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

$statusString.Value 

Mogelijke waarden zijn:

  • Hardlopen
  • Volbracht
  • Mislukt
  • Geannuleerd

U kunt deze opdrachten herhaaldelijk uitvoeren om de meest up-to-datumstatus te zien. U hoeft geen verbinding opnieuw tot stand te brengen om de controle opnieuw uit te voeren.

De volledige uitvoeringsstatus van de update ophalen met details

U kunt de volledige samenvatting van de updateuitvoering ophalen als een XML-tekenreeks. U kunt de tekenreeks naar een bestand schrijven voor onderzoek of deze converteren naar een XML-document en PowerShell gebruiken om deze te parseren. Met de volgende opdracht wordt de XML geparseerd om een hiërarchische lijst op te halen met de stappen die momenteel worden uitgevoerd:

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

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

In het volgende voorbeeld heeft de stap op het hoogste niveau (Cloud Update) een onderliggend plan om de opslaghosts bij te werken en opnieuw op te starten. Het toont aan dat het plan voor het opnieuw opstarten van opslaghosts de Blob Storage-service op een van de hosts bijwerkt.

[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

Een mislukte updatebewerking hervatten

Als de update mislukt, kunt u de updateuitvoering hervatten waar deze was gebleven.

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

Problemen oplossen

Het bevoegde eindpunt is beschikbaar op alle ERCS-VM's in de Azure Stack Hub-omgeving. Omdat de verbinding niet is gemaakt met een maximaal beschikbaar eindpunt, kunnen er incidentele onderbrekingen, waarschuwingen of foutberichten optreden. Deze berichten kunnen erop wijzen dat de sessie is verbroken of dat er een fout is opgetreden bij de communicatie met de ECE-service. Dit gedrag wordt verwacht. U kunt de bewerking over een paar minuten opnieuw uitvoeren of een nieuwe sessie met bevoegde eindpunten maken op een van de andere ERCS-VM's.

Zie voor meer informatie over het oplossen van problemen met updates Azure Stack

Volgende stappen