Azure Stack Hub-systeemstatus valideren

  • Artikel

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:

  1. 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.

  2. 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 $localcred

    Tip

    Voor toegang tot het PEP op een ASDK-hostcomputer (Azure Stack Development Kit), gebruikt u AzS-ERCS01 voor -ComputerName.

  3. Zodra u zich in het PEP bevindt, voert u het volgende uit:

    Test-AzureStack

    Zie Parameteroverwegingen en use-casevoorbeelden voor meer informatie.

  4. 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.

  5. 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, AzsInfraCapacity

    Test-AzureStack -Ignore AzsInfraPerformance

  • Een 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.

Zie Problemen met Microsoft Azure Stack Hub oplossen voor meer informatie over het oplossen van problemen.