次の方法で共有

クラウドおよびデプロイに関する問題のトラブルシューティング

  • [アーティクル]

重要

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

クラウドとデプロイに関連する潜在的な問題には、cloud に依存する azsphere コマンドの操作に関する問題とデバイスが更新されない問題の 2 種類があります。

クラウド CLI コマンドのトラブルシューティング

cloud 依存の azsphere コマンドを使用すると、Azure Sphere Security Service はコマンド ライン インターフェイス (CLI) に代わって操作を実行します。 個々のテナント、ユーザー、またはデバイスに関する情報が公開される (それにより情報漏えいのリスクを冒す) ことがないように、Security Service は場合により、一般的なエラー メッセージを返します。このメッセージは、azsphere コマンドによってユーザーに渡されます。

このようなエラーを診断し、解決するため、一般的なトラブルシューティングのヒントを以下にいくつか示します。

Windows (特に個人用 Microsoft アカウント) で断続的なログイン エラーが発生する場合は、login で --use-device-code オプションを使用して、プロンプトの指示に従ってください。

azsphere login --use-device-code

このオプションは、Windows SDK、バージョン 20.04 Update 2 以降でサポートされています。

クラウド依存のコマンドが失敗した場合は、まずコマンド自体をチェックします。

  • 適切なパラメーターを指定しましたか。
  • コマンドにデバイス、デバイス グループ、またはその他の項目の ID が含まれている場合、それは確かに正しい ID ですか。
  • デバイス グループ、製品、または既に存在するその他の項目を作成しようとしていますか。 製品名は、テナント内で一意にする必要があります。 デバイス グループ名は、製品内で一意である必要があり、大文字と小文字は区別されません。

次に、ログイン ID とテナントについてチェックします。

  • 有効なログイン ID を使用して Azure Sphere にサインインしていますか。
  • 正しいテナントにアクセスしていますか。
  • ログイン ID を変更しましたか。 各 ID は Azure Sphere に登録されている必要があり、テナント内でロールが割り当てられている必要があります。 たとえば、メール アドレスを変更してログインを変更する場合は、新しい ID を 登録するだけでなく新しい ID にロールが割り当てられていることも確認する必要があります。

デバイスをチェックします。

  • コマンドには、デバイスがコンピューターに接続されている必要があるものがあります。

最後に、テナント内のユーザー ロールにより、操作を実行するアクセス許可が付与されていることを確認します。

  • コマンドが何らかのデータを書き込む場合、ユーザーは共同作成者または管理者である必要があります。 閲覧者はデータを書き込めないため、テナント、デバイス グループ、または製品を作成したり、デバイス機能を追加または削除したり、イメージ パッケージをアップロードしたり、テナントまたはデバイスに格納される情報を変更するその他の操作を実行したりすることはできません。

ユーザー登録エラー

コマンド azsphere register-user を使用しようとすると、このコマンドは非推奨とされているため、エラー メッセージが表示されます。 を使用してユーザーを登録する必要があります。

デバイス更新プログラムをトラブルシューティングする

Over-the-air 更新 は、Azure Sphere セキュリティ モデルの重要な部分です。 OS の更新プログラムと展開の更新プログラムの両方で問題が発生する可能性があります。

OS 更新プログラムのトラブルシューティング

デバイスが OS 更新プログラムを受信するには、デバイスがインターネットに接続されている必要があります。 デバイスで古いバージョンの Azure Sphere OS が実行されているように見える場合は、「ネットワークの問題を解決する」で説明されているように、インターネット接続を確認します。

デバイスが 21.04 より前の OS を実行している場合は、デバイスに読み込まれた ボード構成イメージ も、デバイスが要求されているテナントのクラウド アカウントに読み込む必要があります。

ボード構成をデバイスにサイドローディングすると、初期イーサネット構成が可能になります。 ただし、21.01 より前の OS を実行しているデバイスの場合、そのボード構成イメージが展開に含まれていない場合、デバイスは更新プログラムを実行できませんでした。 これは、この構成により、デバイスからボード構成が削除され、インターネット接続が失われる可能性があるためです。 これがいずれかのデバイスに対して発生した場合は、デバイスが要求されているテナントのクラウド アカウントに元のボード構成イメージをアップロードする必要があります。

展開の更新プログラムのトラブルシューティング

デバイスが 展開 更新プログラムを取得するには、次のすべてに該当する必要があります。

Azure Sphere では、デバイスごとに 1 つのテナントがサポートされます。 つまり、組織は、デバイスに展開されるすべての顧客イメージを制御します。

アプリケーション開発機能を削除すると、実稼働署名されていないサイドロードされたイメージがすべて削除されます。

デバイスの要求に関する問題

デバイスを要求できるのは 1 回だけです。 一度要求されると、デバイスは永久に Azure Sphere テナントに関連付けられます。 デバイスをテナントに要求するときにエラーが報告された場合、次のいずれかが原因である可能性があります。

  • 以前にテナントの作成に使用されていない解放されていないデバイスを使用していることを確認。
  • 選択した Azure Sphere テナントで azsphere device claim コマンドを実行するための適切なアクセス許可があることを確認します。
  • 製造中に Azure Sphere デバイスが登録されなかったまれな場合は、Microsoft の担当者に連絡して正しく登録してください。 詳細については、 チップの作成を参照してください。