Imagen

Administra imágenes de Azure Sphere en disco.

Operación Descripción
Añadir Carga una nueva imagen.
Descargar Descarga una imagen.
Mostrar Muestra información sobre la imagen especificada.

Añadir

Carga una nueva imagen en tu espacio empresarial de Azure Sphere.

Parámetros necesarios

Parámetro Tipo Descripción
--Imagen Cadena Especifica la ruta de acceso a la imagen que se va a cargar.

Parámetros opcionales

Parámetro Tipo Descripción
-t, --tenant GUID o nombre Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. de inquilino o el nombre del inquilino.
--Temporal Booleana Marca el paquete de imagen como temporal. Este parámetro está pensado para usarse durante el proceso de fabricación.
--Fuerza Booleana Fuerza la carga de imágenes con una API beta.
-r, --regional-data-boundary Cadena Límite de datos regionales para esta imagen. Valores permitidos: EU, None. El valor predeterminado es None. Si no se especifica ningún valor, se usará el valor predeterminado. Para obtener más información, consulte Configurar volcados de memoria: consideraciones sobre pivacy
Parámetros globales

Los siguientes parámetros globales están disponibles para la CLI de Azure Sphere:

Parámetro Descripción
--Depuración Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores.
-h, --help Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors Solo muestra errores, suprimiendo las advertencias.
-o, --output Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere.
--Consulta Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos.
--Detallado Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos.

Nota

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.

Ejemplo

azsphere image add --image C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage --temporary
Uploading image from file 'C:\sample\quickstart_steps\QuickStart-AzureSphereBlink1\QuickStart-AzureSphereBlink1\out\ARM-Debug\QuickStart-AzureSphereBlink1.imagepackage':
 --> Image ID:       d788fdd1-28eb-4477-9818-a4734289f2f1
 --> Component ID:   99d419ef-296d-43b0-ade1-809efe3a7aba
 --> Component name: 'QuickStart-AzureSphereBlink1'
Retaining temporary state for uploaded image.
Successfully uploaded image with ID 'd788fdd1-28eb-4477-9818-a4734289f2f1' and name 'QuickStart-AzureSphereBlink1' to component with ID '99d419ef-296d-43b0-ade1-809efe3a7aba'.

Descargar

Descarga una imagen existente de tu inquilino de Azure Sphere.

Parámetros necesarios

Parámetro Tipo Descripción
-i, --image Cadena Especifica el id. de la imagen que se descargará. Ejecute el comando azsphere image add para obtener el id. de imagen.
--Destino Cadena Especifica la ruta de acceso y el nombre de archivo en el que se guardará la imagen. La ruta de acceso del archivo puede ser absoluta o relativa.

Parámetros opcionales

Parámetro Tipo Descripción
-t, --tenant GUID o nombre Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. de inquilino o el nombre del inquilino.
Parámetros globales

Los siguientes parámetros globales están disponibles para la CLI de Azure Sphere:

Parámetro Descripción
--Depuración Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores.
-h, --help Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors Solo muestra errores, suprimiendo las advertencias.
-o, --output Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere.
--Consulta Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos.
--Detallado Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos.

Nota

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.

Ejemplo

azsphere image download --image d788fdd1-28eb-4477-9818-a4734289f2f1 --destination AzureSphereBlink1.image
Getting the image with ID 'd788fdd1-28eb-4477-9818-a4734289f2f1'.
 ---------
 Result
 =========
 Succeeded
 ---------

Mostrar

Muestra los detalles de una imagen existente de tu inquilino de Azure Sphere.

Parámetros necesarios

Parámetro Tipo Descripción
-i, --image GUID Especifica el id. de la imagen para obtener los detalles. Ejecute el comando azsphere image add para obtener el id. de imagen.

Parámetros opcionales

Parámetro Tipo Descripción
-t, --tenant GUID o nombre Especifica el espacio empresarial en el que realizar esta operación. Reemplaza el espacio empresarial seleccionado predeterminado. Puede especificar el id. de inquilino o el nombre del inquilino.
Parámetros globales

Los siguientes parámetros globales están disponibles para la CLI de Azure Sphere:

Parámetro Descripción
--Depuración Aumenta el nivel de detalle del registro para mostrar todos los registros de depuración. Si encuentras un error, proporciona el resultado generado con la --debug marca activada al enviar un informe de errores.
-h, --help Imprime la información de referencia de la CLI sobre los comandos y sus argumentos y enumera los subgrupos y comandos disponibles.
--only-show-errors Solo muestra errores, suprimiendo las advertencias.
-o, --output Cambia el formato de salida. Los formatos de salida disponibles son json, jsonc (JSON colorizado), tsv (valores separados por tabulaciones), tabla (tablas ASCII legibles por el usuario) y yaml. De forma predeterminada, la CLI genera resultados table. Para obtener más información sobre los formatos de salida disponibles, consulte Formato de salida para los comandos de la CLI de Azure Sphere.
--Consulta Usa el lenguaje de consulta JMESPath para filtrar la salida devuelta de Azure Sphere Security Services. Vea tutorial de JMESPath y resultado del comando de la CLI de Query Azure para obtener más información y ejemplos.
--Detallado Imprime información sobre los recursos creados en Azure Sphere durante una operación y otra información útil. Se usa --debug para los registros de depuración completos.

Nota

Si usa la CLI clásica de Azure Sphere, consulte Parámetros globales para obtener más información sobre las opciones disponibles.

Ejemplo

azsphere image show --image d788fdd1-28eb-4477-9818-a4734289f2f1
------------------------------------ ------------------------------------ ---------------------------- ------------- ------------  ---------------------
ImageId                              ComponentId                          Name                         SigningStatus ImageType     RegionalDataBoundary
========================================================================================================================================================
d788fdd1-28eb-4477-9818-a4734289f2f1 99d419ef-296d-43b0-ade1-809efe3a7aba QuickStart-AzureSphereBlink1 Succeeded     Applications  None
------------------------------------ ------------------------------------ ---------------------------- ------------- ------------  ---------------------