次の方法で共有


az iot edge devices

Note

このリファレンスは、Azure CLI (バージョン 2.46.0 以降) の azure-iot 拡張機能の一部です。 拡張機能は、az iot edge devices コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

IoT Edge デバイスを管理するコマンド。

コマンド

名前 説明 状態
az iot edge devices create

IoT Hub で複数のエッジ デバイスを作成して構成します。

拡張子 実験用

az iot edge devices create

実験用

このコマンドは試験段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

IoT Hub で複数のエッジ デバイスを作成して構成します。

この操作では、インライン デバイス引数またはエッジ デバイス構成ファイルを YAML または JSON 形式で受け入れます。 インライン コマンド引数 ('--device-auth' など) が優先され、構成ファイルのプロパティが指定されている場合はオーバーライドされます。 この操作を完全に利用する方法の詳細については、サンプル構成ファイル https://aka.ms/aziotcli-edge-devices-config の例とパラメーターの説明を参照してください。

az iot edge devices create [--auth-type {key, login}]
                           [--cfg]
                           [--clean {false, true}]
                           [--dct]
                           [--dea]
                           [--device]
                           [--device-auth {shared_private_key, x509_thumbprint}]
                           [--hub-name]
                           [--login]
                           [--out]
                           [--rc]
                           [--resource-group]
                           [--rk]
                           [--root-pass]
                           [--vis {false, true}]
                           [--yes {false, true}]

対称キー認証を使用してエッジ デバイスをいくつか作成する (既定)

az iot edge devices create -n {hub_name} --device id=device_1 --device id=device_2

インライン引数を使用して、さまざまなエッジ プロパティ構成で自己署名証明書認証を使用して、エッジ デバイスのフラット リストを作成します。

az iot edge devices create -n {hub_name} --device-auth x509_thumbprint --default-edge-agent "mcr.microsoft.com/azureiotedge-agent:1.4"
--device id=device_1 hostname={FQDN}
--device id=device_2 edge_agent={agent_image}
--device id=parent hostname={FQDN} edge_agent={agent_image} container_auth={path_or_json_string}

ハブ上のすべての既存のデバイス ID を削除し、(進行状況バーと視覚化出力を含む) 構成ファイルに基づいて新しいデバイスを作成します。

az iot edge devices create -n {hub_name} --cfg path/to/config_yml_or_json -c -v

カスタム モジュールデプロイを使用して入れ子になったエッジ デバイスのグループを作成します。インライン引数を使用して、それぞれ 1 つの子デバイスを持つ 2 つの親デバイスを含みます。 また、デバイス証明書バンドルの出力パスも指定します。

az iot edge devices create -n {hub_name} --out {device_bundle_path}
--device id=parent_1 deployment=/path/to/parentDeployment_1.json
--device id=child_1 parent=parent_1 deployment=/path/to/child_deployment_1.json
--device id=parent_2 deployment=/path/to/parentDeployment_2.json
--device id=child_2 parent=parent_2 deployment=/path/to/child_deployment_2.json

x509 認証を使用して、既存のルート CA を使用して単純な入れ子になったエッジ デバイス構成を作成し、カスタム デバイス バンドルの出力パスを指定します。

az iot edge devices create -n {hub_name} --out {device_bundle_path}
--root-cert "root_cert.pem" --root-key "root_key.pem" --device-auth x509_thumbprint
--device id=parent1
--device id=child1 parent=parent1

省略可能のパラメーター

--auth-type

操作でポリシー キーを自動的に派生させるか、現在の Azure AD セッションを使用するかを示します。 認証の種類がログインで、リソースホスト名が指定されている場合、リソース参照は必要でない限りスキップされます。を使用して az configure --defaults iothub-data-auth-type=<auth-type-value>既定値を構成できます。

指定可能な値: key, login
規定値: key
--cfg --config --config-file

デバイス構成ファイルへのパス。 サンプル構成ファイル: https://aka.ms/aziotcli-edge-devices-config.

--clean -c

新しいデバイスを作成する前に、ターゲット ハブ内のすべてのデバイスを削除します。

指定可能な値: false, true
規定値: False
--dct --device-config-template

エッジ デバイス構成の基礎として使用する IoT Edge config.toml ファイルへのパス。

--dea --default-agent --default-edge-agent

作成された Edge デバイスの既定のエッジ エージェント (個別に指定されていない場合)。

--device -d

作成するエッジ デバイスのプロパティに対応するスペース区切りのキーと値のペア。 次のキー値がサポートされています。 id (device_id) deployment 、(インライン json またはファイルへのパス) hostname、( parent device_id) edge_agent 、(イメージ URL)、および container_auth (インライン json またはファイルへのパス)。 --device は 1 回以上使用できます。 完全なパラメーター使用法のヘルプ例を確認します。これらのパラメーターは、サンプル構成ファイル内の対応する値も参照します https://aka.ms/aziotcli-edge-devices-config

--device-auth --device-auth-type

デバイスからハブへの承認メカニズム。

指定可能な値: shared_private_key, x509_thumbprint
--hub-name -n

IoT Hub の名前またはホスト名。 --login が指定されていない場合は必須。

--login -l

このコマンドは、アクションを実行する権限を持つエンティティ 接続文字列をサポートします。 "az login" によるセッション ログインを回避するために使用します。 エンティティ接続文字列と名前の両方が指定されている場合、接続文字列が優先されます。 --hub-name が指定されていない場合は必須です。

--out --output-path

出力デバイス構成バンドルへのディレクトリ パス。 この値を指定しない場合、ファイル出力は作成されません。

--rc --root-cert

入れ子になったエッジ デバイス証明書に署名するためのルート公開キー証明書へのパス。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--rk --root-key

入れ子になったエッジ デバイス証明書に署名するためのルート秘密キーへのパス。

--root-pass --rp

ルート キーのパスワード。

--vis --visualize -v

デバイスの視覚化と、さまざまなタスク (デバイスの作成、親の設定、構成の更新など) の進行状況を示します。

指定可能な値: false, true
規定値: False
--yes -y

--clean スイッチを使用して既存のハブ デバイスを削除する場合は、確認を求めないでください。

指定可能な値: false, true
規定値: False
グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
規定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。