エージェントチェック機能を使って、Device Update for IoT Hubインスタンスから欠けているデバイスを発見、診断、修正する方法を学びましょう。
前提条件
- IoT Hub の Device Update が有効になっている IoT Hub へのアクセス。
- Device Update用にプロビジョニングされたIoTデバイス(またはシミュレーター)で、互換性のあるプラグ アンド プレイ(PnP)モデルIDを報告します。
Note
エージェントチェック機能は、Device Update agentがインストールされており、IoT Hub対応のPnPモデルIDと一致するデバイスに対してのみ検証チェックを行えます。
- Azure Portal
- Azure CLI
サポートされるブラウザー:
- Microsoft Edge
- グーグルクローム
エージェントチェックがサポートする検証チェック
エージェントチェック機能は現在、上記の前提条件を満たすすべてのデバイスに対して以下の検証チェックを実施しています。
| 検証チェック | Criteria |
|---|---|
| PnP モデル ID | PnPモデルIDは、Device Updateエージェントがデバイスツインに報告する文字列で、デバイス/クラウド通信にどのPnPモデルを使うべきかを記述します。 この文字列は、デバイスアップデートインターフェースをサポートする有効なデジタルツインモデル識別子(DTMI)でなければなりません。 |
| インターフェースID | インターフェースIDは、デバイスアップデートエージェントからデバイスツインに報告される文字列で、デバイス/クラウド通信にどのデバイスアップデートインターフェースバージョンを使うべきかを示します。 この文字列はデバイスアップデートインターフェースをサポートする有効なDTMIでなければなりません。 |
| 互換性プロパティ名 |
CompatPropertyNames はDevice Updateエージェントがデバイスツインに報告するフィールドです。 これは、特定の展開 deviceProperties デバイスとの互換性を決定するためにどのフィールドを使うべきかを記述しています。 このフィールドの値は、カンマ区切られた名前の列でなければなりません。 文字列は少なくとも1つから5つまで名前を含んでいなければなりません。 各名前は32文字未満でなければなりません。 |
| 適合性の性質値 | 互換性プロパティの値は、 compatPropertyNames フィールドで指定され、デバイスアップデートエージェントがデバイスツインに devicePropertiesとして報告するfield:valueペアです。 互換性プロパティ名で定義されたすべての名前は、対応するfield:valueペアを報告しなければなりません。 各ペアの値は64文字に制限されています。 |
| ADUグループ | ADUグループタグは、デバイスのデバイスツインで定義するオプションタグです。 デバイスがどのデバイスグループに属するかを決定します。 指定されている場合、タグ文字列は255文字に制限され、英数字文字と以下の特殊文字のみを含めることができます:「。」"-" "_" "~" |
これらの条件のいずれかに満たないデバイスは、デバイス更新に正しく表示されない可能性があります。 無効な値を修正して指定された条件を満たすことで、デバイスは正しくデバイス更新に表示されるはずです。 デバイスがデバイスアップデート や エージェントチェックに表示されない場合は、デバイス同期を実行する必要があるかもしれません。
エージェントのチェック結果を見る
- Azure Portal
- Azure CLI
エージェントチェックの結果はDevice Updateの診断タブで確認できます。
- Azure Portal で、IoT ハブに移動します。
- ナビゲーションメニューから 「アップデート 」を選択し、 診断タブを選択します 。
- 「 失われたデバイスを探す 」セクションを展開します。
デバイス同期操作を開始する
デバイス同期は、デバイスがIoTハブに登録されているものの、デバイスアップデートやエージェントチェックの結果に表示されていない場合にトリガーされるべきです。
各デバイスアップデートインスタンスに対して、同時に1つのデバイス同期操作しか有効にできません。
- Azure Portal
- Azure CLI
- Azure Portal で、IoT ハブに移動します。
- ナビゲーションメニューから 「アップデート 」を選択し、 診断タブを選択します 。
- 「 デバイス健康状態の表示」セクションを展開します。
- 「 デバイス同期を開始する」を選択します。
次のステップ
デバイスアップデートの診断機能について詳しくは、デバイスアップデート診断機能概要をご覧ください