get-support-data

重要

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

コンピューター、クラウド、接続されている Azure Sphere デバイスから診断情報と構成情報を含むログ ファイルを収集して生成します。 これらのログ ファイル内の情報は、問題の分析とトラブルシューティングを行う際に、お客様またはテクニカル サポート チームに役立ちます。 詳細については、「 管理ログ ファイルを参照してください。

必須のパラメーター

パラメーター	型	説明
--行き先	ファイル名	サポート データを保存する.zip ファイルのパスとファイル名を指定します。 相対または絶対パスを指定できます。

省略可能なパラメーター

パラメーター	型	説明
-t、--tenant	String	この操作を実行するテナントを指定します。 選択した既定のテナントをオーバーライドします。 テナント ID またはテナント名を指定できます。

グローバル パラメーター

Azure Sphere CLI では、次のグローバル パラメーターを使用できます。

パラメーター	説明
--debug	ログの詳細度を上げて、すべてのデバッグ ログを表示します。 バグを見つけた場合は、バグ レポートを送信するときに、--debug フラグをオンにして生成した出力を提供してください。
-h, --help	コマンドとその引数に関する CLI 参照情報を出力し、使用可能なサブグループとコマンドを一覧表示します。
--only-show-errors	エラーのみを表示し、警告を抑制します。
-o, --output	出力形式を変更します。 使用可能な出力形式は、json、jsonc (色分けされた JSON)、tsv (タブ区切り値)、テーブル (人間が判読できる ASCII テーブル)、yaml です。 既定では、CLI は table を出力します。 使用可能な出力形式の詳細については、「Azure Sphere CLI コマンドの出力形式を参照してください。
--query	JMESPath クエリ言語を使用して、Azure Sphere Security Services から返される出力をフィルター処理します。 詳細と例については、 JMESPath チュートリアル および azure CLI コマンド出力の Query を参照してください 。
--verbose	操作中に Azure Sphere で作成されたリソースに関する情報とその他の有用な情報を出力します。 完全なデバッグ ログを表示するには --debug を使用します。

Note

Azure Sphere クラシック CLI を使用している場合は、使用可能なオプションの詳細については、 グローバル パラメーター を参照してください。

例

azsphere get-support-data --destination logs.zip
Gathering device data.
Gathering Azure Sphere Security Service data.
Gathering computer setup data.
Created the support log archive at 'logs.zip'.
Note: This archive contains information about your system including the list of Wi-Fi networks the device can see, installation logs, Azure Sphere command-line activity logs, attached USB devices, and Azure Sphere local and cloud configuration.
If you choose to provide this data to Microsoft, please send an email to azsppgsup@microsoft.com and attach the generated archive. All data will be handled according to the Microsoft Privacy Statement: go.microsoft.com/fwlink/?linkid=528096

Note

収集されたデータには、非公開にする情報が含まれている場合があります。 ログ ファイルを共有する前に、テーブルを確認して、いずれかのデータをプライベートにしておく必要があるかどうかを判断します。

次の表に、生成されたファイルの詳細と、 azsphere get-support-data コマンドが収集しようとした情報を示します。

ログ ファイル	説明
AzureSphere_ComputerSetup.log	コンピューターに関連するアクティビティを記録します。 - Azure Sphere の内部構成設定。 - すべてのローカル ネットワーク アダプターの IP アドレス。 - Azure Sphere ネットワーク アダプターのすべての詳細。 - Azure Sphere SLIP サービスの状態。
AzureSphere_Device_nnn.log	接続されているデバイスに関連するアクティビティを記録します。 - デバイスの詳細。 - デバイスにインストールされているイメージの状態。 - デバイスにインストールされているデバイス コンポーネントと機能。 - デバイスに保存された Wi-Fi ネットワーク。 - デバイスの現在のネットワークとインターフェイスの状態。 - デバイスからの Wi-Fi スキャンの結果。 - デバイス上の現在の Wi-Fi セットアップの状態。 - デバイスの製造状態。 - ファイアウォールに設定された規則。
AzureSphere_DeviceLog_nnn.bin	接続されたデバイスの診断データ (接続とデバイスの状態情報を含む) が含まれます。 データを解析して読みやすい形式で表示する Python スクリプトは、 Azure Sphere Samples ギャラリーで入手できます。
AzureSphere_DeviceTechSupportData_nnn.bin	接続されているデバイスの製造状態情報が含まれます。
AzureSphere_SecurityService_nnn.log	Azure Sphere セキュリティ サービスに関する情報を記録します。 - 現在の Azure Sphere テナントを含む現在の構成。 - Azure Sphere テナントの一覧。 - デバイス グループと製品を含むクラウドデプロイ構成。 - クラウドから利用可能な現在のデバイス OS バージョンと現在の OS バージョンを含む、クラウド構成の状態。
ActivityLogs_AzureSphere.txt	実行されるコマンドに関する情報を含むログ ファイル。
InstallerLogs_AzureSphere	過去 7 日間の Azure Sphere インストーラー データを含むログ ファイルを一覧表示します。
InstallerLogs_VisualStudio	過去 7 日間の Visual Studio インストーラー データを含むログ ファイルを一覧表示します。