デバイス情報の表示

[アーティクル]
09/27/2024

重要

これは Azure Sphere (レガシ) のドキュメントです。 Azure Sphere (レガシ) は 2027 年 9 月 27 日に再提供されておりユーザーは現時点で Azure Sphere (統合) に移行する必要があります。 TOC の上にある Version セレクターを使用して、Azure Sphere (統合) のドキュメントを表示します。

Azure Sphere テナントには何千ものデバイスを含めることができます。デバイスを管理するには、各デバイスに関する詳細情報を取得する方法が必要です。 CLI コマンドを使用すると、テナント内のデバイス、製品、およびデバイスグループに関する情報を一覧表示できます。また、コマンドの標準出力をファイルにリダイレクトして、詳細なレビューを行うこともできます。

CLI コマンドを使用して、診断と構成の情報、エラーに関するデータ、およびデバイスに影響を与えるその他のイベントをダウンロードすることもできます。

結果のリダイレクトまたは改ページ

Azure Sphere コマンドラインインターフェイス (CLI) には、テナント内のデバイス、製品、およびデバイスグループに関する情報を一覧表示する次のコマンドが用意されています。

azsphere device-group device list は、特定のデバイスグループ内のすべてのデバイスを表示します。
azsphere device list テナント内のすべてのデバイスが表示されます。
azsphere product device list には、製品内のすべてのデバイスが表示されます。

これらのコマンドは、リダイレクトまたはページ分割できる項目の大きなリストを返すことができます。このセクションでは、両方の CLI から出力をリダイレクトまたは改ページするさまざまな方法について説明します。

Azure Sphere CLI

Azure Sphere CLI では、対話型の改ページ位置設定はサポートされていません。ただし、既存の改ページ位置ツールにパイプすることで、画面上の出力を改ページ処理できます。

次に例を示します。

PowerShell (Windows): azsphere device list | Out-Host –Paging
コマンドプロンプト (Windows): azsphere device list | more
Bash シェル (Linux): azsphere device list | less

Note

返されるデータの量によっては、この操作が遅くなる可能性があります。

コマンドの標準出力をファイルにリダイレクトすることもできます。次の例では、標準出力が output.txt に送信され、標準エラーが logs.txt に送信されます。

azsphere device list --verbose > output.txt 2> logs.txt

Azure Sphere クラシック CLI

これらのコマンドの既定の動作では、一度に 1 ページのレコードが返されます。通常、ページサイズは 100 レコードに設定されます。結果の各ページの下部には、任意のキーを押せば結果の次のページを表示できることを示すメッセージが表示されます。ページサイズは、データベースアクティビティや利用可能なネットワーク帯域幅などの要因に基づいて自動的に調整されます。

パラメーターのパスとファイル名を指定し、--noninteractive パラメーターをコマンドに追加することで、リストコマンドの結果を詳細な確認 --outputのためにコンマ区切り値 (CSV) ファイルにリダイレクトできます。 --noninteractive パラメーターは結果から改ページを削除するため、リスト全体が CSV ファイルにキャプチャされるため、各ページの末尾で手動で続行する必要はありません。

サポート情報の表示

サポート情報の取得に使用されるコマンドは、Microsoft サポートを使用するときに 1 つの Azure Sphere デバイスのカスタマーサポートデータを収集するか、テナント内のデバイスで実行されているアプリケーションに関連するエラー状態に関するデータを返すかによって異なります。ほとんどのシナリオでは、azsphere tenant download-error-report コマンドを使用して、すべてのデバイスのエラー状態をテナントにクエリします。この方法は、一致するイベントを収集するためのインターネット接続を介した Azure Sphere セキュリティサービスとデバイスとの通信に依存します。

get-support-data

azsphere get-support-data コマンドは、コンピューター、クラウド、および接続されている Azure Sphere デバイスから診断情報と構成情報を含むログファイルを収集して生成します。これらのログファイル内の情報は、問題の分析とトラブルシューティングを行う際に、お客様またはテクニカルサポートチームに役立ちます。 --destination パラメーターを使用して、サポートデータを保存する.zip ファイルのパスとファイル名を指定します。相対または絶対パスを指定できます。

download-error-report

azsphere tenant download-error-report コマンドは、テナント内のデバイスによって報告されたエラーに関する情報を返します。イベントデータは Azure Sphere Security Service クラウドからプルされ、特定のデバイスへの物理的な接続は必要ありません。このコマンドは現在のテナントのコンテキストで動作し、そのテナント内のすべてのデバイスのエラーレポートを返します。

--destination パラメーターを使用して、サポートデータを保存する.csv ファイルのパスとファイル名を指定します。相対または絶対パスを指定できます。

次の方法で共有