az iot du device deployment

コマンド

名前	説明	型	状態
az iot du device deployment cancel	デバイス クラス サブグループのデプロイをキャンセルします。	Extension	GA
az iot du device deployment create	デバイス グループの展開を作成します。 デプロイは、ターゲット グループ内のすべてのデバイス クラス サブグループに対してマルチキャストされます。	Extension	GA
az iot du device deployment delete	デバイス グループまたはデバイス クラス サブグループ別にデプロイを削除します。	Extension	GA
az iot du device deployment list	デバイス グループまたはデバイス クラス サブグループの展開を一覧表示します。	Extension	GA
az iot du device deployment list-devices	デバイス クラス サブグループ展開内のデバイスとその状態を一覧表示します。 失敗したデバイスの一覧を取得するのに役立ちます。	Extension	GA
az iot du device deployment retry	デバイス クラス サブグループのデプロイを再試行します。	Extension	GA
az iot du device deployment show	デバイス グループまたはデバイス クラス サブグループの展開を表示します。これには、展開中、完了済み、または失敗したデバイスの数の詳細を示す状態が含まれます。	Extension	GA

az iot du device deployment cancel --account
                                   --cid --class-id
                                   --deployment-id --did
                                   --gid --group-id
                                   --instance
                                   [--resource-group]

例

ターゲット デバイス クラスサブグループのデプロイをキャンセルします。

az iot du device deployment cancel -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}

必須のパラメーター

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az iot du device deployment create --account
                                   --deployment-id --did
                                   --gid --group-id
                                   --instance
                                   --un --update-name
                                   --up --update-provider
                                   --update-version --uv
                                   [--failed-count --fc]
                                   [--failed-percentage --fp]
                                   [--rbun --rollback-update-name]
                                   [--rbup --rollback-update-provider]
                                   [--rbuv --rollback-update-version]
                                   [--resource-group]
                                   [--start-time]

例

(UTC 時刻に関して) すぐに開始するようにスケジュールされたデバイス グループの展開を作成します。

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version}

必要な iso-8601 準拠の datetime で開始するようにスケジュールされたデバイス グループ展開を作成します。

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --start-time "2022-12-20T01:00:00"

定義されたクラウドによって開始されるロールバック ポリシーを使用して、すぐに開始するようにスケジュールされたデバイス グループのデプロイを作成します。 クラウドのロールバックは、失敗した数または失敗した割合のターゲットが満たされたときに開始されます。

az iot du device deployment create -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --update-name {update_name} --update-provider {update_provider} --update-version {update_version} --failed-count 10 --failed-percentage 5 --rollback-update-name {rollback_update_name} --rollback-update-provider {rollback_update_provider} --rollback-update-version {rollback_update_version}

必須のパラメーター

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az iot du device deployment delete --account
                                   --deployment-id --did
                                   --gid --group-id
                                   --instance
                                   [--cid --class-id]
                                   [--resource-group]
                                   [--yes {false, true}]

例

ターゲット デバイス グループの展開を削除します。

az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id}

ターゲット デバイス クラス サブグループのデプロイを削除します。

az iot du device deployment delete -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}

必須のパラメーター

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az iot du device deployment list --account
                                 --gid --group-id
                                 --instance
                                 [--cid --class-id]
                                 [--order-by]
                                 [--resource-group]

例

デバイス グループの展開を一覧表示します。

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id}

startDateTime の降順で、デバイス グループの順序付け結果の展開を一覧表示します。

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --order-by "startDateTime desc"

デバイス クラス サブグループの展開を一覧表示します。

az iot du device deployment list -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id}

必須のパラメーター

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az iot du device deployment list-devices --account
                                         --cid --class-id
                                         --deployment-id --did
                                         --gid --group-id
                                         --instance
                                         [--filter]
                                         [--resource-group]

例

デバイス クラス サブグループ展開内のデバイスを一覧表示します。

az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}

deviceId と deviceState でフィルター処理するデバイス クラス サブグループ展開内のデバイスを一覧表示します。

az iot du device deployment list-devices -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --filter "deviceId eq 'd0' and deviceState eq 'InProgress'"

必須のパラメーター

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az iot du device deployment retry --account
                                  --cid --class-id
                                  --deployment-id --did
                                  --gid --group-id
                                  --instance
                                  [--resource-group]

例

ターゲット デバイス クラスサブグループのデプロイを再試行します。

az iot du device deployment retry -n {account_name} -i {instance_name} --deployment-id {deployment_id} --group-id {device_group_id} --class-id {device_class_id}

必須のパラメーター

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az iot du device deployment show --account
                                 --deployment-id --did
                                 --gid --group-id
                                 --instance
                                 [--cid --class-id]
                                 [--resource-group]
                                 [--status {false, true}]

例

デバイス グループの展開を表示します。

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id}

デバイス グループの展開の状態を表示します。

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --deployment-id {deployment_id} --status

デバイス クラス サブグループのデプロイを表示します。

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id}

デバイス クラス サブグループ展開の状態を表示します。

az iot du device deployment show -n {account_name} -i {instance_name} --group-id {device_group_id} --class-id {device_class_id} --deployment-id {deployment_id} --status

必須のパラメーター

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

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

--only-show-errors

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

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False