Compartir a través de

az iot du device group

Note

Esta referencia forma parte de la extensión azure-iot para la CLI de Azure (versión 2.67.0 o posterior). La extensión 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.

 Extension GA
az iot du device group list

Enumera los grupos de dispositivos dentro de una instancia.

 Extension GA
az iot du device group show

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

 Extension 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 --group-id
                              --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}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments
--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}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments
--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.

Propiedad Valor
Valores aceptados: false, true
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments
--instance -i

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

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --group-id
                            --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}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments
--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}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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.

Propiedad Valor
Grupo de parámetros: Update Arguments
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}.

Propiedad Valor
Grupo de parámetros: Account Identifier Arguments
--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.

Propiedad Valor
Grupo de parámetros: Update Arguments
Valores aceptados: false, true
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False