az iot du update init

Vista previa

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

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.name, updateId.version y description. Se admiten las siguientes claves de paso insertadas: handler (por ejemplo: "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

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.

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

Propiedad	Valor
Valores aceptados:	false, true

--no-validation

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

Propiedad	Valor
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 ruta de acceso del archivo local [obligatorio] 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 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

Comentarios

¿Le ha resultado útil esta página?