Compartir a través de

az iot du update init

  • Vista previa
  • 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 update init . Obtenga más información sobre las extensiones.

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

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

Comandos

Nombre Description Tipo Estado
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 init v5

Vista previa

El grupo de comandos "iot du update init" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

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

Este comando admite todos los atributos del manifiesto de importación v5. Tenga en cuenta que hay sensibilidad posicional entre --step y --file, así como --file y --related-file. Revise ejemplos y descripciones de parámetros para obtener más información sobre cómo usar completamente la operación.

Obtenga más información sobre el uso de comillas y caracteres de escape en diferentes shells aquí: https://aka.ms/aziotcli-json.

az iot du update init v5 --compat
                         --step
                         --update-name
                         --update-provider
                         --update-version
                         [--description]
                         [--file]
                         [--is-deployable {false, true}]
                         [--no-validation {false, true}]
                         [--related-file]

Ejemplos

Inicialice un manifiesto de importación de contenido mínimo. Json insertado optimizado para "bash".

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{"installedCriteria": "1.0"}' --file path=/my/apt/manifest/file

Inicialice un manifiesto de importación de contenido mínimo. Json insertado optimizado para "powershell".

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties='{\"installedCriteria\": \"1.0\"}' --file path=/my/apt/manifest/file

Inicialice un manifiesto de importación de contenido mínimo. Json insertado optimizado para "cmd".

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="{\"installedCriteria\": \"1.0\"}" --file path=/my/apt/manifest/file

Inicialice un manifiesto de importación de contenido mínimo. Use la entrada de archivo para json.

az iot du update init v5 --update-provider Microsoft --update-name myAptUpdate --update-version 1.0.0 --description "My minimum update" --compat manufacturer=Contoso model=Vacuum --step handler=microsoft/apt:1 properties="@/path/to/file" --file path=/my/apt/manifest/file

Inicialice una actualización hoja no implementable a la que se hará referencia en una actualización agrupada. Json insertado optimizado para "bash".

az iot du update init v5 --update-provider Microsoft --update-name mySwUpdate --update-version 1.1.0 --compat manufacturer=Contoso model=Microphone --step handler=microsoft/swupdate:1 description="Deploy Update" properties='{"installedCriteria": "1.0"}' --file path=/my/update/image/file1 --file path=/my/update/image/file2 --is-deployable false

Inicialice una actualización agrupada que haga referencia a una actualización hoja, así como a definir pasos independientes. Ejemplo optimizado para "Bash" mediante la continuación del comando para delimitar segmentos de manifiesto de importación.

az iot du update init v5 \
--update-provider Microsoft --update-name myBundled --update-version 2.0 \
--compat manufacturer=Contoso model=SpaceStation \
--step handler=microsoft/script:1 properties='{"arguments": "--pre"}' description="Pre-install script" \
--file path=/my/update/scripts/preinstall.sh downloadHandler=microsoft/delta:1 \
--related-file path=/my/update/scripts/related_preinstall.json properties='{"microsoft.sourceFileHashAlgorithm": "sha256"}' \
--step updateId.provider=Microsoft updateId.name=SwUpdate updateId.version=1.1 \
--step handler=microsoft/script:1 properties='{"arguments": "--post"}' description="Post-install script" \
--file path=/my/update/scripts/postinstall.sh

Parámetros requeridos

--compat

Pares clave=valor separados por espacios correspondientes a las propiedades de un dispositivo con el que esta actualización es compatible. Normalmente se usa para definir propiedades como fabricante y modelo. --compat se puede usar 1 o más veces.

--step

Pares clave=valor separados por espacios correspondientes a las propiedades del elemento "instructions.steps". El cliente determinará si un paso es un paso insertado o de referencia en función de los pares de valor de clave proporcionados. Si se puede cumplir el paso de referencia o insertado, se priorizará el paso de referencia. El uso de --file se asociará con la entrada insertada más cercana --step, derivando el valor de "files". Se admiten las siguientes claves de paso de referencia: updateId.provider, updateId.nameupdateId.version y description. Se admiten las siguientes claves de paso insertadas: (por ejemplo: handler 'microsoft/script:1' o 'microsoft/swupdate:1' o 'microsoft/apt:1'), properties (objeto json en línea que el agente pasará al controlador) y description. --step se puede usar 1 o más veces.

--update-name

Nombre de actualización como componente de updateId.

--update-provider

Proveedor de actualizaciones como componente de updateId.

--update-version

La versión de actualización como componente de updateId.

Parámetros opcionales

--description

Descripción del manifiesto de importación.

--file

Pares clave=valor separados por espacios correspondientes a las propiedades del elemento "files". Una entrada --file puede incluir las entradas --related-file más cercanas si se proporcionan. Se admiten las siguientes claves: path [obligatorio] ruta de acceso del archivo local para actualizar el archivo, downloadHandler (por ejemplo: controlador "microsoft/delta:1") para usar archivos relacionados para descargar el archivo de carga, properties (objeto json en línea que el agente pasará al controlador). --file se puede usar 1 o más veces.

--is-deployable

Indica si la actualización se puede implementar de forma independiente.

Valores aceptados: false, true
--no-validation

Deshabilita la validación del esquema json del lado cliente del contenido del manifiesto de importación.

Valores aceptados: false, true
--related-file

Pares clave=valor separados por espacios correspondientes a las propiedades del elemento "files[*].relatedFiles". Una entrada --related-file se asociará a la entrada --file más cercana si existe. Se admiten las siguientes claves: path [obligatorio] ruta de acceso de archivo local al archivo de actualización relacionado ( properties objeto json en línea pasado al controlador de descarga). --related-file se puede usar 1 o más veces.

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.