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

Artikel
06/19/2024

U kunt het bevoegde eindpunt gebruiken om de voortgang van een Azure Stack Hub-updateuitvoering te bewaken. U kunt ook het bevoegde eindpunt gebruiken om een mislukte update-uitvoering van de laatste geslaagde stap te hervatten als de Azure Stack Hub-portal niet meer 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 huidige, voltooide of mislukte update. Biedt de status op hoog niveau van de updatebewerking en een XML-document waarin zowel de huidige stap als de bijbehorende status worden beschreven.
`Resume-AzureStackUpdate`	Hiermee wordt een mislukte update hervat op het punt waarop deze is mislukt. In bepaalde scenario's moet u mogelijk de risicobeperkingsstappen voltooien voordat u de update hervat.

Controleer of de cmdlets beschikbaar zijn

Omdat de cmdlets nieuw zijn in het 1710-updatepakket voor Azure Stack Hub, moet het 1710-updateproces een bepaald punt bereiken voordat de bewakingsfunctie beschikbaar is. De cmdlets zijn doorgaans beschikbaar als de status in de beheerdersportal aangeeft dat de 1710-update zich in de stap Opslaghosts opnieuw opstarten bevindt. 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 opdrachtenlijst van het bevoegde eindpunt. Als u deze query wilt uitvoeren, voert u 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. Zie stap 1 van Access the privileged endpoint (Het bevoegde eindpunt openen) voor meer informatie.

Maak een PowerShell-sessie op een van de virtuele ERCS-machines (VM's) in uw Azure Stack Hub-omgeving (Prefix-ERCS01, Prefix-ERCS02 of Prefix-ERCS03). Vervang voorvoegsel door de vm-voorvoegseltekenreeks die 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 groep CloudAdmins. Voer voor het CloudAdmin-account hetzelfde wachtwoord in dat is opgegeven tijdens de installatie voor het AzureStackAdmin-domeinbeheerdersaccount.
Haal de volledige lijst met opdrachten op die beschikbaar zijn in het bevoegde eindpunt.
```
$commands = Invoke-Command -Session $pepSession -ScriptBlock { Get-Command } 
```

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."
 }

Vermeld de opdrachten 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. Zie stap 1 van Access the privileged endpoint (Het bevoegde eindpunt openen) voor meer informatie.

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 (Prefix-ERCS01, Prefix-ERCS02 of Prefix-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 groep CloudAdmins. Voer voor het CloudAdmin-account hetzelfde wachtwoord in dat is opgegeven tijdens de installatie voor het AzureStackAdmin-domeinbeheerdersaccount.

De status op hoog niveau van de huidige update-uitvoering ophalen

Voer de volgende opdrachten uit om de status op hoog niveau van de huidige update-uitvoering op te halen:

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

$statusString.Value

Mogelijke waarden zijn:

Wordt uitgevoerd
Voltooid
Mislukt
Geannuleerd

U kunt deze opdrachten herhaaldelijk uitvoeren om de meest recente status te zien. U hoeft geen verbinding opnieuw tot stand te brengen om opnieuw te controleren.

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 converteren naar een XML-document en PowerShell gebruiken om de tekenreeks 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 abonnement om de opslaghosts bij te werken en opnieuw op te starten. Hier ziet u dat de Blob Storage Storage-service op een van de hosts wordt bijgewerkt met het plan Voor opnieuw opstarten van opslaghosts.

[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 update-uitvoering hervatten waar deze is 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 af en toe onderbrekingen, waarschuwingen of foutberichten optreden. Deze berichten kunnen erop wijzen dat de sessie is verbroken of dat er een fout is opgetreden bij het communiceren met de ECE-service. Dit gedrag is verwacht. U kunt de bewerking over een paar minuten opnieuw proberen of een nieuwe bevoegde eindpuntsessie maken op een van de andere VM's van ERCS.

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

Volgende stappen

Updates beheren in Azure Stack Hub

Delen via