Azure Stack Hub-systeemstatus valideren
Als Azure Stack Hub-operator is het essentieel om de status en status van uw systeem op aanvraag te kunnen bepalen. Het azure Stack Hub-validatieprogramma (Test-AzureStack)) is een PowerShell-cmdlet waarmee u een reeks tests op uw systeem kunt uitvoeren om fouten te identificeren, indien aanwezig. U wordt doorgaans gevraagd dit hulpprogramma uit te voeren via het bevoegde eindpunt (PEP) wanneer u contact opneemt met de klantenservice van Microsoft (Microsoft Ondersteuning) met een probleem. Met de systeembrede statusinformatie bij de hand kunt Microsoft Ondersteuning gedetailleerde logboeken verzamelen en analyseren, zich richten op het gebied waar de fout is opgetreden en samen met u samenwerken om het probleem op te lossen.
Het validatiehulpprogramma uitvoeren en toegang krijgen tot de resultaten
U kunt het PEP gebruiken om het validatieprogramma uit te voeren. Het kan even duren voordat het hulpprogramma is uitgevoerd. De duur van de tijd is afhankelijk van het aantal virtuele machines in uw systeem. Elke test retourneert een PASS/FAIL-status in het PowerShell-venster.
Hier volgt een overzicht van het end-to-end validatietestproces:
Stel de vertrouwensrelatie in. Voer op een geïntegreerd systeem de volgende opdracht uit vanuit een sessie met verhoogde Windows PowerShell om het PEP toe te voegen als een vertrouwde host op de beveiligde VM die wordt uitgevoerd op de hardwarelevenscyclushost of het Privileged Access Workstation.
winrm s winrm/config/client '@{TrustedHosts="<IP Address of Privileged Endpoint>"}'Als u de Azure Stack Development Kit (ASDK) uitvoert, meldt u zich aan bij de host van de development kit.
Open het PEP. Voer de volgende opdrachten uit om een PEP-sessie tot stand te brengen:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcredTip
Voor toegang tot het PEP op een ASDK-hostcomputer (Azure Stack Development Kit), gebruikt u AzS-ERCS01 voor -ComputerName.
Zodra u zich in het PEP bevindt, voert u het volgende uit:
Test-AzureStackZie Parameteroverwegingen en use-casevoorbeelden voor meer informatie.
Als een van de tests mislukt meldt, voert u uit
Get-AzureStackLog. Zie Get-AzureStackLog uitvoeren op geïntegreerde Azure Stack Hub-systemen voor instructies over een geïntegreerd systeem.De cmdlet verzamelt logboeken die zijn gegenereerd door Test-AzureStack. We raden u aan geen logboeken te verzamelen en in plaats daarvan contact op te Microsoft Ondersteuning als de tests WARN rapporteren.
Als de Microsoft Ondersteuning u opdracht krijgt om het validatieprogramma uit te voeren, vraagt de Microsoft Ondersteuning vertegenwoordiger de logboeken op die u hebt verzameld om door te gaan met het oplossen van het probleem.
Beschikbare tests
Met het validatieprogramma kunt u een reeks tests op systeemniveau en eenvoudige cloudscenario's uitvoeren die u inzicht geven in de huidige status, zodat u problemen in uw systeem kunt oplossen.
Tests voor cloudinfrastructuur
Deze lage impacttests werken op infrastructuurniveau en bieden u informatie over verschillende systeemonderdelen en -functies. Momenteel zijn tests gegroepeerd in de volgende categorieën:
| Testcategorie | Argument voor -Include en -Ignore |
|---|---|
| Overzicht van Azure Stack Hub ACS | AzsAcsSummary |
| Status van azure Stack Hub-actieplan | AzsActionPlanStatus |
| Status van Azure Stack Hub-agent | AzsAgentHealth |
| Azure Stack AKS Arc Preview-samenvatting | AzsAksArcPreviewSummary |
| Overzicht van Azure Stack Hub Active Directory | AzsAdSummary |
| Samenvatting van waarschuwingen voor Azure Stack Hub | AzsAlertSummary |
| Overzicht van vastlopen van Azure Stack Hub-toepassing | AzsApplicationCrashSummary |
| Overzicht van toegankelijkheid van Azure Stack Hub Backup Share | AzsBackupShareAccessibility |
| Overzicht van azure Stack Hub-besturingsvlak | AzsControlPlane |
| DCB-validatie van Azure Stack Hub | AzsDCBValidation |
| Samenvatting van Azure Stack Hub Defender | AzsDefenderSummary |
| Azure Stack Hub ECE-inrichtingsstatus | AzsEceProvisioningStatus |
| Samenvatting van externe certificaten van Azure Stack Hub | AzsExternalCertificates |
| Overzicht van GPU-configuratie van Azure Stack Hub | AzsGpuConfigurationSummary |
| Azure Stack Hub Hardware Monitor inschakelen | AzsGpuConfigurationSummary |
| Firmwaresamenvatting azure Stack Hub Hosting Infrastructure | AzsHostingInfraFWSummary |
| Overzicht van azure Stack Hub-hostinginfrastructuur | AzsHostingInfraSummary |
| Azure Stack Hub Hosting Infrastructure-gebruik | AzsHostingInfraUtilization |
| Connectiviteit van Azure Stack Hub-id-provider | AzsIdentityProviderConnectivity |
| Status van Azure Stack Hub-id-provider | AzsIdentityProviderStatus |
| Infrastructuurcapaciteit van Azure Stack Hub | AzsInfraCapacity |
| Bestandsvalidatie van Azure Stack Hub-infrastructuur | AzsInfraFileValidation |
| Prestaties van Azure Stack Hub-infrastructuur | AzsInfraPerformance |
| Samenvatting van azure Stack Hub-infrastructuurrol | AzsInfraRoleSummary |
| Updategeheugen voor Azure Stack Hub-infrastructuur | AzsInfraUpdateMemory |
| Overzicht van azure Stack Hub-infrastructuurupdates | AzsInfraUpdateSummary |
| Azure Stack Hub NCImos-validatie | AzsNCImosValidation |
| Netwerkinfrastructuur van Azure Stack Hub | AzsNetworkInfra |
| OEM-hardware voor Azure Stack Hub | AzsOemHardware |
| Oem-updatevereisten voor Azure Stack Hub | AzsOemUpdatePrereqs |
| Overzicht van Azure Stack Hub-portal en API | AzsPortalAPISummary |
| Operationele status van Azure Stack Hub RDMA | AzsRdmaOperationalStatus |
| Verificatiestatus van Azure Stack Hub-resourceprovider | AzsResourceProviderAuthStatus |
| Azure Stack Hub Scale Unit VM-gebeurtenissen | AzsScaleUnitEvents |
| Azure Stack Hub Scale Unit VM-resources | AzsScaleUnitResources |
| Azure Stack Hub-scenario's | AzsScenarios |
| Samenvatting van Azure Stack Hub Service Fabric-rol | AzsSFRoleSummary |
| Diagnostische gegevens van Azure Stack Hub SQL | AzsSQLDiagnostics |
| Azure Stack Hub SQL-samenvatting | AzsSQLSummary |
| Overzicht van BMC-zegel van Azure Stack Hub | AzsStampBMCSummary |
| Azure Stack Hub Storage-gegevensvlak | AzsStorageDataPlane |
| Samenvatting van Azure Stack Hub Storage Services | AzsStorageSvcsSummary |
| Overzicht van Azure Stack Hub SQL Store | AzsStoreSummary |
| Gebruiksoverzicht van Azure Stack Hub | AzsUsage |
| Overzicht van Azure Stack Hub-gebruiksbrug | AzsUsageBridgeSummary |
| Overzicht van vm-plaatsing in Azure Stack Hub | AzsVmPlacement |
Cloudscenariotests
Naast de infrastructuurtests in de vorige sectie kunt u ook cloudscenariotests uitvoeren om de functionaliteit van infrastructuuronderdelen te controleren. Cloudbeheerdersreferenties zijn vereist om deze tests uit te voeren, omdat ze betrekking hebben op resource-implementatie.
Notitie
Momenteel kunt u geen cloudscenariotests uitvoeren met ad FS-referenties (Active Directory Federated Services).
De volgende cloudscenario's worden getest door het validatieprogramma:
- Resourcegroep maken
- Plannen maken
- Aanbieding maken
- Maken van een opslagaccount
- Virtuele machine maken (VM)
- Blob Storage-bewerking
- Queue Storage-bewerking
- Tabelopslagbewerking
Overwegingen voor parameters
De parameterlijst kan worden gebruikt om alle beschikbare testcategorieën weer te geven.
De parameters Opnemen en Negeren kunnen worden gebruikt om testcategorieën op te nemen of uit te sluiten. Zie de volgende sectie voor meer informatie over deze argumenten.
Test-AzureStack -Include AzsSFRoleSummary, AzsInfraCapacityTest-AzureStack -Ignore AzsInfraPerformanceEen tenant-VM wordt geïmplementeerd als onderdeel van de cloudscenariotests. U kunt DoNotDeployTenantVm gebruiken om deze VM-implementatie uit te schakelen.
U moet de parameter ServiceAdminCredential opgeven om cloudscenariotests uit te voeren, zoals beschreven in de sectie Use-casevoorbeelden .
BackupSharePath en BackupShareCredential worden gebruikt bij het testen van back-upinstellingen van de infrastructuur, zoals wordt weergegeven in de sectie Use case-voorbeelden .
DetailedResults kan worden gebruikt om informatie over slagen/mislukken/waarschuwingen op te halen voor elke test, evenals voor de algehele uitvoering. Als deze niet is opgegeven, retourneert Test-AzureStack$true als er geen fouten zijn en $false als er fouten zijn.
TimeoutSeconds kan worden gebruikt om een specifiek tijdstip in te stellen voor elke groep die moet worden voltooid.
Het validatieprogramma ondersteunt ook algemene PowerShell-parameters: Uitgebreid, Foutopsporing, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable en OutVariable. Zie Over algemene parameters voor meer informatie.
Voorbeelden van gebruiksvoorbeelden
Validatie uitvoeren zonder cloudscenario's
Voer het validatieprogramma uit zonder de parameter ServiceAdminCredential om het uitvoeren van cloudscenariotests over te slaan:
New-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
Test-AzureStack
Validatie uitvoeren met cloudscenario's
Als u het validatieprogramma met de parameter ServiceAdminCredentials levert, worden standaard de cloudscenariotests uitgevoerd:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>"
Als u ALLEEN cloudscenario's wilt uitvoeren zonder de rest van de tests uit te voeren, kunt u de parameter Include gebruiken om dit te doen:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>" -Include AzsScenarios
De gebruikersnaam van de cloudbeheerder moet worden getypt in de UPN-indeling ( serviceadmin@contoso.onmicrosoft.com Microsoft Entra ID). Wanneer u hierom wordt gevraagd, typt u het wachtwoord voor het cloudbeheerdersaccount.
Groepen
Om de operatorervaring te verbeteren, is een groepsparameter ingeschakeld om meerdere testcategorieën tegelijk uit te voeren. Er zijn momenteel drie groepen gedefinieerd: Standaard, UpdateReadiness en SecretRotationReadiness.
Standaardinstelling: wordt beschouwd als een standaarduitvoering van Test-AzureStack. Deze groep wordt standaard uitgevoerd als er geen andere groepen zijn geselecteerd.
UpdateReadiness: een controle om te zien of het Azure Stack Hub-exemplaar kan worden bijgewerkt. Wanneer de updateReadiness-groep wordt uitgevoerd, worden waarschuwingen weergegeven als fouten in de console-uitvoer en moeten ze worden beschouwd als blokkeringen voor de update. De volgende categorieën maken deel uit van de groep UpdateReadiness :
- AzsInfraFileValidation
- AzsActionPlanStatus
- AzsStampBMCSummary
SecretRotationReadiness: een controle om te zien of het Azure Stack Hub-exemplaar zich in een status bevindt waarin geheimrotatie kan worden uitgevoerd. Wanneer de groep SecretRotationReadiness wordt uitgevoerd, worden waarschuwingen weergegeven als fouten in de console-uitvoer en moeten ze worden beschouwd als blokkeringen voor het draaien van geheimen. De volgende categorieën maken deel uit van de Groep SecretRotationReadiness:
- AzsAcsSummary
- AzsDefenderSummary
- AzsHostingInfraSummary
- AzsInfraCapacity
- AzsInfraRoleSummary
- AzsPortalAPISummary
- AzsSFRoleSummary
- AzsStorageSvcsSummary
- AzsStoreSummary
Voorbeeld van groepsparameter
In het volgende voorbeeld wordt Test-AzureStack uitgevoerd om de gereedheid van het systeem te testen voordat u een update of hotfix installeert met behulp van Group. Voordat u de installatie van een update of hotfix start, voert u Test-AzureStack uit om de status van uw Azure Stack Hub te controleren:
Test-AzureStack -Group UpdateReadiness
Validatieprogramma uitvoeren om back-upinstellingen voor infrastructuur te testen
Voordat u back-up van de infrastructuur configureert, kunt u het pad en de referenties voor de back-upshare testen met behulp van de AzsBackupShareAccessibility-test :
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility -BackupSharePath "\\<fileserver>\<fileshare>" -BackupShareCredential $using:backupcred
Nadat u de back-up hebt geconfigureerd, kunt u AzsBackupShareAccessibility uitvoeren om te controleren of de share toegankelijk is vanuit de ERCS:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility
Als u nieuwe referenties wilt testen met de geconfigureerde back-upshare, voert u het volgende uit:
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility -BackupShareCredential "<PSCredential for backup share>"
Validatieprogramma uitvoeren om de netwerkinfrastructuur te testen
Deze test controleert de connectiviteit van de netwerkinfrastructuur waarbij het Software Defined Network (SDN) van Azure Stack Hub wordt omzeild. Het demonstreert de connectiviteit van een openbaar VIP naar de geconfigureerde DNS-doorstuurservers, NTP-servers en verificatie-eindpunten. Dit omvat connectiviteit met Azure bij het gebruik van Microsoft Entra ID als id-provider of de federatieve server bij gebruik van AD FS als id-provider.
Neem de foutopsporingsparameter op om een gedetailleerde uitvoer van de opdracht op te halen:
Test-AzureStack -Include AzsNetworkInfra -Debug
Volgende stappen
Zie Diagnostische logboekverzameling van Azure Stack Hub voor meer informatie over diagnostische hulpprogramma's van Azure Stack Hub en logboekregistratie van problemen.