Verifiera system tillstånd för Azure Stack HubValidate Azure Stack Hub system state

Som en Azure Stack Hub-operatör, är det viktigt att kunna fastställa hälso tillstånd och status för systemet på begäran.As an Azure Stack Hub operator, being able to determine the health and status of your system on demand is essential. Validerings verktyget för Azure Stack Hub (test-AzureStack) är en PowerShell-cmdlet som gör att du kan köra en serie tester på systemet för att identifiera eventuella problem om det finns.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. Du uppmanas vanligt vis att köra verktyget genom den privilegierade slut punkten (PEP) när du kontaktar Microsofts kund tjänst Support (Microsoft Support) med ett problem.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. Med den systemomfattande hälso-och statusinformation kan Microsoft Support samla in och analysera detaljerade loggar, fokusera på det området där felet inträffade och arbeta med dig för att åtgärda problemet.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.

Köra verifieringsverktyget och få åtkomst till resultatRunning the validation tool and accessing results

Som anges ovan körs validerings verktyget via PEP.As stated above, the validation tool is run via the PEP. Varje test returnerar status för pass/misslyckande i PowerShell-fönstret.Each test returns a PASS/FAIL status in the PowerShell window. Här är en översikt över processen för validerings testning från slut punkt till slut punkt:Here's an outline of the end-to-end validation testing process:

  1. Upprätta förtroendet.Establish the trust. På ett integrerat system kör du följande kommando från en upphöjd Windows PowerShell-session för att lägga till PEP som en betrodd värd på den härdade virtuella datorn som körs på maskin varans livs cykel värd eller arbets station för privilegie rad åtkomst.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>"}'
    

    Om du kör Azure Stack Development Kit (ASDK) loggar du in på Development Kit-värden.If you're running the Azure Stack Development Kit (ASDK), sign in to the development kit host.

  2. Få åtkomst till PEP.Access the PEP. Kör följande kommandon för att upprätta en PEP-session:Run the following commands to establish a PEP session:

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

    Tips

    Använd AzS-ERCS01 för-ComputerName för att få åtkomst till PEP på en Azure Stack Development Kit (ASDK) värd dator.To access the PEP on an Azure Stack Development Kit (ASDK) host computer, use AzS-ERCS01 for -ComputerName.

  3. När du är i PEP kör du:Once you're in the PEP, run:

    Test-AzureStack
    

    Mer information finns i exempel på parameter överväganden och användnings fall.For more information, see Parameter considerations and Use case examples.

  4. Om test rapporten inte fungerar kör du Get-AzureStackLog .If any tests report FAIL, run Get-AzureStackLog. Anvisningar om ett integrerat system finns i så här kör du Get-AzureStackLog på Azure Stack hubb integrerade system.For instructions on an integrated system, see how to run Get-AzureStackLog on Azure Stack Hub integrated systems.

    Cmdlet: en samlar in loggar som genereras av test-AzureStack.The cmdlet gathers logs generated by Test-AzureStack. Vi rekommenderar att du inte samlar in loggar och kontaktar Microsoft Support i stället om test rapporten varnar.We recommend you don't collect logs and contact Microsoft Support instead if tests report WARN.

  5. Om du uppmanas att köra verifierings verktyget av Microsoft Support, kommer Microsoft Support-representanten att begära de loggar som du har samlat in för att fortsätta felsöka problemet.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.

Tester som är tillgängligaTests available

Med validerings verktyget kan du köra en serie system nivå tester och grundläggande moln scenarier som ger dig insikt i det aktuella läget, så att du kan åtgärda problem i systemet.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.

Tester av moln infrastrukturCloud infrastructure tests

De här testerna med låg påverkan fungerar på en infrastruktur nivå och ger dig information om olika system komponenter och-funktioner.These low impact tests work on an infrastructure level and provide you with information on various system components and functions. För närvarande grupperas testerna i följande kategorier:Currently, tests are grouped into the following categories:

Test kategoriTest Category Argument för-include och-IGNOREArgument for -Include and -Ignore
Sammanfattning av Azure Stack Hub ACSAzure Stack Hub ACS Summary AzsAcsSummaryAzsAcsSummary
Översikt över Azure Stack hubb Active DirectoryAzure Stack Hub Active Directory Summary AzsAdSummaryAzsAdSummary
Aviserings Sammanfattning för Azure Stack hubbAzure Stack Hub Alert Summary AzsAlertSummaryAzsAlertSummary
Sammanfattning av Azure Stacks nav program kraschAzure Stack Hub Application Crash Summary AzsApplicationCrashSummaryAzsApplicationCrashSummary
Översikt över säkerhets kopierings delning för Azure Stack hubbAzure Stack Hub Backup Share Accessibility Summary AzsBackupShareAccessibilityAzsBackupShareAccessibility
Azure Stack hubb BMC-SammanfattningAzure Stack Hub BMC Summary AzsStampBMCSummaryAzsStampBMCSummary
Översikt över Azure Stack hubb moln värd infrastrukturAzure Stack Hub Cloud Hosting Infrastructure Summary AzsHostingInfraSummaryAzsHostingInfraSummary
Azure Stack hubb moln värd infrastruktur användningAzure Stack Hub Cloud Hosting Infrastructure Utilization AzsHostingInfraUtilizationAzsHostingInfraUtilization
Sammanfattning av Azure Stack hubbens kontroll planAzure Stack Hub Control Plane Summary AzsControlPlaneAzsControlPlane
Sammanfattning av Azure Stack Hub DefenderAzure Stack Hub Defender Summary AzsDefenderSummaryAzsDefenderSummary
Sammanfattning av inbyggd program vara för Azure Stack hubbAzure Stack Hub Hosting Infrastructure Firmware Summary AzsHostingInfraFWSummaryAzsHostingInfraFWSummary
Azure Stack hubb infrastruktur kapacitetAzure Stack Hub Infrastructure Capacity AzsInfraCapacityAzsInfraCapacity
Prestanda för Azure Stack Hub-infrastrukturAzure Stack Hub Infrastructure Performance AzsInfraPerformanceAzsInfraPerformance
Sammanfattning av Azure Stack hubbens infrastruktur rollAzure Stack Hub Infrastructure Role Summary AzsInfraRoleSummaryAzsInfraRoleSummary
Azure Stack Hub Network-infrarödAzure Stack Hub Network Infra AzsNetworkInfraAzsNetworkInfra
Azure Stack hubb Portal och API-SammanfattningAzure Stack Hub Portal and API Summary AzsPortalAPISummaryAzsPortalAPISummary
Azure Stack nav skalnings enhet VM-händelserAzure Stack Hub Scale Unit VM Events AzsScaleUnitEventsAzsScaleUnitEvents
Azure Stack nav skalnings enhet VM-resurserAzure Stack Hub Scale Unit VM Resources AzsScaleUnitResourcesAzsScaleUnitResources
Scenarier för Azure Stack hubbAzure Stack Hub Scenarios AzsScenariosAzsScenarios
Sammanfattning av SDN-validering för Azure Stack HubAzure Stack Hub SDN Validation Summary AzsSDNValidationAzsSDNValidation
Azure Stack hubb Service Fabric roll SammanfattningAzure Stack Hub Service Fabric Role Summary AzsSFRoleSummaryAzsSFRoleSummary
Azure Stack hubb lagrings data planAzure Stack Hub Storage Data Plane AzsStorageDataPlaneAzsStorageDataPlane
Sammanfattning av Azure Stack hubb Storage ServicesAzure Stack Hub Storage Services Summary AzsStorageSvcsSummaryAzsStorageSvcsSummary
SQL Store-Sammanfattning för Azure Stack hubbAzure Stack Hub SQL Store Summary AzsStoreSummaryAzsStoreSummary
Uppdaterings Sammanfattning för Azure Stack hubbAzure Stack Hub Update Summary AzsInfraUpdateSummaryAzsInfraUpdateSummary
Sammanfattning av placering av virtuella Azure Stack hubbAzure Stack Hub VM Placement Summary AzsVmPlacementAzsVmPlacement

Cloud scenario-testerCloud scenario tests

Förutom infrastruktur testen ovan kan du också köra moln scenarios test för att kontrol lera funktioner i infrastruktur komponenter.In addition to the infrastructure tests above, you can also run cloud scenario tests to check functionality across infrastructure components. Autentiseringsuppgifter för moln administratör krävs för att köra de här testerna eftersom de inbegriper resurs distribution.Cloud admin credentials are required to run these tests because they involve resource deployment.

Anteckning

För närvarande kan du inte köra moln scenario tester med Active Directory autentiseringsuppgifter för federerade tjänster (AD FS).Currently you can't run cloud scenario tests using Active Directory Federated Services (AD FS) credentials.

Följande moln scenarier testas av validerings verktyget:The following cloud scenarios are tested by the validation tool:

  • Skapa resurs gruppResource group creation
  • Skapa planPlan creation
  • Skapa erbjudandeOffer creation
  • Skapa lagrings kontoStorage account creation
  • Skapa virtuell dator (VM)Virtual machine creation (VM)
  • Blob Storage-åtgärdBlob storage operation
  • Köa lagrings åtgärdQueue storage operation
  • Åtgärd för tabell lagringTable storage operation

Parameter övervägandenParameter considerations

  • Parameter listan kan användas för att visa alla tillgängliga test kategorier.The parameter List can be used to display all available test categories.

  • Parametrarna include och Ignore kan användas för att ta med eller undanta test kategorier.The parameters Include and Ignore can be used to include or exclude test categories. Mer information om dessa argument finns i följande avsnitt.For more information about these arguments, see the following section.

    Test-AzureStack -Include AzsSFRoleSummary, AzsInfraCapacity
    
    Test-AzureStack -Ignore AzsInfraPerformance
    
  • En virtuell klient dator distribueras som en del av moln scenario testet.A tenant VM is deployed as part of the cloud scenario tests. Du kan använda DoNotDeployTenantVm för att inaktivera distributionen av virtuella datorer.You can use DoNotDeployTenantVm to disable this VM deployment.

  • Du måste ange parametern ServiceAdminCredential för att köra moln scenario test enligt beskrivningen i avsnittet exempel på användnings fall .You need to supply the ServiceAdminCredential parameter to run cloud scenario tests as described in the Use case examples section.

  • BackupSharePath och BackupShareCredential används när du testar säkerhets kopierings inställningarna för infrastruktur som visas i avsnittet exempel på användnings fall .BackupSharePath and BackupShareCredential are used when testing infrastructure backup settings as shown in the Use case examples section.

  • DetailedResults kan användas för att hämta information om pass/misslyckande/varning för varje test, samt den övergripande körningen.DetailedResults can be used to get pass/fail/warning information for each test, as well as the overall run. Om det inte anges returnerar test-AzureStack $True om det inte finns några problem och $false om det uppstår problem.When not specified, Test-AzureStack returns $true if there are no failures, and $false if there are failures.

  • TimeoutSeconds kan användas för att ange en angiven tid för varje grupp som ska slutföras.TimeoutSeconds can be used to set a specific time for each group to complete.

  • Verifierings verktyget stöder även vanliga PowerShell-parametrar: verbose, debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, utbuffer, PipelineVariable och devariable.The validation tool also supports common PowerShell parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. Mer information finns i om vanliga parametrar.For more information, see About Common Parameters.

Exempel på användnings fallUse case examples

Köra verifiering utan moln scenarierRun validation without cloud scenarios

Kör verifierings verktyget utan parametern ServiceAdminCredential om du vill hoppa över körning av moln scenarios test: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

Köra validering med moln scenarierRun validation with cloud scenarios

Genom att tillhandahålla validerings verktyget med parametern ServiceAdminCredentials körs Cloud scenario-test som standard: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>" 

Om du bara vill köra moln scenarier utan att köra resten av testerna kan du använda parametern include för att göra det: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   

Användar namnet för moln administratören måste anges i UPN-formatet: serviceadmin@contoso.onmicrosoft.com (Azure AD).The cloud admin user name must be typed in the UPN format: serviceadmin@contoso.onmicrosoft.com (Azure AD). När du uppmanas till det anger du lösen ordet till moln administratörs kontot.When prompted, type the password to the cloud admin account.

GrupperGroups

För att förbättra operatörs upplevelsen har en grupp parameter Aktiver ATS för att köra flera test kategorier samtidigt.To improve the operator experience, a Group parameter has been enabled to run multiple test categories at the same time. För närvarande finns det tre definierade grupper: standard, UpdateReadiness och SecretRotationReadiness.Currently, there are three groups defined: Default, UpdateReadiness, and SecretRotationReadiness.

  • Standard: anses vara en standard körning av test-AzureStack.Default: Considered to be a standard run of Test-AzureStack. Den här gruppen körs som standard om inga andra grupper är markerade.This group is run by default if no other groups are selected.

  • UpdateReadiness: en kontroll för att se om Azure Stack Hub-instansen kan uppdateras.UpdateReadiness: A check to see if the Azure Stack Hub instance can be updated. När UpdateReadiness -gruppen körs visas varningar som fel i konsolens utdata, och de bör betraktas som blockerare för uppdateringen.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. Från och med Azure Stack Hub version 1910 är följande kategorier del av gruppen UpdateReadiness :As of Azure Stack Hub Version 1910 the following categories are part of the UpdateReadiness group:

    • AzsInfraFileValidationAzsInfraFileValidation
    • AzsActionPlanStatusAzsActionPlanStatus
    • AzsStampBMCSummaryAzsStampBMCSummary
  • SecretRotationReadiness: en kontroll för att se om Azure Stack Hub-instansen är i ett tillstånd där den hemliga rotationen kan köras.SecretRotationReadiness: A check to see if the Azure Stack Hub instance is in a state in which secret rotation can be run. När SecretRotationReadiness -gruppen körs visas varningar som fel i konsolens utdata och de bör betraktas som Blocker för hemlig rotation.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. Följande kategorier är en del av SecretRotationReadiness-gruppen:The following categories are part of the SecretRotationReadiness Group:

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

Exempel på en grupp parameterGroup parameter example

I följande exempel körs test-AzureStack för att testa system beredskap innan du installerar en uppdatering eller snabb korrigering med hjälp av en grupp.The following example runs Test-AzureStack to test system readiness before installing an update or hotfix using Group. Innan du påbörjar installationen av en uppdatering eller snabb korrigering kör du test-AzureStack för att kontrol lera status för din Azure Stack Hub: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

Om Azure Stack Hub kör en version före 1811 använder du följande PowerShell-kommandon för att köra 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

Kör verifierings verktyget för att testa säkerhets kopierings inställningar för infrastrukturRun validation tool to test infrastructure backup settings

Innan du konfigurerar säkerhets kopieringen av infrastrukturen kan du testa sökvägen och autentiseringsuppgiften för säkerhets kopierings resursen med AzsBackupShareAccessibility -testet: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

När du har konfigurerat säkerhets kopiering kan du köra AzsBackupShareAccessibility för att verifiera att RESURSEN är tillgänglig från 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

Kör följande om du vill testa nya autentiseringsuppgifter med den konfigurerade säkerhets kopierings resursen: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>"

Kör verifierings verktyget för att testa nätverks infrastrukturenRun validation tool to test network infrastructure

Det här testet kontrollerar anslutningen till nätverks infrastrukturen som kringgår Azure Stack Hub-SDN (Software Defined Network).This test checks the connectivity of the network infrastructure bypassing the Azure Stack Hub software defined network (SDN). Den visar anslutningen från en offentlig VIP till de konfigurerade DNS-vidarebefordrarna, NTP-servrar och autentiserings-slutpunkter.It demonstrates connectivity from a Public VIP to the configured DNS forwarders, NTP servers, and authentication endpoints. Detta inkluderar anslutning till Azure när du använder Azure AD som identitets leverantör eller den federerade servern när du använder AD FS som identitets leverantör.This includes connectivity to Azure when using Azure AD as identity provider or the federated server when using AD FS as identity provider.

Ta med parametern Felsök för att få en detaljerad utmatning av kommandot:Include the debug parameter to get a detailed output of the command:

Test-AzureStack -Include AzsNetworkInfra -Debug

Nästa stegNext steps

Mer information om Azure Stack Hubbs verktyg för hubb och problem loggning finns i Azure Stack Hub Diagnostics tools.To learn more about Azure Stack Hub diagnostics tools and issue logging, see Azure Stack Hub diagnostics tools.

Mer information om fel sökning finns i Microsoft Azure Stack hubb fel sökning.To learn more about troubleshooting, see Microsoft Azure Stack Hub troubleshooting.