Device Update for IoT Hub のデバイス グループを管理する

サポートされているブラウザー:

• Microsoft Edge
• Google Chrome

Azure CLI 環境:

• Azure Cloud Shell で Bash 環境を使用します。

  

• CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします

  1. az login コマンドを使用して、Azure CLI にサインインします。
  2. az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。
  3. 初回使用時に確認を求められたら、Azure CLI 拡張機能をインストールします。 この記事のコマンドでは、azure-iot 拡張機能を使います。 az extension update --name azure-iot を実行して、最新バージョンの拡張機能を使用していることを確認してください。

1. Azure Portal で、IoT ハブに移動します。

2. 左側のナビゲーション ウィンドウの [デバイス] または [IoT Edge] で、目的の IoT デバイスを見つけます。 Device Update エージェントのプロビジョニングにデバイス ID が使用されているかモジュール ID が使用されているかに応じて、デバイス ツインに移動するか、または Device Update モジュールに移動してから対応するモジュール ツインに移動します。

3. ツインの詳細で、Device Update の既存のタグ値を null に設定することで削除します。

4. 次に示すように、Device Update の新しいタグ値を追加します。

       "tags": {
               "ADUGroup": "<CustomTagValue>"
               }
   

az iot hub device-twin update または az iot hub module-twin update を使用して、デバイス ツインまたはモジュール ツインにタグを追加します。

どちらの update コマンドも、--tags 引数は、JSON コンテンツのファイル パスまたはインライン JSON を受け取ります。

次に例を示します。

az iot hub module-twin update \
    --hub-name <IoT Hub name> \
    --device-id <device name> \
    --module-id <module name> \
    --tags '{"ADUGroup": "<custom_tag_value"}'

1. Azure portal で、以前 Device Update インスタンスに接続した IoT ハブに移動します。

2. 左側のナビゲーション バーの [デバイス管理] にある [更新] オプションを選択します。

3. [グループとデプロイ] タブを選択します。

   

4. グループが作成されると、コンプライアンス チャートとグループの一覧が更新されていることがわかります。 Device Update のコンプライアンス チャートには、さまざまなコンプライアンス対応状態 (最新の更新状態、利用可能な新しい更新プログラムがある、更新プログラムのインストールが進行中) にあるデバイスの数が表示されます。 詳細については、「デバイス更新のコンプライアンス」を参照してください。

   

5. グループの一覧には、既存のグループと、そこに含まれるデバイスに関して利用できる更新プログラムが表示されます。 グループのデバイス クラスの要件を満たしていないデバイスがある場合は、対応する無効なグループに表示されます。 このビューから、グループの横にある [デプロイ] ボタンを選択することで、そのグループに利用できる最適な更新プログラムをデプロイできます。

Device Update インスタンス内のすべてのデバイス グループを表示するには、az iot du device group list を使用します。

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>

--order-by 引数を使用すると、グループ ID、デバイス数、新しい更新プログラムが利用可能なサブグループの数などの観点から、返されるグループを並べ替えることができます。

1. [グループとデプロイ] タブから、表示したいグループの名前を選択します。

2. グループの詳細ページで、グループに含まれるデバイスの一覧、そしてそれらのデバイスの更新プロパティを確認できます。 このビューには、グループのメンバーであるすべてのデバイスについて、更新プログラムのコンプライアンス対応情報も表示されます。 コンプライアンス チャートには、コンプライアンスに関してさまざまな状態にあるデバイスの数が表示されます。

   

3. また、グループ内の個々のデバイスを選択して、IoT ハブ内のデバイスの詳細ページに移動することもできます。

   

   

特定のデバイス グループの詳細を表示するには、az iot du device group show を使用します。

オプションの --best-updates フラグを指定すると、対象のデバイス グループに利用可能な最適な更新プログラムの一覧が返されます。たとえば、各更新プログラムを必要とするデバイスの数が含まれます。

オプションの --update-compliance フラグを指定すると、デバイス グループのコンプライアンス情報が返されます。たとえば、最新の更新プログラムが適用されているデバイスの数、新しい更新プログラムを必要としているデバイスの数、新しい更新プログラムの適用が進行中であるデバイスの数が含まれます。

az iot du device group show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <value of the ADUGroup tag for this group>