az iot du update

Comandos

Nombre	Description	Tipo	Estado
az iot du update calculate-hash	Calcule la representación hash base64 de un archivo.	Extension	GA
az iot du update delete	Elimine una versión de actualización específica.	Extension	GA
az iot du update file	Actualice las operaciones de archivo.	Extension	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.	Extension	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.	Extension	GA
az iot du update import	Importe una nueva versión de actualización en la instancia de Device Update.	Extension	GA
az iot du update init	Utilidad para la inicialización del manifiesto de importación.	Extension	Preview
az iot du update init v5	Inicialice un manifiesto de importación v5 con el estado deseado.	Extension	Preview
az iot du update list	Enumera las actualizaciones que se han importado a la instancia de Device Update.	Extension	GA
az iot du update show	Mostrar una versión de actualización específica.	Extension	GA
az iot du update stage	Almacenar provisionalmente una actualización para la importación en una instancia de destino.	Extension	Preview

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

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.

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 update delete --account
                        --instance
                        --un --update-name
                        --up --update-provider
                        --update-version --uv
                        [--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

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.

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

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.

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 update list --account
                      --instance
                      [--by-provider {false, true}]
                      [--filter]
                      [--resource-group]
                      [--search]
                      [--un --update-name]
                      [--up --update-provider]

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

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.

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 update show --account
                      --instance
                      --un --update-name
                      --up --update-provider
                      --update-version --uv
                      [--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

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.

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

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.

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