Udostępnij przez

Validate Azure registration (Sprawdzanie poprawności rejestracji na platformie Azure)

Przed rozpoczęciem wdrażania usługi Azure Stack Hub użyj narzędzia do sprawdzania gotowości usługi Azure Stack Hub (AzsReadinessChecker). Kontroler gotowości sprawdza, czy:

  • Używana subskrypcja platformy Azure jest obsługiwanym typem. Subskrypcje muszą być dostawcą rozwiązań w chmurze (CSP) lub Enterprise Agreement (EA).
  • Konto, którego używasz do rejestrowania subskrypcji na platformie Azure, może zalogować się do platformy Azure i jest właścicielem subskrypcji.

Aby uzyskać więcej informacji na temat rejestracji w usłudze Azure Stack Hub, zobacz Rejestrowanie usługi Azure Stack Hub na platformie Azure.

Pobieranie narzędzia sprawdzania gotowości

Pobierz najnowszą wersję narzędzia AzsReadinessChecker z Galeria programu PowerShell.

Instalowanie i konfigurowanie

Wymagania wstępne

Wymagane są następujące wymagania wstępne:

Moduły Az programu PowerShell

Konieczne będzie zainstalowanie modułów Az programu PowerShell. Aby uzyskać instrukcje, zobacz Instalowanie modułu Az programu PowerShell w wersji zapoznawczej.

środowisko Microsoft Entra

  • Zidentyfikuj nazwę użytkownika i hasło dla konta, które jest właścicielem subskrypcji platformy Azure, której będziesz używać z usługą Azure Stack Hub.
  • Zidentyfikuj identyfikator subskrypcji platformy Azure, której będziesz używać.

Kroki weryfikacji rejestracji platformy Azure

  1. Otwórz wiersz polecenia programu PowerShell z podwyższonym poziomem uprawnień, a następnie uruchom następujące polecenie, aby zainstalować narzędzie AzsReadinessChecker:

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

  2. W wierszu polecenia programu PowerShell uruchom następujące polecenie, aby ustawić jako $subscriptionID subskrypcję platformy Azure do użycia. Zastąp xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ciąg własnym identyfikatorem subskrypcji:

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

  3. W wierszu polecenia programu PowerShell uruchom następujące polecenie:

    Connect-AzAccount -subscription $subscriptionID

  4. W wierszu polecenia programu PowerShell uruchom następujące polecenie, aby rozpocząć walidację subskrypcji. Podaj administratora Microsoft Entra i nazwę dzierżawy Microsoft Entra:

    Invoke-AzsRegistrationValidation  -RegistrationSubscriptionID $subscriptionID

  5. Po uruchomieniu narzędzia przejrzyj dane wyjściowe. Upewnij się, że stan jest poprawny zarówno dla wymagań logowania, jak i rejestracji. Dane wyjściowe pomyślnej weryfikacji są podobne do następujących:

    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

Plik raportu i dziennika

Przy każdym uruchomieniu walidacji rejestruje wyniki w plikach AzsReadinessChecker.log i AzsReadinessCheckerReport.json. Lokalizacja tych plików jest wyświetlana wraz z wynikami weryfikacji w programie PowerShell.

Te pliki mogą ułatwić udostępnianie stanu weryfikacji przed wdrożeniem usługi Azure Stack Hub lub badaniem problemów z walidacją. Oba pliki utrwalają wyniki każdego kolejnego sprawdzania poprawności. Raport zawiera potwierdzenie konfiguracji tożsamości przez zespół wdrożeniowy. Plik dziennika może pomóc zespołowi wdrożeniowemu lub zespołowi pomocy technicznej w zbadaniu problemów z walidacją.

Domyślnie oba pliki są zapisywane w pliku C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json.

  • Użyj parametru -OutputPath <path> na końcu wiersza polecenia uruchamiania, aby określić inną lokalizację raportu.
  • Użyj parametru -CleanReport na końcu polecenia run, aby wyczyścić informacje o poprzednich uruchomieniach narzędzia z pliku AzsReadinessCheckerReport.json.

Aby uzyskać więcej informacji, zobacz Raport weryfikacji usługi Azure Stack Hub.

Błędy walidacji

Jeśli sprawdzanie poprawności nie powiedzie się, szczegółowe informacje o niepowodzeniu są wyświetlane w oknie programu PowerShell. Narzędzie rejestruje również informacje w pliku AzsReadinessChecker.log .

Poniższe przykłady zawierają więcej informacji na temat typowych błędów walidacji.

Użytkownik musi być właścicielem subskrypcji

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

Przyczyna — konto nie jest administratorem subskrypcji platformy Azure.

Rozwiązanie — użyj konta, które jest administratorem subskrypcji platformy Azure, które będzie rozliczane za użycie z wdrożenia usługi Azure Stack Hub.

Wygasłe lub tymczasowe hasło

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

Przyczyna — konto nie może się zalogować, ponieważ hasło wygasło lub było tymczasowe.

Rozwiązanie — w programie PowerShell uruchom następujące polecenie i postępuj zgodnie z monitami, aby zresetować hasło.

Login-AzureRMAccount

Innym sposobem jest zalogowanie się do Azure Portal jako właściciel konta, a użytkownik zostanie zmuszony do zmiany hasła.

Nieznany typ użytkownika

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

Przyczyna — konto nie może zalogować się do określonego środowiska Microsoft Entra. W tym przykładzie usługa AzureChinaCloud jest określana jako AzureEnvironment.

Rozwiązanie — upewnij się, że konto jest prawidłowe dla określonego środowiska platformy Azure. W programie PowerShell uruchom następujące polecenie, aby sprawdzić, czy konto jest prawidłowe dla określonego środowiska:

Login-AzureRmAccount -EnvironmentName AzureChinaCloud

Następne kroki

  • Last updated on