Azure ID の検証
Azure Stack Hub 適合性チェッカー ツール (AzsReadinessChecker) を使用して、対象の Microsoft Entra ID を Azure Stack Hub で使用する準備が整っていることを検証します。 Azure Stack Hub のデプロイを開始する前に、Azure ID ソリューションを検証します。
適合性チェッカーは以下を検証します。
- Azure Stack Hub の ID プロバイダーとしての Microsoft Entra ID。
- 使用する予定の Microsoft Entra アカウントは、Microsoft Entra ID のアプリケーション管理者としてサインインできます。
検証により、Azure Stack Hub のユーザー、アプリケーション、グループ、サービス プリンシパルに関する情報を Microsoft Entra ID に格納する準備が、お使いの環境で整っていることを確認できます。
適合性チェッカー ツールを取得する
最新バージョンの Azure Stack Hub 適合性チェッカー ツール (AzsReadinessChecker) を PowerShell ギャラリーからダウンロードします。
インストールと構成
前提条件
以下の前提条件が必要です。
Az PowerShell モジュール
Az PowerShell モジュールをインストールしておく必要があります。 手順については、「PowerShell Az プレビュー モジュールをインストールする」を参照してください。
Microsoft Entra 環境
- Azure Stack Hub に使用する Microsoft Entra アカウントを特定し、それが Microsoft Entra アプリケーション管理者であることを確認します。
- Microsoft Entra テナントの名前を特定します。 テナント名は、Microsoft Entra ID のプライマリ ドメイン名でなければなりません。 (例: contoso.onmicrosoft.com)。
Azure ID を検証する手順
前提条件を満たしているコンピューターで、管理者特権の PowerShell コマンド プロンプトを開き、次のコマンドを実行して、AzsReadinessChecker をインストールします。
Install-Module -Name Az.BootStrapper -Force -AllowPrerelease Install-AzProfile -Profile 2020-09-01-hybrid -Force Install-Module -Name Microsoft.AzureStack.ReadinessChecker -AllowPrerelease
PowerShell プロンプトから、次のコマンドを実行します。
contoso.onmicrosoft.com
を Microsoft Entra テナント名に置き換えます。Connect-AzAccount -tenant contoso.onmicrosoft.com
PowerShell プロンプトで以下のコマンドを実行して、Microsoft Entra ID の検証を開始します。
contoso.onmicrosoft.com
を Microsoft Entra テナント名に置き換えます。Invoke-AzsAzureIdentityValidation -AADDirectoryTenantName contoso.onmicrosoft.com
ツールの実行後、出力を確認します。 インストールの要件について、状態が OK であることを確認します。 次の図のように、検証が成功したことが表示されます。
Invoke-AzsAzureIdentityValidation v1.2100.1448.484 started. Starting Azure Identity Validation Checking Installation Requirements: OK Finished Azure Identity Validation 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-AzsAzureIdentityValidation Completed
レポートとログ ファイル
検証を実行するたびに、結果のログが AzsReadinessChecker.log と AzsReadinessCheckerReport.json に出力されます。 これらのファイルの場所は、PowerShell に検証結果と共に表示されます。
これらのファイルは、Azure Stack Hub をデプロイする前、または検証に関する問題を調査する前に、検証の状態を共有するときに役立ちます。 両方のファイルに、以降の各検証チェックの結果が保持されます。 デプロイ チームはこのレポートを使用して ID 構成を確認できます。 デプロイ チームやサポート チームは、検証の問題を調査する際に、このログ ファイルを役立たせることができます。
既定では、両方のファイルが C:\Users\<username>\AppData\Local\Temp\AzsReadinessChecker\AzsReadinessCheckerReport.json
に書き込まれます
- 別のレポートの場所を指定するには、実行コマンド ラインの末尾に
-OutputPath <path>
パラメーターを使用します。 - ツールの以前の実行に関する情報を AzsReadinessCheckerReport.json からクリアするには、実行コマンド ラインの末尾に
-CleanReport
パラメーターを使用します。
詳細については、「Azure Stack Hub 検証レポート」を参照してください。
検証エラー
検証チェックに失敗した場合は、エラーの詳細が PowerShell ウィンドウに表示されます。 また、ツールによって、AzsReadinessChecker.log ファイルにログ情報が記録されます。
次の例は、一般的な検証エラーに関するガイダンスです。
期限切れまたは一時パスワード
Invoke-AzsAzureIdentityValidation v1.1809.1005.1 started.
Starting Azure Identity Validation
Checking Installation Requirements: Fail
Error Details for Service Administrator Account admin@contoso.onmicrosoft.com
The password for account has expired or is a temporary password that needs to be reset before continuing. Run Login-AzureRMAccount, login with credentials and follow the prompts to reset.
Additional help URL https://aka.ms/AzsRemediateAzureIdentity
Finished Azure Identity Validation
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-AzsAzureIdentityValidation Completed
原因 - パスワードの有効期限が切れているか一時パスワードであるため、アカウントでサインインできません。
解決策 - PowerShell で次のコマンドを実行し、プロンプトに従ってパスワードをリセットします。
Login-AzureRMAccount
別の方法として、Azure portal にアカウント所有者としてサインインすることがあります。この場合、ユーザーはパスワードの変更を強制されます。
ユーザーの種類が不明
Invoke-AzsAzureIdentityValidation v1.1809.1005.1 started.
Starting Azure Identity Validation
Checking Installation Requirements: Fail
Error Details for Service Administrator Account admin@contoso.onmicrosoft.com
Unknown user type detected. Check the account is valid for AzureChinaCloud
Additional help URL https://aka.ms/AzsRemediateAzureIdentity
Finished Azure Identity Validation
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-AzsAzureIdentityValidation Completed
原因 - アカウントは、指定された Microsoft Entra ID (AADDirectoryTenantName) にサインインできません。 この例では、AzureChinaCloud が AzureEnvironment として指定されています。
解決策 - 指定した Azure 環境に対してアカウントが有効であることを確認します。 PowerShell で次のコマンドを実行して、特定の環境に対してアカウントが有効であることを確認します。
Login-AzureRmAccount -EnvironmentName AzureChinaCloud
次のステップ
Azure の登録を検証する
対応状況レポートを表示する
Azure Stack Hub の統合に関する一般的な考慮事項