Azure Stack Hub システムの状態を検証する
Azure Stack Hub のオペレーターは、使用しているシステムの正常性と状態をオンデマンドで判断できる必要があります。 Azure Stack Hub の検証ツール (Test-AzureStack) は、システムで一連のテストを実行して、障害がある場合はそれを特定する PowerShell コマンドレットです。 通常このツールは、問題について Microsoft カスタマー サービス サポート (Microsoft サポート) に問い合わせるときに、特権エンドポイント (PEP) から実行するよう求められます。 手元にシステム全体の正常性および状態情報があれば、Microsoft サポートは詳細ログを収集して分析し、エラーが発生した領域に焦点を当て、お客様と連携して問題を修正できます。
検証ツールを実行して結果にアクセスする
PEP を使用して検証ツールを実行できます。 ツールの実行に時間がかかる場合があります。 かかる時間は、システム内の仮想マシンの数によって異なります。 各テストは、PowerShell ウィンドウで合格/不合格のいずれかの状態を返します。
次に示すのは、エンド ツー エンド検証テスト プロセスの概要です。
信頼関係を確立します。 統合システムで、管理者特権の Windows PowerShell セッションから次のコマンドを実行して、ハードウェア ライフサイクル ホストまたは特権アクセス ワークステーションで実行されているセキュリティ強化された VM の信頼されたホストとして PEP を追加します。
winrm s winrm/config/client '@{TrustedHosts="<IP Address of Privileged Endpoint>"}'Azure Stack Development Kit (ASDK) を実行している場合、開発キットのホストにサインインします。
PEP にアクセスします。 PEP セッションを確立するために、次のコマンドを実行します。
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcredヒント
Azure Stack Development Kit (ASDK) ホスト コンピューターで PEP にアクセスするには、-ComputerName に対して AzS-ERCS01 を使用します。
PEP にアクセスしたら、次を実行します。
Test-AzureStack詳細については、「パラメーターに関する考慮事項」と「ユース ケースの例」を参照してください。
いずれかのテストで FAIL が報告された場合は、
Get-AzureStackLogを実行します。 統合システムでの手順については、Azure Stack Hub 統合システムでの Get-AzureStackLogの実行方法を参照してください。このコマンドレットは、Test-azurestack によって生成されたログを収集します。 テストで WARN が報告される場合は、ログを収集せずに Microsoft サポートに連絡することをお勧めします。
Microsoft サポートにより検証ツールを実行するように指示された場合、Microsoft サポートの担当者から、問題のトラブルシューティングを続行するために、お客様が収集したログの提出が求められます。
利用可能なテスト
検証ツールを使用すると、一連のシステム レベルのテストと基本的なクラウド シナリオを実行して、現在の状態を把握し、システムの問題を修正できます。
クラウド インフラストラクチャのテスト
これらの影響度が低いテストは、インフラストラクチャ レベルで動作し、さまざまなシステム コンポーネントや機能に関する情報を提供します。 現時点では、テストは、次のカテゴリにグループ化されます。
| テスト カテゴリ | -Include および -Ignore の引数 |
|---|---|
| Azure Stack Hub ACS の概要 | AzsAcsSummary |
| Azure Stack Hub アクション プランの状態 | AzsActionPlanStatus |
| Azure Stack Hub エージェントの正常性 | AzsAgentHealth |
| Azure Stack AKS Arc プレビューの概要 | AzsAksArcPreviewSummary |
| Azure Stack Hub Active Directory の概要 | AzsAdSummary |
| Azure Stack Hub のアラートの概要 | AzsAlertSummary |
| Azure Stack Hub アプリケーションのクラッシュの概要 | AzsApplicationCrashSummary |
| Azure Stack Hub バックアップ共有のアクセシビリティの概要 | AzsBackupShareAccessibility |
| Azure Stack Hub コントロール プレーンの概要 | AzsControlPlane |
| Azure Stack Hub DCB の検証 | AzsDCBValidation |
| Azure Stack Hub Defender の概要 | AzsDefenderSummary |
| Azure Stack Hub ECE プロビジョニングの状態 | AzsEceProvisioningStatus |
| Azure Stack Hub 外部証明書の概要 | AzsExternalCertificates |
| Azure Stack Hub GPU 構成の概要 | AzsGpuConfigurationSummary |
| Azure Stack Hub ハードウェア モニターの有効化 | AzsGpuConfigurationSummary |
| Azure Stack Hub のホスティング インフラストラクチャ ファームウェアの概要 | AzsHostingInfraFWSummary |
| Azure Stack Hub ホスティング インフラストラクチャの概要 | AzsHostingInfraSummary |
| Azure Stack Hub ホスティング インフラストラクチャの使用率 | AzsHostingInfraUtilization |
| Azure Stack Hub ID プロバイダーの接続 | AzsIdentityProviderConnectivity |
| Azure Stack Hub ID プロバイダーの状態 | AzsIdentityProviderStatus |
| Azure Stack Hub インフラストラクチャの容量 | AzsInfraCapacity |
| Azure Stack Hub インフラストラクチャ ファイルの検証 | AzsInfraFileValidation |
| Azure Stack Hub インフラストラクチャのパフォーマンス | AzsInfraPerformance |
| Azure Stack Hub インフラストラクチャ ロールの概要 | AzsInfraRoleSummary |
| Azure Stack Hub インフラストラクチャの更新メモリ | AzsInfraUpdateMemory |
| Azure Stack Hub インフラストラクチャの更新の概要 | AzsInfraUpdateSummary |
| Azure Stack Hub NCImos 検証 | AzsNCImosValidation |
| Azure Stack Hub ネットワーク インフラストラクチャ | AzsNetworkInfra |
| Azure Stack Hub OEM ハードウェア | AzsOemHardware |
| Azure Stack Hub OEM Update の前提条件 | AzsOemUpdatePrereqs |
| Azure Stack Hub ポータルおよび API の概要 | AzsPortalAPISummary |
| Azure Stack Hub RDMA の運用状態 | AzsRdmaOperationalStatus |
| Azure Stack Hub リソース プロバイダーの認証状態 | AzsResourceProviderAuthStatus |
| Azure Stack Hub スケール ユニットの VM イベント | AzsScaleUnitEvents |
| Azure Stack Hub スケール ユニットの VM リソース | AzsScaleUnitResources |
| Azure Stack Hub のシナリオ | AzsScenarios |
| Azure Stack Hub サービス ファブリック ロールの概要 | AzsSFRoleSummary |
| Azure Stack Hub SQL Diagnostics | AzsSQLDiagnostics |
| Azure Stack Hub SQL の概要 | AzsSQLSummary |
| Azure Stack Hub スタンプ BMC の概要 | AzsStampBMCSummary |
| Azure Stack Hub ストレージのデータ プレーン | AzsStorageDataPlane |
| Azure Stack Hub のストレージ サービスの概要 | AzsStorageSvcsSummary |
| Azure Stack Hub SQL ストアの概要 | AzsStoreSummary |
| Azure Stack Hub の使用状況の概要 | AzsUsage |
| Azure Stack Hub 使用状況ブリッジの概要 | AzsUsageBridgeSummary |
| Azure Stack Hub の VM 配置の概要 | AzsVmPlacement |
クラウド シナリオのテスト
前のセクションのインフラストラクチャ テストに加えて、クラウド シナリオ テストを実行して、インフラストラクチャ コンポーネント全体の機能を確認することもできます。 リソースのデプロイが関係するため、これらのテストを実行するは、クラウド管理者の資格情報が必要です。
Note
現時点では、Active Directory フェデレーション サービス (AD FS) の資格情報を使用してクラウド シナリオのテストを実行することはできません。
検証ツールでは、次のクラウドのシナリオがテストされます。
- リソース グループの作成
- プランの作成
- オファーの作成
- ストレージアカウントの作成
- 仮想マシン (VM) の作成
- Blob ストレージの操作
- キュー ストレージの操作
- テーブル ストレージの操作
パラメーターに関する考慮事項
パラメーター List は、利用可能なすべてのテスト カテゴリを表示するために使用できます。
パラメーター Include と Ignore は、テスト カテゴリを含めたり除外したりするために使用できます。 これらの引数の詳細については、次のセクションを参照してください。
Test-AzureStack -Include AzsSFRoleSummary, AzsInfraCapacityTest-AzureStack -Ignore AzsInfraPerformanceテナント VM はクラウド シナリオ テストの一部としてデプロイされます。 この VM のデプロイを無効にするには、DoNotDeployTenantVm を使用します。
クラウド シナリオ テストを実行するには、ServiceAdminCredential パラメーターを指定する必要があります。これについては「ユース ケースの例」のセクションで説明しています。
BackupSharePath と BackupShareCredential は、インフラストラクチャ バックアップ設定をテストするときに使用されます。これについては「ユース ケースの例」セクションで説明しています。
DetailedResults を使用すると、実行全体だけでなく、各テストの合格/不合格/警告の情報を取得できます。 指定しないと、失敗がない場合は $true が、失敗がある場合は $false が Test-AzureStack から返されます。
TimeoutSeconds を使用すると、各グループでの完了に対する特定の時刻を設定できます。
検証ツールでは、一般的な PowerShell パラメーター (Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、PipelineVariable、OutVariable) もサポートされています。 詳細については、「About Common Parameters (一般的なパラメーターについて)」を参照してください。
ユース ケース例
クラウド シナリオがない検証の実行
クラウド シナリオ テストの実行をスキップするには、ServiceAdminCredential パラメーターを指定せずに検証ツールを実行します。
New-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred -SessionOption (New-PSSessionOption -Culture en-US -UICulture en-US)
Test-AzureStack
クラウド シナリオがある検証の実行
検証ツールに ServiceAdminCredentials パラメーターを指定すると、既定でクラウド シナリオ テストが実行されます。
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>"
残りのテストを実行せずにクラウド シナリオのみを実行したい場合は、Include パラメーターを使用してそのようにすることができます。
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -ServiceAdminCredential "<Cloud administrator user name>" -Include AzsScenarios
クラウド管理者のユーザー名は UPN 形式で入力する必要があります: serviceadmin@contoso.onmicrosoft.com (Microsoft Entra ID)。 入力を求められたら、クラウド管理者のアカウントのパスワードを入力します。
グループ
オペレーターの操作性を向上させるため、複数のテスト カテゴリを同時に実行できるように Group パラメーターが有効になっています。 現時点では、 Default、 UpdateReadiness、および SecretRotationReadiness の 3 つのグループが定義されています。
既定値: Test-AzureStack の標準的な実行と見なされます。 他のグループが選択されていない場合、このグループが既定で実行されます。
UpdateReadiness: Azure Stack Hub インスタンスを更新できるかどうかを確認するチェック。 UpdateReadiness グループが実行されると、コンソール出力にエラーとして警告が表示されます。これは更新の妨げと見なします。 次のカテゴリは、UpdateReadiness グループの一部です。
- AzsInfraFileValidation
- AzsActionPlanStatus
- AzsStampBMCSummary
SecretRotationReadiness: Azure Stack Hub インスタンスがシークレット ローテーションを実行できる状態にあるかどうかを確認するチェック。 SecretRotationReadiness グループが実行されると、コンソール出力にエラーとして警告が表示されます。これはシークレット ローテーションの妨げと見なします。 次のカテゴリは、SecretRotationReadiness グループの一部です。
- AzsAcsSummary
- AzsDefenderSummary
- AzsHostingInfraSummary
- AzsInfraCapacity
- AzsInfraRoleSummary
- AzsPortalAPISummary
- AzsSFRoleSummary
- AzsStorageSvcsSummary
- AzsStoreSummary
Group パラメーターの例
次の例では、Group を使用して更新プログラムまたは修正プログラムをインストールする前に、Test-AzureStack を実行してシステムの準備状況をテストします。 更新プログラムまたは修正プログラムのインストールを開始する前に、Test-AzureStack を実行してお使いの Azure Stack Hub の状態を確認します。
Test-AzureStack -Group UpdateReadiness
インフラストラクチャのバックアップ設定をテストするには、検証ツールを実行します。
インフラストラクチャのバックアップを構成する前に、AzsBackupShareAccessibility テストを使用して、バックアップ共有パスと資格情報をテストできます。
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility -BackupSharePath "\\<fileserver>\<fileshare>" -BackupShareCredential $using:backupcred
バックアップを構成した後、PEP セッションの実行から AzsBackupShareAccessibility を実行して、ERCS から共有にアクセスできることを検証できます。
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility
構成済みのバックアップ共有で新しい資格情報をテストするには、以下を実行します。
Enter-PSSession -ComputerName "<ERCS VM-name/IP address>" -ConfigurationName PrivilegedEndpoint -Credential $localcred
Test-AzureStack -Include AzsBackupShareAccessibility -BackupShareCredential "<PSCredential for backup share>"
検証ツールを実行してネットワーク インフラストラクチャをテストする
このテストでは、Azure Stack Hub ソフトウェア定義ネットワーク (SDN) をバイパスするネットワーク インフラストラクチャの接続を確認します。 パブリック VIP から構成済みの DNS フォワーダー、NTP サーバー、および認証エンドポイントへの接続が示されます。 これには、ID プロバイダーとして Microsoft Entra ID を使用する場合は Azure への接続、ID プロバイダーとして AD FS を使用する場合はフェデレーション サーバーへの接続が含まれます。
コマンドの詳細な出力を取得するには、debug パラメーターを含めます。
Test-AzureStack -Include AzsNetworkInfra -Debug
次のステップ
Azure Stack Hub 診断ツールと問題のログ記録の詳細については、Azure Stack Hub の診断ログの収集に関する記事を参照してください。
トラブルシューティングの詳細については、Microsoft Azure Stack Hub でのトラブルシューティングに関する記事を参照してください。