Azure Stack hub-systeem status validerenValidate Azure Stack Hub system state

Als Azure Stack hub-operator is het mogelijk om de status en status van uw systeem op aanvraag te bepalen.As an Azure Stack Hub operator, being able to determine the health and status of your system on demand is essential. Het Azure Stack hub Validation Tool (test-AzureStack) is een Power shell-cmdlet waarmee u een reeks tests op uw systeem kunt uitvoeren om fouten te identificeren, indien aanwezig.The Azure Stack Hub validation tool (Test-AzureStack) is a PowerShell cmdlet that lets you run a series of tests on your system to identify failures if present. Normaal gesp roken wordt u gevraagd dit hulp programma uit te voeren via het privileged end point (PEP) wanneer u contact opneemt met de ondersteuning voor micro soft Customer Services (Microsoft ondersteuning) met een probleem.You'll typically be asked to run this tool through the privileged end point (PEP) when you contact Microsoft Customer Services Support (Microsoft Support) with an issue. Microsoft Ondersteuning de status van het hele systeem en de status van de hand hebben, kunt u gedetailleerde logboeken verzamelen en analyseren, zich richten op het gebied waar de fout is opgetreden en met u samen werken om het probleem op te lossen.With the system-wide health and status information at hand, Microsoft Support can collect and analyze detailed logs, focus on the area where the error occurred, and work with you to fix the issue.

Het validatiehulpprogramma uitvoeren en toegang krijgen tot de resultatenRunning the validation tool and accessing results

Zoals hierboven vermeld, wordt het validatie hulpprogramma uitgevoerd via de PEP.As stated above, the validation tool is run via the PEP. Elke test retourneert de status pass/fail in het Power shell-venster.Each test returns a PASS/FAIL status in the PowerShell window. Hier volgt een overzicht van het proces van end-to-end validatie tests:Here's an outline of the end-to-end validation testing process:

  1. Stel de vertrouwens relatie in.Establish the trust. Op een geïntegreerd systeem voert u de volgende opdracht uit vanaf een Windows Power shell-sessie met verhoogde bevoegdheid om de PEP toe te voegen als een vertrouwde host op de beveiligde virtuele machine die wordt uitgevoerd op de hardware Lifecycle host of het werk station met privileged Access.On an integrated system, run the following command from an elevated Windows PowerShell session to add the PEP as a trusted host on the hardened VM running on the hardware lifecycle host or the 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 Development Kit-host.If you're running the Azure Stack Development Kit (ASDK), sign in to the development kit host.

  2. Toegang tot de PEP.Access the PEP. Voer de volgende opdrachten uit om een PEP-sessie tot stand te brengen:Run the following commands to establish a PEP session:

    Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
    

    Tip

    Om toegang te krijgen tot de PEP op een ASDK-hostcomputer (Azure Stack Development Kit), gebruikt u AzS-ERCS01 voor-ComputerName.To access the PEP on an Azure Stack Development Kit (ASDK) host computer, use AzS-ERCS01 for -ComputerName.

  3. Zodra u zich in de PEP bevindt, voert u de volgende handelingen uit:Once you're in the PEP, run:

    Test-AzureStack
    

    Zie parameter overwegingen en use-case-voor beelden voor meer informatie.For more information, see Parameter considerations and Use case examples.

  4. Als een test rapport mislukt, voert u uit Get-AzureStackLog .If any tests report FAIL, run Get-AzureStackLog. Zie Get-AzureStackLog uitvoeren op Azure stack hub-geïntegreerde systemenvoor instructies over een geïntegreerd systeem.For instructions on an integrated system, see how to run Get-AzureStackLog on Azure Stack Hub integrated systems.

    Met de cmdlet worden logboeken verzameld die zijn gegenereerd door test-AzureStack.The cmdlet gathers logs generated by Test-AzureStack. U wordt aangeraden geen logboeken te verzamelen en in plaats daarvan contact op te nemen met Microsoft Ondersteuning als tests worden gemeld.We recommend you don't collect logs and contact Microsoft Support instead if tests report WARN.

  5. Als u wordt gevraagd het validatie programma uit te voeren door de Microsoft Ondersteuning, verzoekt de Microsoft Ondersteuning vertegenwoordiger de logboeken die u hebt verzameld om door te gaan met het oplossen van uw probleem.If you're instructed to run the validation tool by the Microsoft Support, the Microsoft Support representative will request the logs you collected to continue troubleshooting your issue.

Beschikbare testsTests available

Met het validatie programma kunt u een reeks tests op systeem niveau en basis Cloud scenario's uitvoeren die inzicht bieden in de huidige status, zodat u problemen in uw systeem kunt oplossen.The validation tool lets you run a series of system-level tests and basic cloud scenarios that provide you with insight to the current state, allowing you to fix issues in your system.

Cloud infrastructuur testenCloud infrastructure tests

Deze tests met weinig effect werken op een infrastructuur niveau en bieden u informatie over verschillende systeem onderdelen en-functies.These low impact tests work on an infrastructure level and provide you with information on various system components and functions. Momenteel worden tests gegroepeerd in de volgende categorieën:Currently, tests are grouped into the following categories:

Categorie testenTest Category Argument voor-include en-IgnoreArgument for -Include and -Ignore
Azure Stack hub ACS-samen vattingAzure Stack Hub ACS Summary AzsAcsSummaryAzsAcsSummary
Samen vatting van Azure Stack hub-Active DirectoryAzure Stack Hub Active Directory Summary AzsAdSummaryAzsAdSummary
Samen vatting van Azure Stack hub-waarschuwingAzure Stack Hub Alert Summary AzsAlertSummaryAzsAlertSummary
Overzicht van vastlopen van Azure Stack hub-toepassingAzure Stack Hub Application Crash Summary AzsApplicationCrashSummaryAzsApplicationCrashSummary
Toegankelijkheids overzicht van de Azure Stack hub-back-upshareAzure Stack Hub Backup Share Accessibility Summary AzsBackupShareAccessibilityAzsBackupShareAccessibility
BMC-samen vatting van Azure Stack hubAzure Stack Hub BMC Summary AzsStampBMCSummaryAzsStampBMCSummary
Samen vatting van de infra structuur voor Cloud Hosting van Azure Stack hubAzure Stack Hub Cloud Hosting Infrastructure Summary AzsHostingInfraSummaryAzsHostingInfraSummary
Infrastructuur gebruik Azure Stack hub-Cloud HostingAzure Stack Hub Cloud Hosting Infrastructure Utilization AzsHostingInfraUtilizationAzsHostingInfraUtilization
Samen vatting van besturings vlak voor Azure Stack hubAzure Stack Hub Control Plane Summary AzsControlPlaneAzsControlPlane
Azure Stack hub Defender-samen vattingAzure Stack Hub Defender Summary AzsDefenderSummaryAzsDefenderSummary
Samen vatting van firmware voor Azure Stack hub-hosting infrastructuurAzure Stack Hub Hosting Infrastructure Firmware Summary AzsHostingInfraFWSummaryAzsHostingInfraFWSummary
Capaciteit van de hub-infrastructuur Azure StackAzure Stack Hub Infrastructure Capacity AzsInfraCapacityAzsInfraCapacity
Prestaties van hub-infra structuur Azure StackAzure Stack Hub Infrastructure Performance AzsInfraPerformanceAzsInfraPerformance
Samen vatting van Azure Stack hub-infrastructuur functieAzure Stack Hub Infrastructure Role Summary AzsInfraRoleSummaryAzsInfraRoleSummary
Azure Stack hub-netwerk infraAzure Stack Hub Network Infra AzsNetworkInfraAzsNetworkInfra
Azure Stack hub-Portal en API-samen vattingAzure Stack Hub Portal and API Summary AzsPortalAPISummaryAzsPortalAPISummary
VM-gebeurtenissen van Azure Stack hub-schaal eenhedenAzure Stack Hub Scale Unit VM Events AzsScaleUnitEventsAzsScaleUnitEvents
VM-resources van Azure Stack hub-schaal eenhedenAzure Stack Hub Scale Unit VM Resources AzsScaleUnitResourcesAzsScaleUnitResources
Azure Stack hub-Scenario'sAzure Stack Hub Scenarios AzsScenariosAzsScenarios
Samen vatting van validatie van Azure Stack hub-SDNAzure Stack Hub SDN Validation Summary AzsSDNValidationAzsSDNValidation
Samen vatting van Azure Stack hub Service Fabric-rolAzure Stack Hub Service Fabric Role Summary AzsSFRoleSummaryAzsSFRoleSummary
Gegevens vlak van Azure Stack hub-opslagAzure Stack Hub Storage Data Plane AzsStorageDataPlaneAzsStorageDataPlane
Samen vatting van Azure Stack hub Storage servicesAzure Stack Hub Storage Services Summary AzsStorageSvcsSummaryAzsStorageSvcsSummary
Overzicht van SQL Store voor Azure Stack hubAzure Stack Hub SQL Store Summary AzsStoreSummaryAzsStoreSummary
Overzicht van de update van Azure Stack hubAzure Stack Hub Update Summary AzsInfraUpdateSummaryAzsInfraUpdateSummary
Plaatsings overzicht van Azure Stack hub-VMAzure Stack Hub VM Placement Summary AzsVmPlacementAzsVmPlacement

Cloud scenario testsCloud scenario tests

Naast de bovenstaande infrastructuur tests kunt u ook Cloud scenario tests uitvoeren om de functionaliteit van infrastructuur onderdelen te controleren.In addition to the infrastructure tests above, you can also run cloud scenario tests to check functionality across infrastructure components. De referenties voor de Cloud beheerder zijn vereist om deze tests uit te voeren, omdat hiervoor resource implementatie is betrokken.Cloud admin credentials are required to run these tests because they involve resource deployment.

Notitie

Het is momenteel niet mogelijk om Cloud scenario's te testen met behulp van referenties voor Active Directory Federated Services (AD FS).Currently you can't run cloud scenario tests using Active Directory Federated Services (AD FS) credentials.

De volgende Cloud scenario's worden getest door het validatie programma:The following cloud scenarios are tested by the validation tool:

  • Maken van resource groepResource group creation
  • Plan makenPlan creation
  • Aanbieding makenOffer creation
  • Maken van een opslagaccountStorage account creation
  • Virtuele machine maken (VM)Virtual machine creation (VM)
  • Blob-opslag bewerkingBlob storage operation
  • Wachtrij opslag bewerkingQueue storage operation
  • Tabel opslag bewerkingTable storage operation

Parameter overwegingenParameter considerations

  • De parameter lijst kan worden gebruikt om alle beschik bare test categorieën weer te geven.The parameter List can be used to display all available test categories.

  • De para meters include en Ignore kunnen worden gebruikt om test Categorieën op te nemen of uit te sluiten.The parameters Include and Ignore can be used to include or exclude test categories. Zie de volgende sectie voor meer informatie over deze argumenten.For more information about these arguments, see the following section.

    Test-AzureStack -Include AzsSFRoleSummary, AzsInfraCapacity
    
    Test-AzureStack -Ignore AzsInfraPerformance
    
  • Een Tenant-VM wordt geïmplementeerd als onderdeel van de test voor Cloud scenario's.A tenant VM is deployed as part of the cloud scenario tests. U kunt DoNotDeployTenantVm gebruiken om deze VM-implementatie uit te scha kelen.You can use DoNotDeployTenantVm to disable this VM deployment.

  • U moet de para meter ServiceAdminCredential opgeven om Cloud scenario tests uit te voeren zoals beschreven in de sectie voor beelden van use-cases .You need to supply the ServiceAdminCredential parameter to run cloud scenario tests as described in the Use case examples section.

  • BackupSharePath en BackupShareCredential worden gebruikt bij het testen van de back-upinstellingen voor de infra structuur, zoals weer gegeven in de sectie voor beelden van use-caseBackupSharePath and BackupShareCredential are used when testing infrastructure backup settings as shown in the Use case examples section.

  • DetailedResults kan worden gebruikt voor het ophalen van informatie over slagen/mislukken/waarschuwingen voor elke test, evenals de algehele uitvoering.DetailedResults can be used to get pass/fail/warning information for each test, as well as the overall run. Als u niets opgeeft, test-AzureStack retourneert $True als er geen fouten zijn en $False als er fouten zijn.When not specified, Test-AzureStack returns $true if there are no failures, and $false if there are failures.

  • TimeoutSeconds kan worden gebruikt om een specifieke tijd in te stellen voor elke groep die moet worden voltooid.TimeoutSeconds can be used to set a specific time for each group to complete.

  • Het validatie hulpprogramma biedt ook ondersteuning voor algemene Power shell-para meters: uitgebreid, debug, error Action, ErrorVariable, WarningAction, WarningVariable, outbuffer, PipelineVariable en outvariable.The validation tool also supports common PowerShell parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. Zie about common para meters(Engelstalig) voor meer informatie.For more information, see About Common Parameters.

Voor beelden van use-casesUse case examples

Validatie uitvoeren zonder Cloud scenario'sRun validation without cloud scenarios

Voer het validatie hulpprogramma uit zonder de para meter ServiceAdminCredential om actieve Cloud scenario testen over te slaan:Run the validation tool without the ServiceAdminCredential parameter to skip running cloud scenario tests:

New-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack

Validatie uitvoeren met Cloud scenario'sRun validation with cloud scenarios

Als u het validatie hulpprogramma opgeeft met de para meter ServiceAdminCredentials , worden de Cloud scenario tests standaard uitgevoerd:Supplying the validation tool with the ServiceAdminCredentials parameter runs the cloud scenario tests by default:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>" 

Als u alleen Cloud scenario's wilt uitvoeren zonder de rest van de tests uit te voeren, kunt u de para meter include gebruiken om dit te doen:If you wish to run ONLY cloud scenarios without running the rest of the tests, you can use the Include parameter to do so:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>" -Include AzsScenarios   

De gebruikers naam voor de Cloud beheerder moet de volgende indeling hebben: serviceadmin@contoso.onmicrosoft.com (Azure AD).The cloud admin user name must be typed in the UPN format: serviceadmin@contoso.onmicrosoft.com (Azure AD). Wanneer u hierom wordt gevraagd, typt u het wacht woord voor het account voor de Cloud beheerder.When prompted, type the password to the cloud admin account.

GroepenGroups

Voor het verbeteren van de operator-ervaring is een groeps parameter ingeschakeld om tegelijkertijd meerdere test categorieën uit te voeren.To improve the operator experience, a Group parameter has been enabled to run multiple test categories at the same time. Er zijn momenteel drie groepen gedefinieerd: standaard, UpdateReadiness en SecretRotationReadiness.Currently, there are three groups defined: Default, UpdateReadiness, and SecretRotationReadiness.

  • Standaard: wordt beschouwd als een standaard uitvoering van test-AzureStack.Default: Considered to be a standard run of Test-AzureStack. Deze groep wordt standaard uitgevoerd als er geen andere groepen zijn geselecteerd.This group is run by default if no other groups are selected.

  • UpdateReadiness: een controle om te zien of het exemplaar van de Azure stack hub kan worden bijgewerkt.UpdateReadiness: A check to see if the Azure Stack Hub instance can be updated. Wanneer de UpdateReadiness -groep wordt uitgevoerd, worden waarschuwingen weer gegeven als fouten in de console-uitvoer en moeten ze worden beschouwd als blokken voor de update.When the UpdateReadiness group is run, warnings are displayed as errors in the console output, and they should be considered as blockers for the update. Vanaf Azure Stack hub-versie 1910 zijn de volgende categorieën onderdeel van de groep UpdateReadiness :As of Azure Stack Hub Version 1910 the following categories are part of the UpdateReadiness group:

    • AzsInfraFileValidationAzsInfraFileValidation
    • AzsActionPlanStatusAzsActionPlanStatus
    • AzsStampBMCSummaryAzsStampBMCSummary
  • SecretRotationReadiness: een controle om te zien of de instantie van de Azure stack-hub zich in een status bevindt waarin het uitvoeren van een geheime draaiing kan worden uitgevoerd.SecretRotationReadiness: A check to see if the Azure Stack Hub instance is in a state in which secret rotation can be run. Wanneer de groep SecretRotationReadiness wordt uitgevoerd, worden waarschuwingen weer gegeven als fouten in de console-uitvoer en moeten ze als blok keringen worden beschouwd voor een geheime rotatie.When the SecretRotationReadiness group is run, warnings are displayed as errors in the console output and they should be considered as blockers for secret rotation. De volgende categorieën maken deel uit van de SecretRotationReadiness-groep:The following categories are part of the SecretRotationReadiness Group:

    • AzsAcsSummaryAzsAcsSummary
    • AzsDefenderSummaryAzsDefenderSummary
    • AzsHostingInfraSummaryAzsHostingInfraSummary
    • AzsInfraCapacityAzsInfraCapacity
    • AzsInfraRoleSummaryAzsInfraRoleSummary
    • AzsPortalAPISummaryAzsPortalAPISummary
    • AzsSFRoleSummaryAzsSFRoleSummary
    • AzsStorageSvcsSummaryAzsStorageSvcsSummary
    • AzsStoreSummaryAzsStoreSummary

Voor beeld van groeps parameterGroup parameter example

In het volgende voor beeld wordt test-AzureStack uitgevoerd om de gereedheid van het systeem te testen voordat u een update of hotfix installeert met behulp van groep.The following example runs Test-AzureStack to test system readiness before installing an update or hotfix using Group. Voordat u begint met de installatie van een update of hotfix, voert u test-AzureStack uit om de status van uw Azure stack hub te controleren:Before you start the installation of an update or hotfix, run Test-AzureStack to check the status of your Azure Stack Hub:

Test-AzureStack -Group UpdateReadiness

Als op uw Azure Stack-hub een versie vóór 1811 wordt uitgevoerd, gebruikt u de volgende Power shell-opdrachten voor het uitvoeren van test-AzureStack:If your Azure Stack Hub is running a version before 1811, use the following PowerShell commands to run Test-AzureStack:

New-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsControlPlane, AzsDefenderSummary, AzsHostingInfraSummary, AzsHostingInfraUtilization, AzsInfraCapacity, AzsInfraRoleSummary, AzsPortalAPISummary, AzsSFRoleSummary, AzsStampBMCSummary

Validatie programma uitvoeren om de back-upinstellingen van de infra structuur te testenRun validation tool to test infrastructure backup settings

Voordat u een infra structuur-back-up configureert, kunt u het pad naar de back-upshare en de referentie testen met de AzsBackupShareAccessibility -test:Before configuring infrastructure backup, you can test the backup share path and credential using the AzsBackupShareAccessibility test:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsBackupShareAccessibility -BackupSharePath "\\<fileserver>\<fileshare>" -BackupShareCredential $using:backupcred

Na het configureren van de back-up kunt u AzsBackupShareAccessibility uitvoeren om te valideren dat de share toegankelijk is vanuit de ERCS:After configuring backup, you can run AzsBackupShareAccessibility to validate the share is accessible from the ERCS:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsBackupShareAccessibility

Voer de volgende handelingen uit om nieuwe referenties te testen met de geconfigureerde back-upshare:To test new credentials with the configured backup share, run:

Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred 
Test-AzureStack -Include AzsBackupShareAccessibility -BackupShareCredential "<PSCredential for backup share>"

Validatie programma uitvoeren om de netwerk infrastructuur te testenRun validation tool to test network infrastructure

Met deze test wordt de verbinding van de netwerk infrastructuur gecontroleerd, waarbij de Azure Stack hub software defined Network (SDN) wordt overgeslagen.This test checks the connectivity of the network infrastructure bypassing the Azure Stack Hub software defined network (SDN). Het demonstreert de connectiviteit van een open bare VIP naar de geconfigureerde DNS-doorstuur servers, NTP-server en verificatie-eind punten.It demonstrates connectivity from a Public VIP to the configured DNS forwarders, NTP servers, and authentication endpoints. Dit geldt ook voor de connectiviteit met Azure wanneer u Azure AD als id-provider of de federatieve server gebruikt wanneer u AD FS als id-provider gebruikt.This includes connectivity to Azure when using Azure AD as identity provider or the federated server when using AD FS as identity provider.

Neem de para meter debug op om een gedetailleerde uitvoer van de opdracht te krijgen:Include the debug parameter to get a detailed output of the command:

Test-AzureStack -Include AzsNetworkInfra -Debug

Volgende stappenNext steps

Zie Azure stack hub Diagnostics Tools(Engelstalig) voor meer informatie over hulpprogram ma's voor diagnostische gegevens over Azure stack hub en logboek registratie van problemen.To learn more about Azure Stack Hub diagnostics tools and issue logging, see Azure Stack Hub diagnostics tools.

Zie Microsoft Azure stack hub oplossenvoor meer informatie over het oplossen van problemen.To learn more about troubleshooting, see Microsoft Azure Stack Hub troubleshooting.