次の方法で共有

Device Update for IoT Hub 構成ファイル

  • [アーティクル]

Device Update エージェントでは、デバイス上の du-config.json ファイルから構成情報を取得します。 エージェントで、これらの値が読み取られ、Device Update サービスに報告されます。

  • AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["manufacturer"]
  • AzureDeviceUpdateCore:4.ClientMetadata:4.deviceProperties["model"]
  • DeviceInformation.manufacturer
  • DeviceInformation.model
  • connectionData
  • connectionType

ファイルの場所

Linux OS を搭載した IoT デバイスに Debian エージェントをインストールする場合は、/etc/adu/du-config.json ファイルを変更して値を更新します。 Yocto ビルド システムの場合は、adu というパーティションまたはディスクで、/adu/du-config.json という名前の json ファイルを作成します。

フィールドの一覧

名前 説明
SchemaVersion 現在の構成ファイル形式のバージョンをマップするスキーマ バージョン。
aduShellTrustedUsers adu-shell プログラムを起動できるユーザーの一覧。 adu-shell は、'root' としてさまざまな更新アクションを実行するブローカー プログラムです。 Device Update の既定のコンテンツ更新ハンドラーは adu-shell を呼び出して、スーパー ユーザー特権を必要とするタスクを実行します。 この特権を必要とするタスクの例としては、apt-get install や特権スクリプトの実行などがあります。
aduc_manufacturer AzureDeviceUpdateCore:4.ClientMetadata:4 インターフェイスによって、更新デプロイをターゲットとするデバイスを分類するために報告されます。
aduc_model AzureDeviceUpdateCore:4.ClientMetadata:4 インターフェイスによって、更新デプロイをターゲットとするデバイスを分類するために報告されます。
connectionType 指定できる値は string または AIS です。 テスト目的でデバイスを IoT Hub に手動で接続する場合、string を使用します。 運用環境のシナリオでは、IoT ID サービスを使用してデバイスを IoT Hub に接続する際は、AIS を使用します。 詳細については、IoT ID サービスの構成についての理解に関する記事を参照してください。
connectionData ConnectionType = "string" の場合は、IoT デバイスのデバイスまたはモジュールの接続文字列をここに追加します。 connectionType = "AIS" の場合は、connectionData を空の文字列 ("connectionData": "") に設定します。
manufacturer Device Update エージェントによって DeviceInformation インターフェイスの一部として報告されます。
model Device Update エージェントによって DeviceInformation インターフェイスの一部として報告されます。

"du-config.json" ファイル コンテンツの例


{
  "schemaVersion": "1.1",
  "aduShellTrustedUsers": [
    "adu",
    "do"
  ],
  "manufacturer": <Place your device info manufacturer here>,
  "model": <Place your device info model here>,
  "agents": [
    {
      "name": <Place your agent name here>,
      "runas": "adu",
      "connectionSource": {
        "connectionType": "string", //or “AIS”
        "connectionData": <Place your Azure IoT device connection string here>
      },
      "manufacturer": <Place your device property manufacturer here>,
      "model": <Place your device property model here>
    }
  ]
}