az iot du device group

リファレンス

Note

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

デバイスグループの管理。

デバイスグループは、デバイスのコレクションです。デバイスグループによって、多数のデバイスへ配置をスケーリングする方法が提供されます。各デバイスは、一度に 1 つのデバイスグループにだけ属します。デバイス更新が有効なデバイスがハブに接続され、そのプロパティが報告されると、デバイスグループが自動的に作成されます。

コマンド

名前	説明	型	状態
az iot du device group delete	デバイスグループを削除します。	拡張子	GA
az iot du device group list	インスタンス内のデバイスグループを一覧表示します。	拡張子	GA
az iot du device group show	最適な更新プログラムや更新プログラムのコンプライアンスなど、デバイスグループに関する詳細を表示します。	拡張子	GA

az iot du device group delete

デバイスグループを削除します。

デバイスグループは自動的にクリーンアップされませんが、履歴のために保持されます。この操作は、グループの必要がない場合、またはグループの履歴を保持する必要がない場合に使用できます。グループが削除された後にデバイスがグループに対して再度接続された場合、履歴なしで自動的に再作成されます。

az iot du device group delete --account
                              --gid
                              --instance
                              [--resource-group]
                              [--yes {false, true}]

例

デバイスグループを削除します。

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

確認プロンプトをスキップしてデバイスグループを削除します。

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

必須のパラメーター

--account -n

Device Update アカウント名。を使用して、既定のアカウント名を az config set defaults.adu_account=<name>構成できます。

--gid --group-id

デバイスグループ ID。これは、接続されている IoT Hub のデバイス/モジュールツインの ADUGroup タグの値から作成されるか、タグのないデバイスの$defaultから作成されます。

--instance -i

デバイス更新インスタンス名。を使用して、既定のインスタンス名を az config set defaults.adu_instance=<name>構成できます。

省略可能のパラメーター

--resource-group -g

Device Update アカウントのリソースグループ名。 az config set defaults.adu_group=<name> を使用して、既定のグループを構成できます。

--yes -y

ユーザープロンプトをスキップします。アクションの受け入れを示します。主に自動化シナリオに使用されます。既定値は false です。

指定可能な値: false, true

グローバルパラメーター

--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 du device group list

インスタンス内のデバイスグループを一覧表示します。

az iot du device group list --account
                            --instance
                            [--order-by]
                            [--resource-group]

例

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

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

デバイスグループを目的の順序 (この場合は deviceCount 別) で一覧表示します。

az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCount

必須のパラメーター

--account -n

Device Update アカウント名。を使用して、既定のアカウント名を az config set defaults.adu_account=<name>構成できます。

--instance -i

デバイス更新インスタンス名。を使用して、既定のインスタンス名を az config set defaults.adu_instance=<name>構成できます。

省略可能のパラメーター

--order-by

返されるグループのセットを注文します。 groupId、deviceCount、createdDateTime、サブグループWithNewUpdatesAvailableCount、サブグループWithUpdatesInProgressCount、またはサブグループWithOnLatestUpdateCount で並べ替えることができます。

--resource-group -g

Device Update アカウントのリソースグループ名。 az config set defaults.adu_group=<name> を使用して、既定のグループを構成できます。

グローバルパラメーター

--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 du device group show

最適な更新プログラムや更新プログラムのコンプライアンスなど、デバイスグループに関する詳細を表示します。

az iot du device group show --account
                            --gid
                            --instance
                            [--best-updates {false, true}]
                            [--resource-group]
                            [--update-compliance {false, true}]

例

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

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

デバイスグループで使用可能な最適な更新プログラムを表示します。このフラグは、リストを返すようにコマンドを変更します。

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --best-updates

デバイスグループの更新プログラムのコンプライアンスを表示します。

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --update-compliance

必須のパラメーター

--account -n

Device Update アカウント名。を使用して、既定のアカウント名を az config set defaults.adu_account=<name>構成できます。

--gid --group-id

--instance -i

デバイス更新インスタンス名。を使用して、既定のインスタンス名を az config set defaults.adu_instance=<name>構成できます。

省略可能のパラメーター

--best-updates

各更新プログラムが必要なデバイスの数など、デバイスグループに最適な更新プログラムをフェッチする必要があることを示すフラグ。最適な更新プログラムは、デバイスクラスのすべての互換性仕様を満たす最新の更新プログラムです。

指定可能な値: false, true

--resource-group -g

Device Update アカウントのリソースグループ名。 az config set defaults.adu_group=<name> を使用して、既定のグループを構成できます。

--update-compliance

コマンドがデバイスグループ更新プログラムのコンプライアンス情報をフェッチする必要があることを示すフラグ (最新の更新プログラムのデバイスの数、新しい更新プログラムが必要な数、新しい更新プログラムの受信中の数など)。

指定可能な値: false, true

グローバルパラメーター

--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 du device group

コマンド

az iot du device group delete

例

必須のパラメーター

省略可能のパラメーター

az iot du device group list

例

必須のパラメーター

省略可能のパラメーター

az iot du device group show

例

必須のパラメーター

省略可能のパラメーター

その他のリソース