Azure kaydını doğrulama

  • Makale

Azure Stack Hub dağıtımına başlamadan önce Azure aboneliğinizin Azure Stack Hub ile kullanıma hazır olduğunu doğrulamak için Azure Stack Hub Hazırlık Denetleyicisi aracını (AzsReadinessChecker) kullanın. Hazır olma denetleyicisi aşağıdakileri doğrular:

  • Kullandığınız Azure aboneliği desteklenen bir türdür. Abonelikler bir Bulut Çözümü Sağlayıcısı (CSP) veya Kurumsal Anlaşma (EA) olmalıdır.
  • Aboneliğinizi Azure'a kaydetmek için kullandığınız hesap Azure'da oturum açabilir ve bir abonelik sahibidir.

Azure Stack Hub kaydı hakkında daha fazla bilgi için bkz. Azure Stack Hub'ı Azure'a kaydetme.

Hazırlık Denetleyicisi aracını edinin

PowerShell GalerisiAzsReadinessChecker'ın en son sürümünü indirin.

Yükleme ve yapılandırma

Önkoşullar

Aşağıdaki önkoşullar gereklidir:

Az PowerShell modülleri

Az PowerShell modüllerinin yüklü olması gerekir. Yönergeler için bkz. PowerShell Az önizleme modülünü yükleme.

Microsoft Entra ortamı

  • Azure Stack Hub ile kullanacağınız Azure aboneliğinin sahibi olan bir hesabın kullanıcı adını ve parolasını belirleyin.
  • Kullanacağınız Azure aboneliğinin abonelik kimliğini belirleyin.

Azure kaydını doğrulama adımları

  1. Yükseltilmiş bir PowerShell istemi açın ve ardından AzsReadinessChecker'ı yüklemek için aşağıdaki komutu çalıştırın:

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

  2. PowerShell isteminde aşağıdaki komutu çalıştırarak kullanılacak Azure aboneliğini ayarlayın $subscriptionID . değerini kendi abonelik kimliğinizle değiştirin xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx :

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

  3. PowerShell isteminde aşağıdaki komutu çalıştırın:

    Connect-AzAccount -subscription $subscriptionID

  4. PowerShell isteminde aşağıdaki komutu çalıştırarak aboneliğinizin doğrulamasını başlatın. Microsoft Entra yöneticinizi ve Microsoft Entra kiracı adınızı belirtin:

    Invoke-AzsRegistrationValidation  -RegistrationSubscriptionID $subscriptionID

  5. Araç çalıştıktan sonra çıkışı gözden geçirin. Hem oturum açma hem de kayıt gereksinimleri için durumun doğru olduğunu onaylayın. Başarılı doğrulama çıktısı aşağıdaki örneğe benzer şekilde görünür:

    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

Rapor ve günlük dosyası

Doğrulama her çalıştığında, sonuçları AzsReadinessChecker.log ve AzsReadinessCheckerReport.json'a günlüğe kaydeder. Bu dosyaların konumu, PowerShell'deki doğrulama sonuçlarıyla birlikte görüntülenir.

Bu dosyalar, Azure Stack Hub'ı dağıtmadan veya doğrulama sorunlarını araştırmadan önce doğrulama durumunu paylaşmanıza yardımcı olabilir. Her iki dosya da sonraki doğrulama denetimlerinin sonuçlarını kalıcı hale döndürür. Rapor, dağıtım ekibinize kimlik yapılandırmasının onayını sağlar. Günlük dosyası, dağıtım veya destek ekibinizin doğrulama sorunlarını incelemesine yardımcı olabilir.

Varsayılan olarak, her iki dosya da öğesine C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.jsonyazılır.

  • -OutputPath <path> Farklı bir rapor konumu belirtmek için çalıştırma komut satırının sonundaki parametresini kullanın.
  • -CleanReportAzsReadinessCheckerReport.json dosyasından aracın önceki çalıştırmaları hakkındaki bilgileri temizlemek için çalıştırma komutunun sonundaki parametresini kullanın.

Daha fazla bilgi için bkz. Azure Stack Hub doğrulama raporu.

Doğrulama hataları

Doğrulama denetimi başarısız olursa, hatayla ilgili ayrıntılar PowerShell penceresinde görüntülenir. Araç, bilgileri AzsReadinessChecker.log dosyasına da kaydeder.

Aşağıdaki örnekler yaygın doğrulama hataları hakkında daha fazla bilgi sağlar.

Kullanıcı aboneliğin sahibi olmalıdır

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

Neden - Hesap, Azure aboneliğinin yöneticisi değil.

Çözüm - Azure Stack Hub dağıtımından kullanım için faturalandırılacak Azure aboneliğinin yöneticisi olan bir hesap kullanın.

Süresi dolmuş veya geçici parola

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

Neden - Parolanın süresi dolduğundan veya geçici olduğundan hesap oturum açamıyor.

Çözüm - PowerShell'de aşağıdaki komutu çalıştırın ve parolayı sıfırlamak için istemleri izleyin.

Login-AzureRMAccount

Bir diğer yol da hesap sahibi olarak Azure portal oturum açmaktır ve kullanıcı parolayı değiştirmek zorunda kalır.

Bilinmeyen kullanıcı türü

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

Neden - Hesap belirtilen Microsoft Entra ortamında oturum açamıyor. Bu örnekte AzureChinaCloud , AzureEnvironment olarak belirtilmiştir.

Çözüm - Hesabın belirtilen Azure ortamı için geçerli olduğunu onaylayın. PowerShell'de, hesabın belirli bir ortam için geçerli olduğunu doğrulamak için aşağıdaki komutu çalıştırın:

Login-AzureRmAccount -EnvironmentName AzureChinaCloud

Sonraki Adımlar