Share via

az iot du update

  • Referencia

Nota:

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

Administración de actualizaciones de Device Update.

Comandos

Nombre Description Tipo Estado
az iot du update calculate-hash

Calcule la representación hash base64 de un archivo.

 Extensión GA
az iot du update delete

Elimine una versión de actualización específica.

 Extensión GA
az iot du update file

Actualice las operaciones de archivo.

 Extensión GA
az iot du update file list

Enumere los identificadores de archivo de actualización con respecto al proveedor de actualizaciones, el nombre y la versión.

 Extensión GA
az iot du update file show

Muestre los detalles de un archivo de actualización específico con respecto al proveedor de actualizaciones, el nombre y la versión.

 Extensión GA
az iot du update import

Importe una nueva versión de actualización en la instancia de Device Update.

 Extensión GA
az iot du update init

Utilidad para la inicialización del manifiesto de importación.

 Extensión Vista previa
az iot du update init v5

Inicialice un manifiesto de importación v5 con el estado deseado.

 Extensión Vista previa
az iot du update list

Enumera las actualizaciones que se han importado a la instancia de Device Update.

 Extensión GA
az iot du update show

Mostrar una versión de actualización específica.

 Extensión GA
az iot du update stage

Almacenar provisionalmente una actualización para la importación en una instancia de destino.

 Extensión Vista previa

az iot du update calculate-hash

Calcule la representación hash base64 de un archivo.

az iot du update calculate-hash --file-path
                                [--hash-algo {sha256}]

Ejemplos

Calcule la representación base64 de un resumen sha256 para un archivo de actualización de destino.

az iot du update calculate-hash --file-path /path/to/file

Calcule la representación base64 de un resumen sha256 para varios archivos de actualización de destino.

az iot du update calculate-hash --file-path /path/to/file1 --file-path /path/to/file2 --file-path /path/to/file3

Parámetros requeridos

--file-path -f

Ruta de acceso local al archivo de destino para el cálculo hash. --file-path se puede usar 1 o más veces.

Parámetros opcionales

--hash-algo

Algoritmo criptográfico que se va a usar para el hash.

valores aceptados: sha256
valor predeterminado: sha256
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 update delete

Elimine una versión de actualización específica.

az iot du update delete --account
                        --instance
                        --un
                        --up
                        --update-version
                        [--no-wait]
                        [--resource-group]
                        [--yes {false, true}]

Ejemplos

Elimine una actualización de destino con respecto al proveedor de actualizaciones, el nombre y la versión.

az iot du update delete -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

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

--un --update-name

Nombre de la actualización.

--up --update-provider

Proveedor de actualizaciones.

--update-version --uv

La versión de actualización.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--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 update import

Importe una nueva versión de actualización en la instancia de Device Update.

Este comando admite la --defer funcionalidad. Cuando se usa, el comando almacenará la carga útil del objeto diseñada para enviarse a Azure en una memoria caché local. El siguiente uso de este comando sin --defer combinará la nueva carga de solicitud con los objetos almacenados en caché que los envían juntos.

Tras la operación correcta, se purgará la entrada de caché local correspondiente. Si se produce un error, no se quitará el contenido almacenado en caché. Use az cache comandos para administrar entradas de caché local de forma independiente.

La compatibilidad con aplazamiento está pensada principalmente para las actualizaciones con varios pasos de referencia, de modo que las actualizaciones primarias y secundarias se puedan enviar juntas.

az iot du update import --account
                        --instance
                        --url
                        [--defer]
                        [--file]
                        [--friendly-name]
                        [--hashes]
                        [--no-wait]
                        [--resource-group]
                        [--size]

Ejemplos

Importe una actualización con dos archivos relacionados y sin pasos de referencia, lo que proporciona explícitamente el valor hash de manifiesto y el tamaño del manifiesto en bytes.

az iot du update import -n {account_name} -i {instance_name} --hashes sha256={hash_value} --size {size_in_bytes} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Importe una actualización con dos archivos relacionados y sin pasos de referencia, lo que permite a la CLI calcular el valor hash y el tamaño del manifiesto de importación en bytes.

az iot du update import -n {account_name} -i {instance_name} --url {manifest_location} --file filename={file1_name} url={file1_url} --file filename={file2_name} url={file2_url}

Importe una actualización primaria con dos pasos de referencia de actualización secundaria, donde los tres manifiestos de importación tienen un archivo relacionado. Deje que la CLI calcule el valor hash y el tamaño en bytes para todos. Esta operación se basará en la funcionalidad "--defer".

az iot du update import -n {account_name} -i {instance_name} --url {parent_manifest_location} --file filename={parent_file_name} url={parent_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child1_manifest_location} --file filename={child1_file_name} url={child1_file_url} --defer

az iot du update import -n {account_name} -i {instance_name} --url {child2_manifest_location} --file filename={child2_file_name} url={child2_file_url}

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

--url

Ubicación enrutable desde la que el manifiesto de importación se puede descargar mediante Device Update para IoT Hub. Normalmente, se trata de una dirección URL de blob protegida por SAS de solo lectura con una expiración establecida en al menos 3 horas.

Parámetros opcionales

--defer

Almacena temporalmente el objeto en la memoria caché local en lugar de enviarlo a Azure. Use az cache comandos para ver o borrar.

--file

Pares clave=valor separados por espacios correspondientes a las propiedades del archivo de metadatos del manifiesto. Las claves necesarias incluyen nombre de archivo y dirección URL. --file se puede usar 1 o más veces.

--friendly-name

Nombre descriptivo asociado a la definición de actualización.

--hashes

Pares clave=valor separados por espacios donde se usa el algoritmo hash y el valor es el hash del archivo de manifiesto de importación codificado en base64. Se requiere al menos una entrada sha256. Si no lo proporciona, se calculará a partir de la dirección URL proporcionada.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--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>.

--size

Tamaño de archivo en número de bytes. Si no lo proporciona, se calculará a partir de la dirección URL proporcionada.

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

Enumera las actualizaciones que se han importado a la instancia de Device Update.

Al enumerar los proveedores de actualizaciones, solo se debe proporcionar la marca --by-provider además de los argumentos de búsqueda de instancias comunes. Al enumerar los nombres de actualización, se debe proporcionar el proveedor de actualizaciones. Al enumerar las versiones de actualización, se debe proporcionar el proveedor de actualizaciones y el nombre de actualización.

az iot du update list --account
                      --instance
                      [--by-provider {false, true}]
                      [--filter]
                      [--resource-group]
                      [--search]
                      [--un]
                      [--up]

Ejemplos

Enumera todas las actualizaciones.

az iot du update list -n {account_name} -i {instance_name}

En este caso, enumere todas las actualizaciones que satisfagan los criterios de búsqueda de texto libre, en este caso el proveedor de actualizaciones de Contoso.

az iot du update list -n {account_name} -i {instance_name} --search 'Contoso'

En este caso, enumere todas las actualizaciones que satisfacen un filtro de odata para las actualizaciones no implementables.

az iot du update list -n {account_name} -i {instance_name} --filter 'isDeployable eq false'

Enumerar todos los proveedores de actualizaciones.

az iot du update list -n {account_name} -i {instance_name} --by-provider

Enumere todos los nombres de actualización por proveedor de actualizaciones.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name}

Enumere todas las versiones de actualización por proveedor de actualizaciones y nombre de actualización.

az iot du update list -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name}

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

--by-provider

Marca que indica que el conjunto de resultados debe restringirse a los proveedores de actualizaciones.

valores aceptados: false, true
--filter

Restringe el conjunto de actualizaciones devueltas por valores de propiedad. Se admite al enumerar actualizaciones sin restricciones ni al enumerar por versión.

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

--search

Solicitar actualizaciones que coincidan con una expresión de búsqueda de texto libre. Se admite al enumerar actualizaciones sin restricciones.

--un --update-name

Nombre de la actualización.

--up --update-provider

Proveedor de actualizaciones.

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

Mostrar una versión de actualización específica.

az iot du update show --account
                      --instance
                      --un
                      --up
                      --update-version
                      [--resource-group]

Ejemplos

Mostrar una actualización específica con respecto al proveedor de actualizaciones, el nombre y la versión.

az iot du update show -n {account_name} -i {instance_name} --update-provider {provider_name} --update-name {update_name} --update-version {update_version}

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

--un --update-name

Nombre de la actualización.

--up --update-provider

Proveedor de actualizaciones.

--update-version --uv

La versión de actualización.

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

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

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Almacenar provisionalmente una actualización para la importación en una instancia de destino.

El almacenamiento provisional de una actualización hace referencia a la aceleración de los pasos previos para importar una actualización a una instancia de destino. Para un manifiesto de importación determinado, el proceso determinará los archivos pertinentes, los insertará en un contenedor de almacenamiento deseado, generará URI de SAS y tratará otros pasos de preparación para una importación correcta.

Este comando depende de una organización basada en convención de archivos de actualización. Se espera que todos los archivos de actualización de un manifiesto de destino estén en el mismo directorio en el que reside el manifiesto de importación.

El acceso basado en claves se usa para cargar artefactos de blob y para generar 3 URI de SAS de duración por hora con acceso de lectura.

Si --then-import se proporciona la marca , el comando importará la actualización almacenada provisionalmente. De lo contrario, el resultado de esta operación es un comando de importación que se ejecutará para lograr el mismo resultado más adelante.

Este comando purgará y actualizará cualquier entrada de caché local para la instancia de destino.

az iot du update stage --account
                       --instance
                       --manifest-path
                       --storage-account
                       --storage-container
                       [--friendly-name]
                       [--overwrite {false, true}]
                       [--resource-group]
                       [--storage-subscription]
                       [--then-import {false, true}]

Ejemplos

Almacenar provisionalmente una actualización independiente. Se espera que los archivos de actualización residan en el mismo directorio que el manifiesto. El comando de importación resultante se puede ejecutar más adelante para iniciar la importación de la actualización almacenada provisionalmente antes de la expiración del token de SAS.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json

Almacenar provisionalmente una actualización independiente. Después del almacenamiento provisional, importe la actualización a la instancia con un nombre descriptivo deseado.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/manifest.json --then-import --friendly-name myAptUpdate

Almacenar provisionalmente una actualización de varias referencias. Los archivos de actualización se cargarán en un contenedor de blobs de almacenamiento que resida en una suscripción diferente a la cuenta de actualización.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --storage-subscription {storage_account_subscription} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json

Almacenar provisionalmente una actualización de varias referencias, sobrescribir los blobs existentes si existen. Después del almacenamiento provisional, importe la actualización a la instancia.

az iot du update stage -n {account_name} -i {instance_name} --storage-account {storage_account_name} --storage-container {storage_container_name} --manifest-path /path/to/parent/parent.manifest.json --manifest-path /path/to/leaf1/leaf1.manifest.json --manifest-path /path/to/leaf2/leaf2.manifest.json --then-import --overwrite

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

--manifest-path

Ruta de acceso del archivo local al manifiesto de importación que se debe almacenar provisionalmente. Se puede usar 1 o más veces.

--storage-account

El nombre de la cuenta de almacenamiento deseado para almacenar provisionalmente los artefactos del manifiesto de importación.

--storage-container

El nombre del contenedor de almacenamiento deseado para almacenar provisionalmente los artefactos del manifiesto de importación.

Parámetros opcionales

--friendly-name

Nombre descriptivo asociado a la definición de actualización.

--overwrite

Marca que indica si los blobs existentes deben sobrescribirse si existe un conflicto.

valores aceptados: false, true
valor predeterminado: False
--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>.

--storage-subscription

Suscripción de la cuenta de almacenamiento deseada para almacenar provisionalmente artefactos de manifiesto de importación. Aplicable cuando las cuentas de almacenamiento y actualización de dispositivos están en suscripciones diferentes.

--then-import

Marca que indica si la actualización se debe importar después del almacenamiento provisional.

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.