適用対象: Azure Local 2311.2 以降
この記事では、Azure Local サポート診断ツールをダウンロードして使用するための情報を提供します。 このツールは、データ収集、トラブルシューティング、および一般的な問題の解決を簡略化するための PowerShell コマンドのセットです。
このツールは専門知識の代わりとなるものではありません。 問題が発生した場合は、Microsoft サポートにお問い合わせください。
メリット
Azure Local サポート診断ツールを使用すると、製品に関する専門知識がなくても、簡単なコマンドを使用して問題を特定できます。
このツールは次のことが可能です。
簡単なインストールと更新: PowerShell ギャラリーを使用してネイティブにインストールおよび更新します。追加の要件はありません。
診断チェック: 一般的な問題、インシデント、テレメトリ データに基づく診断チェックを提供します。
自動データ収集: Microsoft サポートに提供する重要なデータを自動的に収集します。
定期的な更新: Azure Local での問題の管理、トラブルシューティング、診断に役立つ新しいチェックと便利なコマンドを使用した更新。
前提条件
PowerShell モジュールを使用する前に、次の手順を実行します。
Azure ローカル マシンへの管理アクセス権を持つアカウントを必ず使用してください。
PSRemoting が Azure ローカル コンピューターで構成されていることを確認します。
Enable-PSRemotingを実行してリモート PowerShell を構成します。 詳細については、 Enable-PSRemoting リファレンス ドキュメントを参照してください。
Azure ローカル サポート診断ツールをインストールまたは更新する
管理者として PowerShell を実行してから、次のコマンドを実行します。
ツールをインストールするには、次のコマンドを実行します。
Install-Module –Name Microsoft.AzureStack.HCI.CSSTools
モジュールが既にインストールされている場合は、次のコマンドレットを使用して更新できます。
Update-Module -Name Microsoft.AzureStack.HCI.CSSTools
注
モジュールをインポートすると、PowerShell ギャラリーから自動的に更新が試行されます。 以下の方法を使用して手動で更新することもできます。
モジュールを削除してインポートすることで、最新のモジュールが現在の実行空間に読み込まれたことを確認します。
Remove-Module -Name Microsoft.AzureStack.HCI.CSSTools
Import-Module -Name Microsoft.AzureStack.HCI.CSSTools
注
Azure Local 内のすべてのマシンが、同じバージョンを使用するように更新されていることを確認します。 既存の PSSession を削除して、正しいモジュール バージョンがリモート実行空間に確実に読み込まれるようにします。
Azure ローカル サポート診断ツールを使用する
このセクションでは、Azure ローカル サポート診断ツールを使用するためのさまざまなコマンドレットについて説明します。
使用可能なコマンドレットを表示する
PowerShell モジュール内で使用可能なコマンドレットの一覧を表示するには、次のコマンドレットを実行します。
Get-Command -Module Microsoft.AzureStack.HCI.CSSTools
診断チェックを実行する
システムに対して診断正常性チェックを実行して、一般的な問題の検出に役立てることができます。 次のコンポーネントが使用できます。
- BaseSystem
- 登録
Invoke-AzsSupportDiagnosticCheck -Component <Component>
サポートのためにデータを収集する
定義済みのコレクション セットのいずれかを使用してデータを収集するには、次のコマンドを実行します。
New-AzsSupportDataBundle –Component <Component>すべてのデータ コレクション セットをチェックするには、パラメーター
CTRL+SPACEの後でComponentを押します。独自のデータセットを収集するには、次のコマンドを実行します。
$ClusterCommands = @(<clusterCommand1>,<clusterCommand2>) $nodeCommands = @(<nodeCommand1>,<nodeCommand2>) $nodeEvents = @(<eventLogName1>,<eventLogName2>) $nodeRegistry = @(<registryPath1>,<registryPath2>) $nodeFolders = @(<folderPath1>,<folderPath2>) New-AzsSupportDataBundle -ClusterCommands $clusterCommands ` -NodeCommands $nodeCommands ` -NodeEvents $nodeEvents ` -NodeRegistry $nodeRegistry ` -NodeFolders $nodeFolders ` -ComputerName @(<computerName1>,<computerName2>)
シナリオ例
Azure Local のトラブルシューティングを行うには、次のコマンドを実行します。
デプロイの問題
デプロイに関する詳細レポート (正常に実行された手順、スキップされた手順、エラーの詳細など) を生成するには、次のコマンドを実行します。
Get-AzsSupportEceDeploymentDetails
更新またはアップグレードに関する問題の場合
Get-AzsSupportEceUpdateDetails
ストレージの問題の場合
Start-AzsSupportStorageDiagnostic
ストレージ関連の問題のトラブルシューティングに関する完全なガイダンスについては、「 Troubleshooting-Storage-With-Support-Diagnostics-Tool」を参照してください。
登録に関する問題の場合
Invoke-AzsSupportDiagnosticCheck -Component Registration
登録の問題の出力例を次に示します。
PS C:\temp> Invoke-AzsSupportDiagnosticCheck -Component Registration
Starting known issue check for Azure Stack HCI: Registration.
Starting Azure Stack HCI base system validation.
Gathering information from all clustered nodes.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Finished collecting diagnostic information.
====[ Validating registration state on node: HCI-N-1 ]====
[Pass] [Azure Stack HCI - General registration state]
Validate that the cluster is registered
Details: Validation successfull
[Fail] [Azure Stack HCI - Azure Connection state]
Validate that the cluster is in a connected state
Details: This Azure Stack HCI node does not seem to be connected to azure. Ensure that this node is in a connected state.
Documentation: https://learn.microsoft.com/azure-stack/hci/deploy/troubleshoot-hci-registration.
[Pass] [Azure Arc Agent - Connection state]
Validate that the azure arc agent is connected
Details: Validation successfull
[Pass] [Azure Arc Agent - Service state]
Validate that all azure arc services are running
Details: Validation successfull
[Pass] [Azure Arc Agent - Heartbeat state]
Validate that the azure arc agent has sent out a heartbeat at least a day ago
Details: Validation successfull
[Pass] [Azure Stack HCI - Arc Agent onboarded]
Validate that all arc agent checks are passed
Details: Validation successfull
[Fail] [Validation summary]
Details: At least one node reported an invalid registration state.
We will collect log information from your envirorment.
Creating local storage container for diagnostic data.
Gathering cluster data ... this might take a while.
Cluster data collection complete.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Waiting for all diagnostic output to be generated and compressed ... this might take a while.
Finished collecting diagnostic information.
Starting copy of items ... this might take a while.
All items copied.
Successfully created archive C:\temp\6c5a4685-6e32-4b68-aeec-05475f8d6c6f\log-collection-RegistrationInformation07-22_06-03-2024.zip. Removing raw data C:\temp\6c5a4685-6e32-4b68-aeec-05475f8d6c6f\container.
Data collection done . Please upload the file to the Microsoft Workspace.
基本の Azure Local システムに関する問題の場合
Invoke-AzsSupportDiagnosticCheck -Component BaseSystem
基本システムの問題の出力例を次に示します。
PS C:\temp> Invoke-AzsSupportDiagnosticCheck -Component BaseSystem
Starting known issue check for Azure Stack HCI: BaseSystem.
Gathering information from all clustered nodes.
We are preparing to collect diagnostic information from your environment
We started the diagnostic data collection! This might take some time.
Starting to validate cluster settings.
[Pass] [Failover Clustering - Cluster validation report contains no errors]
Validate that there are no critical errors in the cluster validation report
Details: Validation successfull
[Pass] [Failover Clustering - Cluster Networks have redundancy]
Validate that we have redundancy in clustered networks
Details: Validation successfull
[Pass] [Failover Clustering - Validation Summary]
Validate that there are no critical issues in our cluster validation report.
Details: Validation successfull
Collecting node data.
Finished collecting diagnostic information.
====[ Validating data from node: HCI-N-1 ]====
[Pass] [Windows Features - All windows features installed]
Verify that all features required for Azure Local are installed.
Details: Validation successfull
[Pass] [Validation summary]
Ensure that no other check has returned a failed state
Details: Validation successfull
その後、適切に接続された Azure Local システムに必要なさまざまなコンポーネントの包括的な概要が作成されます。 この概要に基づいて、トラブルシューティングのガイダンスに従うか、Microsoft サポートに連絡してサポートを求めることができます。
データを収集するには、次の 2 つのシナリオ例を参照してください。
自動データ収集の場合
New-AzsSupportDataBundle -Component OS
==== CUT ==================== CUT =======
Data collection done C:\temp\Azs.Support\XXXXXXX\SupportDataBundle-XX-XX_XX-XX-XXXX.zip . Please upload the file to the Microsoft Workspace
手動でのデータ収集の場合
$ClusterCommands = @()
$nodeCommands = @('Get-AzureStackHci','Get-AzureStackHCIArcIntegration','Get-ClusteredScheduledTask | fl *','systeminfo.exe')
$nodeEvents = @('system','application','Microsoft-AzureStack-HCI/Admin')
$nodeRegistry = @('HKLM:\Cluster\ArcForServers')
$nodeFolders = @('C:\Windows\Tasks\ArcforServers\','C:\ProgramData\AzureConnectedMachineAgent\Log\')
New-AzsSupportDataBundle -ClusterCommands $clusterCommands `
-NodeCommands $nodeCommands `
-NodeEvents $nodeEvents `
-NodeRegistry $nodeRegistry `
-NodeFolders $nodeFolders `
-ComputerName (Get-ClusterNode)
==== CUT ==================== CUT =======
Data collection done C:\temp\Azs.Support\XXXXXXX\SupportDataBundle-XX-XX_XX-XX-XXXX.zip . Please upload the file to the Microsoft Workspace.
質問やフィードバック
問題を抱えていませんか? Azure Local サポート診断ツールに関するフィードバックをお寄せください。 お話を聞かせてください。 フィードバックを送信するには、azlocaldiagfeedback@microsoft.com にご連絡ください。
次のステップ
関連情報については、以下も参照してください。