Device Update for IoT Hub では、IoT デバイスのグループに更新プログラムをデプロイできます。
注
ユーザーが作成したグループではなく既定のグループに展開する場合は、「更新プログラムを展開する方法」に直接移動できます。
[前提条件]
- IoT Hub にアクセスするには、Device Update for IoT Hub が有効なを利用します。 IoT Hub には S1 (Standard) レベル以上を使用することをお勧めします。
- IoT Hub 内の Device Update 用にプロビジョニングされた IoT デバイス (またはシミュレーター)。
- プロビジョニングされたデバイスに対して少なくとも 1 つの更新プログラムが正常にインポートされました。
- モジュールまたはデバイス レベル ID として IoT デバイスに Device Update エージェントをインストールして起動する
デバイスにタグを追加する
Device Update for IoT Hub では、IoT デバイスのグループに更新プログラムをデプロイできます。 グループを作成するには、最初の手順として、IoT Hub 内のデバイスのターゲット セットにタグを追加します。 タグは、デバイス更新プログラムに接続された後にのみ、デバイスに正常に追加できます。
次のドキュメントでは、タグを追加および更新する方法について説明します。
プログラムでデバイス ツインを更新する
デバイスを Device Update に登録した後、RegistryManager を使用してデバイス ツインを適切なタグで更新できます。
デバイス更新タグの形式
"tags": {
"ADUGroup": "<CustomTagValue>"
}
ジョブの使用
デバイス更新タグを追加または更新するために、複数のデバイスでジョブをスケジュールすることができます。 例については、「 複数のデバイスでジョブをスケジュールする」を参照してください。 ジョブを使用して、デバイス ツインまたはモジュール ツイン (Device Update エージェントがモジュール ID として設定されている場合) を更新できます。 詳細については、「ジョブのスケジュールとブロードキャスト」を参照してください。
注
このアクションは、IoT Hub メッセージ クォータに対してカウントされます。また、一度に最大 50,000 個のデバイスまたはモジュール ツイン タグのみを変更することをお勧めします。そうしないと、1 日の IoT Hub メッセージ クォータを超えた場合は、より多くの IoT Hub ユニットを購入する必要があります。 詳細については、 クォータと調整に関するページを参照してください。
直接ツイン更新
タグは、デバイス ツインまたはモジュール ツインで直接追加または更新することもできます。
Azure portal にサインインし、IoT Hub に移動します。
ナビゲーション メニューから [デバイス ] を選択し、IoT デバイスを選択してデバイスの詳細を開きます。
ツインの詳細を開きます。
- デバイス更新エージェントがデバイス ID として構成されている場合は、[ デバイス ツイン] を選択します。
- Device Update エージェントがモジュール ID として構成されている場合は、デバイス更新モジュールとモジュール ID ツインを選択します。
デバイス ツインまたはモジュール ツインで、既存の Device Update タグ値を null に設定して削除します。
次に示すように、新しい Device Update タグの値を追加します。 タグを含むデバイス ツイン JSON ドキュメントの例。
"tags": {
"ADUGroup": "<CustomTagValue>"
}
制限事項
- 予約値である 'Uncategorized' を除き、任意の値をタグに追加できます。
- タグ値は 255 文字を超えることはできません。
- タグ値には、英数字と次の特殊文字 ".","-","_","~" を含めることができます。
- タグ名とグループ名では大文字と小文字が区別されます。
- デバイスは ADUGroup という名前のタグを 1 つだけ持つことができます。それ以降、その名前を持つタグを追加すると、タグ名 ADUGroup の既存の値がオーバーライドされます。
- 1 つのデバイスは、1 つのグループにのみ属できます。
既存の IoT Hub タグを選択してデバイス グループを作成する
Azure ポータルにアクセスします。
以前に Device Update インスタンスに接続した IoT Hub を選択します。
左側のナビゲーション バーの [デバイス管理] の [更新] オプションを選択します。
ページの上部にある [グループとデプロイ ] タブを選択します。
[ グループの追加] を選択して新しいグループを作成します。
一覧から IoT Hub タグとデバイス クラスを選択し、[ グループの作成] を選択します。
グループが作成されると、更新プログラムのコンプライアンス チャートとグループの一覧が更新されます。 更新プログラムのコンプライアンス チャートには、コンプライアンスのさまざまな状態のデバイスの数が表示されます。最新の更新プログラム、利用可能な新しい更新プログラム、進行中の更新プログラムです。 更新プログラムのコンプライアンスについて説明します。
新しく作成されたグループと、新しいグループ内のデバイスで利用可能な更新プログラムが表示されます。 グループのデバイス クラス要件を満たしていないデバイスがある場合は、対応する無効なグループに表示されます。 グループの横にある [デプロイ] ボタンをクリックすると、このビューから新しいユーザー定義グループに最適な更新プログラムをデプロイできます。 詳細については、「次のステップ: 更新プログラムをデプロイする」を参照してください。
作成したグループのデバイスの詳細を表示する
新しく作成したグループに移動し、グループ名をクリックします。
グループの一部であるデバイスの一覧が、デバイスの更新プロパティと共に表示されます。 このビューでは、グループのメンバーであるすべてのデバイスの更新プログラムのコンプライアンス情報も表示できます。 更新プログラムのコンプライアンス グラフには、コンプライアンスのさまざまな状態のデバイスの数が表示されます。最新の更新プログラム、利用可能な新しい更新プログラム、および進行中の更新プログラム。
グループ内の各デバイスをクリックして、IoT Hub のデバイスの詳細ページにリダイレクトすることもできます。
