Dela via

Verifiera Azure-registrering

  • Artikel

Använd verktyget Azure Stack Hub Readiness Checker (AzsReadinessChecker) för att verifiera att din Azure-prenumeration är redo att användas med Azure Stack Hub innan du påbörjar en Azure Stack Hub-distribution. Beredskapskontrollen verifierar att:

  • Den Azure-prenumeration som du använder är en typ som stöds. Prenumerationer måste vara en molnlösningsleverantör (CSP) eller Enterprise-avtal (EA).
  • Det konto som du använder för att registrera din prenumeration med Azure kan logga in på Azure och är prenumerationsägare.

Mer information om Azure Stack Hub-registrering finns i Registrera Azure Stack Hub med Azure.

Hämta verktyget Beredskapskontroll

Ladda ned den senaste versionen av AzsReadinessChecker från PowerShell-galleriet.

Installera och konfigurera

Förutsättningar

Följande krav krävs:

Az PowerShell-moduler

Du måste ha Az PowerShell-modulerna installerade. Anvisningar finns i Installera PowerShell Az-förhandsgranskningsmodulen.

Microsoft Entra miljö

  • Identifiera användarnamnet och lösenordet för ett konto som är ägare till den Azure-prenumeration som du ska använda med Azure Stack Hub.
  • Identifiera prenumerations-ID:t för den Azure-prenumeration som du ska använda.

Steg för att verifiera Azure-registreringen

  1. Öppna en upphöjd PowerShell-prompt och kör sedan följande kommando för att installera AzsReadinessChecker:

    Install-Module -Name Az.BootStrapper -Force -AllowPrerelease
Install-AzProfile -Profile 2020-09-01-hybrid -Force
Install-Module -Name Microsoft.AzureStack.ReadinessChecker

  2. Från PowerShell-prompten kör du följande kommando för att ange $subscriptionID som den Azure-prenumeration som ska användas. Ersätt xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx med ditt eget prenumerations-ID:

    $subscriptionID = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

  3. Kör följande kommando i PowerShell-prompten:

    Connect-AzAccount -subscription $subscriptionID

  4. I PowerShell-prompten kör du följande kommando för att starta verifieringen av din prenumeration. Ange din Microsoft Entra-administratör och ditt Microsoft Entra klientnamn:

    Invoke-AzsRegistrationValidation  -RegistrationSubscriptionID $subscriptionID

  5. När verktyget har körts granskar du utdata. Kontrollera att statusen är korrekt för både inloggning och registreringskrav. Valideringsutdata ser ut ungefär som i följande exempel:

    Invoke-AzsRegistrationValidation v1.2100.1448.484 started.
Checking Registration Requirements: OK

Log location (contains PII): C:\Users\[*redacted*]\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log
Report location (contains PII): C:\Users\[*redacted*]\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
Invoke-AzsRegistrationValidation Completed

Rapport- och loggfil

Varje gång verifieringen körs loggar den resultatet till AzsReadinessChecker.log och AzsReadinessCheckerReport.json. Platsen för dessa filer visas tillsammans med valideringsresultaten i PowerShell.

De här filerna kan hjälpa dig att dela valideringsstatus innan du distribuerar Azure Stack Hub eller undersöker valideringsproblem. Båda filerna bevarar resultatet av varje efterföljande verifieringskontroll. Rapporten ger distributionsteamet en bekräftelse av identitetskonfigurationen. Loggfilen kan hjälpa distributions- eller supportteamet att undersöka valideringsproblem.

Som standard skrivs båda filerna till C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json.

  • Använd parametern -OutputPath <path> i slutet av körningskommandoraden för att ange en annan rapportplats.
  • Använd parametern -CleanReport i slutet av körningskommandot för att rensa information om tidigare körningar av verktyget från AzsReadinessCheckerReport.json.

Mer information finns i Verifieringsrapport för Azure Stack Hub.

Valideringsfel

Om en valideringskontroll misslyckas visas information om felet i PowerShell-fönstret. Verktyget loggar även information till filen AzsReadinessChecker.log .

I följande exempel finns mer information om vanliga valideringsfel.

Användaren måste vara ägare till prenumerationen

Invoke-AzsRegistrationValidation v1.1809.1005.1 started.
Checking Registration Requirements: Fail
Error Details for registration account admin@contoso.onmicrosoft.com:
The user admin@contoso.onmicrosoft.com is role(s) Reader for subscription 3f961d1c-d1fb-40c3-99ba-44524b56df2d. User must be an owner of the subscription to be used for registration.
Additional help URL https://aka.ms/AzsRemediateRegistration

Log location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log
Report location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
Invoke-AzsRegistrationValidation Completed

Orsak – Kontot är inte administratör för Azure-prenumerationen.

Lösning – Använd ett konto som är administratör för Den Azure-prenumeration som debiteras för användning från Azure Stack Hub-distributionen.

Utgånget eller tillfälligt lösenord

Invoke-AzsRegistrationValidation v1.1809.1005.1 started.
Checking Registration Requirements: Fail
Error Details for registration account admin@contoso.onmicrosoft.com:
Checking Registration failed with: Retrieving TenantId for subscription [subscription ID] using account admin@contoso.onmicrosoft.com failed with AADSTS50055: Force Change Password.
Trace ID: [Trace ID]
Correlation ID: [Correlation ID]
Timestamp: 2018-10-22 11:16:56Z: The remote server returned an error: (401) Unauthorized.

Log location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log
Report location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
Invoke-AzsRegistrationValidation Completed

Orsak – Kontot kan inte logga in eftersom lösenordet antingen har upphört att gälla eller är tillfälligt.

Lösning – Kör följande kommando i PowerShell och följ anvisningarna för att återställa lösenordet.

Login-AzureRMAccount

Ett annat sätt är att logga in på Azure Portal som kontoägare och användaren tvingas ändra lösenordet.

Okänd användartyp

Invoke-AzsRegistrationValidation v1.1809.1005.1 started.
Checking Registration Requirements: Fail
Error Details for registration account admin@contoso.onmicrosoft.com:
Checking Registration failed with: Retrieving TenantId for subscription <subscription ID> using <account> failed with unknown_user_type: Unknown User Type

Log location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessChecker.log
Report location (contains PII): C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
Invoke-AzsRegistrationValidation Completed

Orsak – Kontot kan inte logga in på den angivna Microsoft Entra miljön. I det här exemplet anges AzureChinaCloud som AzureEnvironment.

Lösning – Bekräfta att kontot är giltigt för den angivna Azure-miljön. I PowerShell kör du följande kommando för att kontrollera att kontot är giltigt för en specifik miljö:

Login-AzureRmAccount -EnvironmentName AzureChinaCloud

Nästa steg