az iot du device group

Nota:

Esta referencia forma parte de la extensión azure-iot para la CLI de Azure (versión 2.46.0 o posterior). La extensión se instalará automáticamente la primera vez que ejecute un comando az iot du device group . Obtenga más información sobre las extensiones.

Administración de grupos de dispositivos.

Un grupo de dispositivos es una colección de dispositivos. Los grupos de dispositivos conforman un buen mecanismo para escalar las implementaciones en numerosos dispositivos. Cada dispositivo pertenece exclusivamente a un grupo. Un grupo de dispositivos se crea automáticamente cuando un dispositivo habilitado para Device Update está conectado al centro e informa de sus propiedades.

Comandos

Nombre	Description	Tipo	Estado
az iot du device group delete	Eliminar un grupo de dispositivos.	Extensión	GA
az iot du device group list	Enumera los grupos de dispositivos dentro de una instancia.	Extensión	GA
az iot du device group show	Mostrar detalles sobre un grupo de dispositivos, incluida la mejor actualización y cumplimiento de actualizaciones.	Extensión	GA

az iot du device group delete

Eliminar un grupo de dispositivos.

Los grupos de dispositivos no se limpian automáticamente, pero se conservan con fines de historial. Esta operación se puede usar si no es necesario que el grupo o necesite conservar el historial para ella. Si un dispositivo se vuelve a conectar para un grupo después de eliminarlo, se volverá a crear automáticamente sin historial.

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

Ejemplos

Eliminar un grupo de dispositivos.

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

Elimine un grupo de dispositivos que omita el mensaje de confirmación.

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

Parámetros requeridos

--account -n

Nombre de la cuenta de Device Update. Puede configurar el nombre de cuenta predeterminado mediante az config set defaults.adu_account=<name>.

--gid --group-id

Identificador del grupo de dispositivos. Esto se crea a partir del valor de la etiqueta ADUGroup en el dispositivo o módulo gemelo de IoT Hub conectado o $default para dispositivos sin etiqueta.

--instance -i

Nombre de instancia de Device Update. Puede configurar el nombre de instancia predeterminado mediante az config set defaults.adu_instance=<name>.

Parámetros opcionales

--resource-group -g

Nombre del grupo de recursos de la cuenta de Device Update. Puede configurar el grupo predeterminado mediante az config set defaults.adu_group=<name>.

--yes -y

Omita las indicaciones del usuario. Indica la aceptación de la acción. Se usa principalmente para escenarios de automatización. Valor predeterminado: false.

Valores aceptados: false, true

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot du device group list

Enumera los grupos de dispositivos dentro de una instancia.

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

Ejemplos

Enumera los grupos de dispositivos.

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

Enumera los grupos de dispositivos en un orden deseado, en este caso por deviceCount.

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

Parámetros requeridos

--account -n

Nombre de la cuenta de Device Update. Puede configurar el nombre de cuenta predeterminado mediante az config set defaults.adu_account=<name>.

--instance -i

Nombre de instancia de Device Update. Puede configurar el nombre de instancia predeterminado mediante az config set defaults.adu_instance=<name>.

Parámetros opcionales

--order-by

Ordena el conjunto de grupos devueltos. Puede ordenar por groupId, deviceCount, createdDateTime, subgroupsWithNewUpdatesAvailableCount, subgruposWithUpdatesWithUpdatesInProgressCount o subgruposWithOnLatestUpdateCount.

--resource-group -g

Nombre del grupo de recursos de la cuenta de Device Update. Puede configurar el grupo predeterminado mediante az config set defaults.adu_group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az iot du device group show

Mostrar detalles sobre un grupo de dispositivos, incluida la mejor actualización y cumplimiento de actualizaciones.

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

Ejemplos

Mostrar un grupo de dispositivos.

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

Mostrar las mejores actualizaciones disponibles para un grupo de dispositivos. Esta marca modifica el comando para devolver una lista.

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

Mostrar el cumplimiento de actualizaciones para un grupo de dispositivos.

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

Parámetros requeridos

--account -n

Nombre de la cuenta de Device Update. Puede configurar el nombre de cuenta predeterminado mediante az config set defaults.adu_account=<name>.

--gid --group-id

Identificador del grupo de dispositivos. Esto se crea a partir del valor de la etiqueta ADUGroup en el dispositivo o módulo gemelo de IoT Hub conectado o $default para dispositivos sin etiqueta.

--instance -i

Nombre de instancia de Device Update. Puede configurar el nombre de instancia predeterminado mediante az config set defaults.adu_instance=<name>.

Parámetros opcionales

--best-updates

Marca que indica que el comando debe capturar las mejores actualizaciones disponibles para el grupo de dispositivos, incluido un recuento de cuántos dispositivos necesitan cada actualización. Una mejor actualización es la actualización más reciente que cumple todas las especificaciones de compatibilidad de una clase de dispositivo.

Valores aceptados: false, true

--resource-group -g

Nombre del grupo de recursos de la cuenta de Device Update. Puede configurar el grupo predeterminado mediante az config set defaults.adu_group=<name>.

--update-compliance

Marca que indica que el comando debe capturar información de cumplimiento de actualizaciones del grupo de dispositivos, como cuántos dispositivos están en su actualización más reciente, cuántas necesitan nuevas actualizaciones y cuántos están en curso al recibir una nueva actualización.

Valores aceptados: false, true

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.