Compartir a través de

az sphere image

Note

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

Administrar imágenes en el grupo de recursos y el catálogo.

Comandos

Nombre Description Tipo Estado
az sphere image add

Agregue una imagen al catálogo desde el equipo local.

 Extension GA
az sphere image list

Enumere todas las imágenes del grupo de recursos y el catálogo.

 Extension GA
az sphere image show

Muestra los detalles de una imagen existente del catálogo.

 Extension GA

az sphere image add

Agregue una imagen al catálogo desde el equipo local.

az sphere image add --catalog
                    --image-path
                    --resource-group
                    [--regional-data-boundary {EU, None}]

Ejemplos

Agregue una nueva imagen en el grupo de recursos "MyResourceGroup" y el catálogo "MyCatalog".

az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path MyImage.imagepackage

Agregue una nueva imagen en el grupo de recursos "MyResourceGroup", catálogo "MyCatalog" y límite de datos regional "EU".

az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path MyImage.imagepackage --regional-data-boundary EU

Parámetros requeridos

--catalog -c

Catálogo de Azure Sphere en el que se va a realizar esta operación. Especifique el nombre del catálogo de Azure Sphere. Puede configurar el catálogo de Azure Sphere predeterminado mediante az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.

--image-path -img

Ruta de acceso a un archivo de imagen local.

--resource-group -g

Nombre del grupo de recursos de Azure. Puede configurar el grupo predeterminado mediante az config set defaults.group=<name>. Valores de: az group list.

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.

--regional-data-boundary -r

Límite de datos regionales para esta imagen.

Propiedad Valor
Valor predeterminado: None
Valores aceptados: EU, None
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 sphere image list

Enumere todas las imágenes del grupo de recursos y el catálogo.

az sphere image list --catalog
                     --resource-group

Ejemplos

Enumere todas las imágenes de un grupo de recursos y un catálogo.

az sphere image list --resource-group MyResourceGroup --catalog MyCatalog

Parámetros requeridos

--catalog -c

Catálogo de Azure Sphere en el que se va a realizar esta operación. Especifique el nombre del catálogo de Azure Sphere. Puede configurar el catálogo de Azure Sphere predeterminado mediante az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.

--resource-group -g

Nombre del grupo de recursos de Azure. Puede configurar el grupo predeterminado mediante az config set defaults.group=<name>. Valores de: az group list.

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 sphere image show

Muestra los detalles de una imagen existente del catálogo.

az sphere image show --catalog
                     --image
                     --resource-group

Ejemplos

Mostrar detalles de una imagen mediante el grupo de recursos, el nombre del catálogo y el identificador de imagen.

az sphere image show --resource-group MyResourceGroup --catalog MyCatalog --image adb44b96-2642-4643-8c30-5f681f466425

Parámetros requeridos

--catalog -c

Catálogo de Azure Sphere en el que se va a realizar esta operación. Especifique el nombre del catálogo de Azure Sphere. Puede configurar el catálogo de Azure Sphere predeterminado mediante az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.

--image

Id. de imagen.

Propiedad Valor
Valor de: az sphere image list
--resource-group -g

Nombre del grupo de recursos de Azure. Puede configurar el grupo predeterminado mediante az config set defaults.group=<name>. Valores de: az group list.

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