Compartir a través de

az stack-hci-vm image

Note

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

Administrar imágenes con stack-hci-vm.

Comandos

Nombre Description Tipo Estado
az stack-hci-vm image create

Cree una imagen de galería.

 Extension GA
az stack-hci-vm image delete

Elimine una imagen.

 Extension GA
az stack-hci-vm image list

Enumerar todas las imágenes de la galería.

 Extension GA
az stack-hci-vm image show

Obtenga los detalles de una imagen.

 Extension GA
az stack-hci-vm image update

Actualice una imagen.

 Extension GA

az stack-hci-vm image create

Cree una imagen de galería.

az stack-hci-vm image create --custom-location
                             --name
                             --os-type
                             --resource-group
                             [--image-path]
                             [--imagerepo-password]
                             [--imagerepo-username]
                             [--location]
                             [--offer]
                             [--polling-interval]
                             [--publisher]
                             [--sku]
                             [--source-vm]
                             [--storage-path-id]
                             [--tags]
                             [--urn]
                             [--version]

Ejemplos

PutGalleryImage

az stack-hci-vm image create --custom-location "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.ExtendedLocation/customLocations/dogfood-location" --location "West US2" --storage-path-id "/subscriptions/a95612cb-f1fa-4daa-a4fd-272844fa512c/resourceGroups/dogfoodarc/providers/Microsoft.AzureStackHCI/storagecontainers/test-storagepath" --image-path "C:\\test.vhdx" --name "test-gallery-image" --resource-group "test-rg" --os-type "Windows"

Parámetros requeridos

--custom-location

Identificador de la ubicación extendida.

--name

Nombre de la imagen de la galería.

--os-type

Tipo de sistema operativo [Windows, Linux].

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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.

--image-path

Ubicación o ruta de acceso de la imagen a partir de la que se debe crear la imagen de la galería.

--imagerepo-password

Contraseña para acceder al repositorio de imágenes acr.

--imagerepo-username

Nombre de usuario para acceder al repositorio de imágenes acr.

--location -l

Si no se especifica location, se usa la ubicación del grupo de recursos.

--offer

Oferta para la imagen de Marketplace.

Uso: --offer.

--polling-interval

Intervalo de sondeo de ARM para operaciones de larga duración.

--publisher

Publicador para la imagen de Marketplace.

Uso: --publisher.

--sku

Sku para la imagen de Marketplace.

Uso: --sku.

--source-vm

Nombre de la máquina virtual de origen a partir de la que se debe crear la imagen de la galería.

--storage-path-id

Identificador de Azure de la ruta de acceso de almacenamiento que se usa para almacenar las imágenes de la galería.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--urn

URN, en formato "publisher:offer:sku:version". Si se especifica, se pueden omitir otros valores de argumento.

--version

Versión de la imagen de Marketplace. (Esto se omitirá si se pasa --urn).

Uso: --version.

Propiedad Valor
Valor predeterminado: latest
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 stack-hci-vm image delete

Elimine una imagen.

az stack-hci-vm image delete [--ids]
                             [--name]
                             [--polling-interval]
                             [--resource-group]
                             [--subscription]
                             [--yes]

Ejemplos

DeleteGalleryImage

az stack-hci-vm image delete --name "test-gallery-image" --resource-group "test-rg"

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--name

Nombre de la imagen de la galería.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--polling-interval

Intervalo de sondeo de ARM para operaciones de larga duración.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az stack-hci-vm image list

Enumerar todas las imágenes de la galería.

az stack-hci-vm image list [--resource-group]

Ejemplos

ListGalleryImageByResourceGroup

az stack-hci-vm image list --resource-group "test-rg"

ListGalleryImageBySubscription

az stack-hci-vm image 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.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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 stack-hci-vm image show

Obtenga los detalles de una imagen.

az stack-hci-vm image show [--ids]
                           [--name]
                           [--resource-group]
                           [--subscription]

Ejemplos

GetGalleryImage

az stack-hci-vm image show --name "test-gallery-image" --resource-group "test-rg"

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--name

Nombre de la imagen de la galería.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az stack-hci-vm image update

Actualice una imagen.

az stack-hci-vm image update [--ids]
                             [--name]
                             [--polling-interval]
                             [--resource-group]
                             [--subscription]
                             [--tags]

Ejemplos

UpdateGalleryImage

az stack-hci-vm image update --tags additionalProperties="sample" --name "test-gallery-image" --resource-group "test-rg"

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.

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--name

Nombre de la imagen de la galería.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--polling-interval

Intervalo de sondeo de ARM para operaciones de larga duración.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

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.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False