Updates bewaken in Azure Stack Hub met behulp van het eindpunt met bevoegde toegang
U kunt het bevoegde eindpunt gebruiken om de voortgang van een Azure Stack Hub update uit te voeren. U kunt het bevoegde eindpunt ook gebruiken om een mislukte update-run te hervatten vanaf de laatste geslaagde stap als de Azure Stack Hub portal niet meer beschikbaar is. Het gebruik van 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 Azure Stack Hub geïntegreerde systemen.
| Cmdlet | Beschrijving |
|---|---|
Get-AzureStackUpdateStatus |
Retourneert de status van de update die momenteel wordt uitgevoerd, voltooid of mislukt. 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 |
Hervat een mislukte update op het punt waar deze is mislukt. In bepaalde scenario's moet u mogelijk de oplossingsstappen 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 updateproces 1710 naar een bepaald punt gaan voordat de bewakingsfunctie beschikbaar is. Normaal gesproken zijn de cmdlets beschikbaar als de status in de beheerdersportal aangeeft dat de 1710-update zich in de stap Storage Hosts opnieuw opstarten. De cmdlet-update vindt met name plaats tijdens Stap: stap 2.6 - Allowlist bijwerken privilegedEndpoint uitvoeren.
U kunt ook bepalen of de cmdlets programmatisch beschikbaar zijn door een query uit te voeren op de opdrachtlijst van het bevoegde eindpunt. Voer de volgende opdrachten uit vanaf de hardwarelevenscyclushost of vanaf een Privileged Access Workstation om deze query uit te voeren. Zorg er ook voor dat het bevoegde eindpunt een vertrouwde host is. Zie stap 1 van Toegang tot het bevoegde eindpunt 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 tekenreeks voor het VM-voorvoegsel 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 <>\cloudadmin of een account dat lid is van de groep CloudAdmins. Voer voor het CloudAdmin-account hetzelfde wachtwoord in dat is opgegeven tijdens de installatie van 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 $updateManagementModuleNameBijvoorbeeld:
$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 Toegang tot het bevoegde eindpunt voor meer informatie.
Verbinding maken 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 <>\cloudadmin of een account dat lid is van de groep CloudAdmins. Voer voor het CloudAdmin-account hetzelfde wachtwoord in dat is opgegeven tijdens de installatie van het azureStackAdmin-domeinbeheerdersaccount.
De status van de huidige update-run op hoog niveau krijgen
Voer de volgende opdrachten uit om een status op hoog niveau van de huidige update-run 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 het opnieuw te controleren.
De volledige status van de update uitvoeren met details
U kunt het volledige overzicht van de update-run als xml-tekenreeks krijgen. U kunt de tekenreeks voor onderzoek naar een bestand schrijven of converteren naar een XML-document en PowerShell gebruiken om het te parseren. Met de volgende opdracht wordt de XML geparseert om een hiërarchische lijst op te halen van de stappen die momenteel worden uitgevoerd:
[xml]$updateStatus = Invoke-Command -Session $pepSession -ScriptBlock { Get-AzureStackUpdateStatus }
$updateStatus.SelectNodes("//Step[@Status='InProgress']")
In het volgende voorbeeld bevat de stap op het hoogste niveau (CloudUpdate) een onderliggend plan om de opslaghosts bij te werken en opnieuw op te starten. U ziet dat het plan Restart Storage Hosts de Blob Storage-service op een van de hosts bij te werken.
[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-run 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 tot stand is gekomen met een eindpunt met hoge beschikbaarheid, kunnen er incidentele onderbrekingen, waarschuwings- of foutberichten voorkomen. Deze berichten kunnen erop wijzen dat de verbinding van 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 binnen een paar minuten opnieuw uitvoeren of een nieuwe bevoegde eindpuntsessie maken op een van de andere ERCS-VM's.
Zie Problemen met Azure Stack oplossen voor meer informatie over het oplossen van problemen met updates