デバイス情報を表示する
Azure Sphere テナントには何千ものデバイスを含めることができるので、デバイスを管理するには、それぞれの詳細情報を取得する方法が必要です。 CLI コマンドを使用すると、テナント内のデバイス、製品、デバイス グループに関する情報を一覧表示できます。 また、コマンドの標準出力をファイルにリダイレクトして、詳細なレビューを行うこともできます。
CLI コマンドを使用して、診断と構成の情報、エラーに関するデータ、デバイスに影響を与えるその他のイベントをダウンロードすることもできます。
結果のリダイレクトまたはページ分割
Azure Sphere コマンド ライン インターフェイス (CLI) には、テナント内のデバイス、製品、デバイス グループに関する情報を一覧表示する次のコマンドが用意されています。
- azsphere device-group デバイス リスト には、特定のデバイス グループ内のすべてのデバイスが表示されます。
- azsphere device list には、テナント内のすべてのデバイスが表示されます。
- azsphere 製品デバイスの一覧 には、製品内のすべてのデバイスが表示されます。
これらのコマンドは、リダイレクトまたはページ分割できる項目の大きなリストを返すことができます。 このセクションでは、両方の 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
メモ
返されるデータの量によっては、この操作が遅くなる可能性があります。
コマンドの標準出力をファイルにリダイレクトすることもできます。 次の例では、標準出力が output.txt に送信され、標準エラーが logs.txt に送信されます。
azsphere device list --verbose > output.txt 2> logs.txt
Azure Sphere クラシック CLI
これらのコマンドの既定のアクションは、一度にレコードのページを返します。ページ サイズは通常、100 レコードに設定されます。 結果の各ページの下部には、結果の次のページで表示を続行するために任意のキーを押すメッセージがあります。 ページ サイズは、データベース アクティビティや使用可能なネットワーク帯域幅などの要因に基づいて自動的に調整されます。
list コマンドの結果をコンマ区切り値 (CSV) ファイルにリダイレクトして詳細な確認を行うには、パラメーターのパスとファイル名 --output
を指定し、パラメーターを --noninteractive
コマンドに追加します。 パラメーターは --noninteractive
結果から改ページを削除するため、各ページの末尾で手動で続行する必要なく、リスト全体が CSV ファイルにキャプチャされます。
サポートに関する情報を表示する
サポート情報を取得するために使用されるコマンドは、Microsoft サポートを使用するときに 1 つの Azure Sphere デバイスのカスタマー サポート データを収集するか、テナント内のデバイスで実行されているアプリケーションに関連するエラー状態に関するデータを返すかによって異なります。 ほとんどのシナリオでは、 azsphere tenant download-error-report コマンドを使用して、すべてのデバイスでテナントにエラー状態のクエリを実行します。 この方法は、一致するイベントを収集するために、インターネット接続を介したデバイスとの Azure Sphere Security Service 通信に依存します。
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 ファイルのパスとファイル名を指定します。 相対パスまたは絶対パスを指定できます。