az iot central device command

リファレンス

注

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

デバイスコマンドを実行します。

コマンド

名前	説明	型	状態
az iot central device command history	デバイスに送信された最新のコマンド要求と応答の詳細を取得します。	拡張	ジョージア州
az iot central device command run	デバイスでコマンドを実行し、関連する応答を表示します。コマンドが実行できるプロパティの更新を監視しません。	拡張	ジョージア州

az iot central device command history

デバイスに送信された最新のコマンド要求と応答の詳細を取得します。

IoT Central からデバイスに送信された最新のコマンド要求と応答を一覧表示します。コマンドの実行の結果としてデバイスプロパティに対してデバイスが実行する更新は、応答に含まれません。

az iot central device command history --app-id
                                      --cn --command-name
                                      --device-id
                                      [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri --central-dns-suffix]
                                      [--co --component-name]
                                      [--interface-id]
                                      [--mn --module-name]
                                      [--token]

例

コマンド応答を表示する

az iot central device command history --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname}

コンポーネントコマンドの応答を表示する

az iot central device command history --app-id {appid} --device-id {deviceid} --component-name {componentname} --command-name {commandname}

モジュールコンポーネントのコマンド応答を表示する

az iot central device command history --app-id {appid} --device-id {deviceid} --module-name {modulename} --component-name {componentname} --command-name {commandname}

必須のパラメーター

--app-id -n

管理する IoT Central アプリのアプリ ID。アプリ ID は、アプリケーションの [バージョン情報] ページのヘルプメニューにあります。

--cn --command-name

デバイステンプレートで指定されているコマンド名。コマンド名は、コマンドの表示名とは異なる場合があります。

--device-id -d

ターゲットデバイスのデバイス ID。デバイス ID を確認するには、[デバイスの詳細] ページの [接続] ボタンをクリックします。

省略可能のパラメーター

--api-version --av

非推奨

引数 'api_version' は非推奨となり、今後のリリースで削除される予定です。

このコマンドパラメーターは非推奨となり、無視されます。今後のリリースでは、最新の GA バージョンの IoT Central API のみをサポートします。API がまだ GA でない場合は、最新のプレビューバージョンを呼び出します。

指定可能な値: 2022-06-30-preview, 2022-07-31

規定値: 2022-07-31

--central-api-uri --central-dns-suffix

アプリケーションに関連付けられている IoT Central DNS サフィックス。

規定値: azureiotcentral.com

--co --component-name

デバイスコンポーネントの名前。

--interface-id -i

デバイステンプレートで指定されたインターフェイス/コンポーネントの名前。これを見つけるには、デバイステンプレートに移動し、対応するデバイス機能の下でインターフェイス/コンポーネント ID を表示します。

--mn --module-name

デバイスモジュールの名前。

--token

Azure CLI に対して認証せずに要求を送信する場合は、要求を認証するための有効なユーザートークンを指定できます。要求の一部としてキーの種類を指定する必要があります。詳細については、https://aka.ms/iotcentraldocsapiを参照してください。

グローバルパラメーター

--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 を使用します。

az iot central device command run

デバイスでコマンドを実行し、関連する応答を表示します。コマンドが実行できるプロパティの更新を監視しません。

--content には、インライン json またはファイルパスを指定できます。

az iot central device command run --app-id
                                  --cn --command-name
                                  --content
                                  --device-id
                                  [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri --central-dns-suffix]
                                  [--co --component-name]
                                  [--interface-id]
                                  [--mn --module-name]
                                  [--token]

例

インラインペイロードを使用してコマンドを実行します。ペイロードは json 文字列の "request" の下にある必要があります

az iot central device command run --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname} --content '{"request": {payload}}'

json ペイロードパスを使用した短い実行コマンド。

az iot central device command run -n {appid} -d {deviceid} -i {interfaceid} --cn {commandname} -k {payload_file_path}

コンポーネントコマンドを実行します。

az iot central device command run -n {appid} -d {deviceid} --co {componentname} --cn {commandname} -k {payload}

モジュールコンポーネントコマンドを実行します。

az iot central device command run -n {appid} -d {deviceid} --mn {modulename} --co {componentname} --cn {commandname} -k {payload}

必須のパラメーター

--app-id -n

管理する IoT Central アプリのアプリ ID。アプリ ID は、アプリケーションの [バージョン情報] ページのヘルプメニューにあります。

--cn --command-name

デバイステンプレートで指定されているコマンド名。コマンド名は、コマンドの表示名とは異なる場合があります。

--content -k

要求の構成。 JSON ファイルまたは未加工の文字列化された JSON へのパスを指定します。 [ファイルパスの例: ./path/to/file.json][文字列化された JSON の例: {'a': 'b'}]。

--device-id -d

ターゲットデバイスのデバイス ID。デバイス ID を確認するには、[デバイスの詳細] ページの [接続] ボタンをクリックします。

省略可能のパラメーター

--api-version --av

非推奨

引数 'api_version' は非推奨となり、今後のリリースで削除される予定です。

指定可能な値: 2022-06-30-preview, 2022-07-31

規定値: 2022-07-31

--central-api-uri --central-dns-suffix

アプリケーションに関連付けられている IoT Central DNS サフィックス。

規定値: azureiotcentral.com

--co --component-name

デバイスコンポーネントの名前。

--interface-id -i

--mn --module-name

デバイスモジュールの名前。

--token

グローバルパラメーター

--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 を使用します。

次の方法で共有

az iot central device command

コマンド

az iot central device command history

例

必須のパラメーター

省略可能のパラメーター

az iot central device command run

例

必須のパラメーター

省略可能のパラメーター

フィードバック