Bagikan melalui

Memvalidasi pendaftaran Azure

  • Artikel

Gunakan alat Azure Stack Hub Readiness Checker (AzsReadinessChecker) untuk memvalidasi bahwa langganan Azure Anda siap digunakan dengan Azure Stack Hub sebelum Anda memulai penyebaran Azure Stack Hub. Pemeriksa kesiapan memvalidasi bahwa:

  • Langganan Azure yang Anda gunakan adalah jenis yang didukung. Langganan harus merupakan Penyedia Solusi Cloud (CSP) atau Perjanjian Enterprise (EA).
  • Akun yang Anda gunakan untuk mendaftarkan langganan dengan Azure dapat masuk ke Azure dan merupakan pemilik langganan.

Untuk informasi selengkapnya tentang pendaftaran Azure Stack Hub, lihat Mendaftarkan Azure Stack Hub dengan Azure.

Mendapatkan alat Pemeriksa Kesiapan

Unduh AzsReadinessChecker versi terbaru dari Galeri PowerShell.

Menginstal dan mengonfigurasi

Prasyarat

Prasyarat berikut diperlukan:

Modul Az PowerShell

Anda harus menginstal modul Az PowerShell. Untuk mengetahui petunjuknya, lihat Menginstal modul pratinjau PowerShell Az.

lingkungan Microsoft Entra

  • Identifikasi nama pengguna dan kata sandi untuk akun yang merupakan pemilik untuk langganan Azure yang akan Anda gunakan dengan Azure Stack Hub.
  • Identifikasi ID langganan untuk langganan Azure yang akan Anda gunakan.

Langkah-langkah untuk memvalidasi pendaftaran Azure

  1. Buka perintah PowerShell yang ditingkatkan, lalu jalankan perintah berikut untuk menginstal AzsReadinessChecker:

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

  2. Dari permintaan PowerShell, jalankan perintah berikut untuk ditetapkan $subscriptionID sebagai langganan Azure yang akan digunakan. Mengganti xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx dengan ID langganan Anda sendiri:

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

  3. Dari perintah PowerShell, jalankan perintah berikut:

    Connect-AzAccount -subscription $subscriptionID

  4. Dari perintah PowerShell, jalankan perintah berikut untuk memulai validasi langganan Anda. Berikan administrator Microsoft Entra dan nama penyewa Microsoft Entra Anda:

    Invoke-AzsRegistrationValidation  -RegistrationSubscriptionID $subscriptionID

  5. Setelah alat berjalan, tinjau outputnya. Konfirmasikan status yang benar untuk rincian masuk dan persyaratan pendaftaran. Output validasi yang berhasil akan muncul mirip dengan contoh berikut:

    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

Melaporkan dan mencatat file

Setiap kali dijalankan, validasi mencatat hasil ke AzsReadinessChecker.log dan AzsReadinessCheckerReport.json. Lokasi file-file ini ditampilkan beserta hasil validasi di PowerShell.

File ini dapat membantu Anda berbagi status validasi sebelum Anda menyebarkan Azure Stack Hub atau menyelidiki masalah validasi. Kedua file mempertahankan hasil dari setiap pemeriksaan validasi berikutnya. Laporan tersebut memberikan konfirmasi kepada tim penyebaran Anda tentang konfigurasi identitas. File log dapat membantu penyebaran atau tim dukungan Anda menyelidiki masalah validasi.

Secara default, kedua file ditulis ke C:\Users\username\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json.

  • Gunakan parameter -OutputPath <path> di akhir baris perintah jalankan untuk menentukan lokasi laporan yang berbeda.
  • Gunakan parameter -CleanReport di akhir perintah jalankan untuk menghapus informasi tentang pengoperasian alat sebelumnya dari AzsReadinessCheckerReport.json.

Untuk informasi lebih lanjut, lihat laporan validasi Azure Stack Hub.

Kegagalan validasi

Jika pemeriksaan validasi gagal, detail tentang kegagalan tersebut akan ditampilkan di jendela PowerShell. Alat tersebut juga mencatat informasi ke file AzsReadinessChecker.log.

Contoh berikut memberikan informasi selengkapnya tentang kegagalan validasi umum.

Pengguna harus menjadi pemilik langganan

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

Penyebab - Akun bukan administrator langganan Azure.

Resolusi - Gunakan akun yang merupakan administrator langganan Azure yang akan ditagih penggunaannya dari penyebaran Azure Stack Hub.

Kata sandi kedaluwarsa atau sementara

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

Penyebab - Akun tidak dapat masuk karena sandi kedaluwarsa atau bersifat sementara.

Resolusi - Di PowerShell, jalankan perintah berikut dan ikuti permintaan untuk mereset kata sandi.

Login-AzureRMAccount

Cara lain adalah masuk ke portal Microsoft Azure sebagai pemilik akun, dan pengguna akan dipaksa untuk mengubah kata sandi.

Jenis pengguna tidak diketahui

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

Penyebab - Akun tidak dapat masuk ke lingkungan Microsoft Entra yang ditentukan. Dalam contoh ini, AzureChinaCloud ditentukan sebagai AzureEnvironment.

Resolusi - Konfirmasi bahwa akun tersebut valid untuk lingkungan Azure yang ditentukan. Di PowerShell, jalankan perintah berikut untuk memverifikasi bahwa akun tersebut valid untuk lingkungan tertentu:

Login-AzureRmAccount -EnvironmentName AzureChinaCloud

Langkah berikutnya