az iot du device class

  • Referencia

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 instalará automáticamente la primera vez que ejecute un comando az iot du device class . Obtenga más información sobre las extensiones.

Administración de subgrupos de clase de dispositivo y clase de dispositivo.

Una clase de dispositivo describe un conjunto de dispositivos que comparten un conjunto común de atributos entre grupos mientras que un subgrupo de clase de dispositivo es un subconjunto de dispositivos de un grupo que comparte el mismo identificador de clase de dispositivo. Las clases de dispositivo se crean automáticamente cuando los dispositivos habilitados para Device Update están conectados al centro.

Comandos

Nombre Description Tipo Estado
az iot du device class delete

Elimina una clase de dispositivo o un subgrupo de clase de dispositivo.

 Extensión GA
az iot du device class list

Enumerar clases de dispositivo o subgrupos de clase de dispositivo.

 Extensión GA
az iot du device class show

Mostrar detalles sobre una clase de dispositivo o un subgrupo de clase de dispositivo, incluidas las actualizaciones instalables, la mejor actualización y cumplimiento de actualizaciones.

 Extensión GA
az iot du device class update

Actualice una clase de dispositivo.

 Extensión GA

az iot du device class delete

Elimina una clase de dispositivo o un subgrupo de clase de dispositivo.

Las clases de dispositivo se crean automáticamente cuando los dispositivos habilitados para Device Update están conectados al centro, pero no se limpian automáticamente, ya que se hace referencia a ellos mediante subgrupos de clase de dispositivo. Si se eliminan todos los subgrupos de clase de dispositivo de una clase de dispositivo de destino, la propia clase de dispositivo también se puede eliminar para quitar los registros del sistema y dejar de comprobar la compatibilidad de la clase de dispositivo con nuevas actualizaciones. Si un dispositivo se vuelve a conectar alguna vez, se volverá a crear su clase de dispositivo si no existe.

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

Ejemplos

Elimina una clase de dispositivo.

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id}

Elimine una clase de dispositivo y omita el mensaje de confirmación.

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} -y

Elimina un subgrupo de clase de dispositivo.

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

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

--cid --class-id

Identificador de clase de dispositivo. Esto se genera a partir del identificador de modelo y las propiedades de compatibilidad notificadas por el agente de device update en la interfaz PnP de Device Update en IoT Hub. Es un hash SHA1 codificado hexadecimal.

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

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

--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 class list

Enumerar clases de dispositivo o subgrupos de clase de dispositivo.

az iot du device class list --account
                            --instance
                            [--filter]
                            [--gid]
                            [--resource-group]

Ejemplos

Enumerar las clases de dispositivo dentro de una instancia.

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

Enumera las clases de dispositivo de instancia filtradas por nombre descriptivo.

az iot du device class list -n {account_name} -i {instance_name} --filter "friendlyName eq 'my-favorite-class'"

Enumera los subgrupos de clase de dispositivo para el grupo.

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

Enumera los subgrupos de clase de dispositivo para el grupo, filtrados por compatProperties/manufacturer.

az iot du device class list -n {account_name} -i {instance_name} --group-id {device_group_id} --filter "compatProperties/manufacturer eq 'Contoso'"

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

--filter

Si se proporciona con --group-id, admite el filtrado en función de los nombres y valores de las propiedades de compatibilidad de clase de dispositivo. Por ejemplo, "compatProperties/manufacturer eq 'Contoso'". De lo contrario, admite el filtrado por nombre descriptivo de clase.

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

--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 class show

Mostrar detalles sobre una clase de dispositivo o un subgrupo de clase de dispositivo, incluidas las actualizaciones instalables, la mejor actualización y cumplimiento de actualizaciones.

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

Ejemplos

Mostrar una clase de dispositivo.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id}

Mostrar actualizaciones instalables para la clase de dispositivo. Esta marca modifica el comando para devolver una lista.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --installable-updates

Mostrar un subgrupo de clase de dispositivo.

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

Mostrar la mejor actualización disponible para un subgrupo de clase de dispositivo.

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

Mostrar el cumplimiento de actualizaciones para un subgrupo de clase de dispositivo.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --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>.

--cid --class-id

Identificador de clase de dispositivo. Esto se genera a partir del identificador de modelo y las propiedades de compatibilidad notificadas por el agente de device update en la interfaz PnP de Device Update en IoT Hub. Es un hash SHA1 codificado hexadecimal.

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

Marca que indica que el comando debe capturar la mejor actualización disponible para el subgrupo de clase de dispositivo, incluido un recuento de cuántos dispositivos necesitan la actualización. El identificador de grupo es necesario para esta marca. 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
--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.

--installable-updates

Marca que indica que el comando debe capturar actualizaciones instalables para la 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 la información de cumplimiento de la actualización del subgrupo de clase de dispositivo, como el número de dispositivos 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. El identificador de grupo es necesario para esta marca.

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 class update

Actualice una clase de dispositivo.

az iot du device class update --account
                              --cid
                              --instance
                              [--friendly-name]
                              [--resource-group]

Ejemplos

Actualice el nombre descriptivo de la clase de dispositivo.

az iot du device class update -n {account_name} -i {instance_name} --class-id {device_class_id} --friendly-name "EU-region"

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

--cid --class-id

Identificador de clase de dispositivo. Esto se genera a partir del identificador de modelo y las propiedades de compatibilidad notificadas por el agente de device update en la interfaz PnP de Device Update en IoT Hub. Es un hash SHA1 codificado hexadecimal.

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

--friendly-name

Nombre descriptivo de la clase de dispositivo. El nombre descriptivo debe ser de 1 a 100 caracteres y admite valores alfanuméricos, de puntos y guiones.

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