Compartir a través de

Imagen Microsoft.VirtualMachineImagesTemplates 2018-02-01-preview

  • Artículo

Definición de recursos de Bicep

El tipo de recurso imageTemplates se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.VirtualMachineImages/imageTemplates, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    customize: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ]
    distribute: [
      {
        artifactTags: {
          {customized property}: 'string'
        }
        runOutputName: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ]
    source: {
      type: 'string'
      // For remaining properties, see ImageTemplateSource objects
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos ImageTemplateDistributor

Establezca el tipo propiedad para especificar el tipo de objeto.

Para managedImage, use:

{
  imageId: 'string'
  location: 'string'
  type: 'managedImage'
}

Para sharedImage, use:

{
  galleryImageId: 'string'
  replicationRegions: [
    'string'
  ]
  type: 'sharedImage'
}

Objetos ImageTemplateCustomizer

Establezca el tipo propiedad para especificar el tipo de objeto.

Para shell, use:

{
  script: 'string'
  type: 'shell'
}

Objetos ImageTemplateSource

Establezca el tipo propiedad para especificar el tipo de objeto.

Para iso, use:

{
  sha256Checksum: 'string'
  sourceURI: 'string'
  type: 'ISO'
}

Para PlatformImage, use:

{
  offer: 'string'
  publisher: 'string'
  sku: 'string'
  type: 'PlatformImage'
  version: 'string'
}

Valores de propiedad

ImageTemplateCustomizer

Nombre Descripción Valor
nombre Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de personalización cuerda
tipo Establezca en "shell" para el tipo ImageTemplateShellCustomizer. 'shell' (obligatorio)

ImageTemplateDistributor

Nombre Descripción Valor
artifactTags Etiquetas que se aplicarán al artefacto una vez que el distribuidor haya creado o actualizado. ImageTemplateDistributorArtifactTags
runOutputName Nombre que se va a usar para el RunOutput asociado. cuerda

Restricciones:
Patrón = ^[A-Za-z0-9-_]{1,64}$ (obligatorio)
tipo Establezca en "managedImage" para el tipo ImageTemplateManagedImageDistributor. Establezca en "sharedImage" para el tipo ImageTemplateSharedImageDistributor. 'managedImage'
'sharedImage' (obligatorio)

ImageTemplateDistributorArtifactTags

Nombre Descripción Valor

ImageTemplateIsoSource

Nombre Descripción Valor
sha256Checksum Suma de comprobación SHA256 de la imagen ISO. string (obligatorio)
sourceURI Dirección URL para obtener la imagen ISO. Esta dirección URL debe ser accesible para el proveedor de recursos en el momento de la creación de imageTemplate. string (obligatorio)
tipo Especifica el tipo de imagen de origen con el que desea empezar. 'ISO' (obligatorio)

ImageTemplateManagedImageDistributor

Nombre Descripción Valor
imageId Identificador de recurso de la imagen de disco administrado string (obligatorio)
ubicación La ubicación de Azure de la imagen debe coincidir si la imagen ya existe string (obligatorio)
tipo Tipo de distribución. 'managedImage' (obligatorio)

ImageTemplatePlatformImageSource

Nombre Descripción Valor
ofrecer Oferta de imagen de la Imágenes de la Galería de Azure. cuerda
editor Image Publisher en Imágenes de la Galería de Azure. cuerda
Sku SKU de imagen de la Imágenes de la Galería de Azure. cuerda
tipo Especifica el tipo de imagen de origen con el que desea empezar. 'PlatformImage' (obligatorio)
Versión Versión de imagen de la Imágenes de La galería de Azure. cuerda

ImageTemplateProperties

Nombre Descripción Valor
Personalizar Especifica las propiedades usadas para describir los pasos de personalización de la imagen, como el origen de la imagen, etc. ImageTemplateCustomizer []
distribuir Los destinos de distribución a los que debe ir la salida de la imagen. ImageTemplateDistributor[] (obligatorio)
fuente Especifica las propiedades usadas para describir la imagen de origen. ImageTemplateSource (obligatorio)

ImageTemplateSharedImageDistributor

Nombre Descripción Valor
galleryImageId Identificador de recurso de la imagen de Shared Image Gallery string (obligatorio)
replicationRegions string[] (obligatorio)
tipo Tipo de distribución. 'sharedImage' (obligatorio)

ImageTemplateShellCustomizer

Nombre Descripción Valor
Guión Script de shell que se va a ejecutar para personalizar. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. cuerda
tipo Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "shell" puede ser shellCustomizer. 'shell' (obligatorio)

ImageTemplateSource

Nombre Descripción Valor
tipo Establezca en "ISO" para el tipo ImageTemplateIsoSource. Establezca en "PlatformImage" para el tipo ImageTemplatePlatformImageSource. 'ISO'
'PlatformImage' (obligatorio)

Microsoft.VirtualMachineImages/imageTemplates

Nombre Descripción Valor
ubicación Ubicación del recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^[A-Za-z0-9-_]{1,64}$ (obligatorio)
Propiedades ImageTemplateProperties
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

ResourceTags

Nombre Descripción Valor

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.

Archivo de Bicep Descripción
Azure Image Builder con azure Windows Baseline Crea un entorno de Azure Image Builder y crea una imagen de Windows Server con las actualizaciones más recientes de Windows y la línea de base de Windows de Azure aplicadas.
configuración del servicio Dev Box Esta plantilla crearía todos los recursos de administración de Dev Box según la guía de inicio rápido de Dev Box (/azure/dev-box/quickstart-create-dev-box). Puede ver todos los recursos creados o ir directamente a DevPortal.microsoft.com para crear su primer cuadro de desarrollo.

Definición de recursos de plantilla de ARM

El tipo de recurso imageTemplates se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.VirtualMachineImages/imageTemplates, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.VirtualMachineImages/imageTemplates",
  "apiVersion": "2018-02-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "customize": [ {
      "name": "string",
      "type": "string"
      // For remaining properties, see ImageTemplateCustomizer objects
    } ],
    "distribute": [ {
      "artifactTags": {
        "{customized property}": "string"
      },
      "runOutputName": "string",
      "type": "string"
      // For remaining properties, see ImageTemplateDistributor objects
    } ],
    "source": {
      "type": "string"
      // For remaining properties, see ImageTemplateSource objects
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objetos ImageTemplateDistributor

Establezca el tipo propiedad para especificar el tipo de objeto.

Para managedImage, use:

{
  "imageId": "string",
  "location": "string",
  "type": "managedImage"
}

Para sharedImage, use:

{
  "galleryImageId": "string",
  "replicationRegions": [ "string" ],
  "type": "sharedImage"
}

Objetos ImageTemplateCustomizer

Establezca el tipo propiedad para especificar el tipo de objeto.

Para shell, use:

{
  "script": "string",
  "type": "shell"
}

Objetos ImageTemplateSource

Establezca el tipo propiedad para especificar el tipo de objeto.

Para iso, use:

{
  "sha256Checksum": "string",
  "sourceURI": "string",
  "type": "ISO"
}

Para PlatformImage, use:

{
  "offer": "string",
  "publisher": "string",
  "sku": "string",
  "type": "PlatformImage",
  "version": "string"
}

Valores de propiedad

ImageTemplateCustomizer

Nombre Descripción Valor
nombre Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de personalización cuerda
tipo Establezca en "shell" para el tipo ImageTemplateShellCustomizer. 'shell' (obligatorio)

ImageTemplateDistributor

Nombre Descripción Valor
artifactTags Etiquetas que se aplicarán al artefacto una vez que el distribuidor haya creado o actualizado. ImageTemplateDistributorArtifactTags
runOutputName Nombre que se va a usar para el RunOutput asociado. cuerda

Restricciones:
Patrón = ^[A-Za-z0-9-_]{1,64}$ (obligatorio)
tipo Establezca en "managedImage" para el tipo ImageTemplateManagedImageDistributor. Establezca en "sharedImage" para el tipo ImageTemplateSharedImageDistributor. 'managedImage'
'sharedImage' (obligatorio)

ImageTemplateDistributorArtifactTags

Nombre Descripción Valor

ImageTemplateIsoSource

Nombre Descripción Valor
sha256Checksum Suma de comprobación SHA256 de la imagen ISO. string (obligatorio)
sourceURI Dirección URL para obtener la imagen ISO. Esta dirección URL debe ser accesible para el proveedor de recursos en el momento de la creación de imageTemplate. string (obligatorio)
tipo Especifica el tipo de imagen de origen con el que desea empezar. 'ISO' (obligatorio)

ImageTemplateManagedImageDistributor

Nombre Descripción Valor
imageId Identificador de recurso de la imagen de disco administrado string (obligatorio)
ubicación La ubicación de Azure de la imagen debe coincidir si la imagen ya existe string (obligatorio)
tipo Tipo de distribución. 'managedImage' (obligatorio)

ImageTemplatePlatformImageSource

Nombre Descripción Valor
ofrecer Oferta de imagen de la Imágenes de la Galería de Azure. cuerda
editor Image Publisher en Imágenes de la Galería de Azure. cuerda
Sku SKU de imagen de la Imágenes de la Galería de Azure. cuerda
tipo Especifica el tipo de imagen de origen con el que desea empezar. 'PlatformImage' (obligatorio)
Versión Versión de imagen de la Imágenes de La galería de Azure. cuerda

ImageTemplateProperties

Nombre Descripción Valor
Personalizar Especifica las propiedades usadas para describir los pasos de personalización de la imagen, como el origen de la imagen, etc. ImageTemplateCustomizer []
distribuir Los destinos de distribución a los que debe ir la salida de la imagen. ImageTemplateDistributor[] (obligatorio)
fuente Especifica las propiedades usadas para describir la imagen de origen. ImageTemplateSource (obligatorio)

ImageTemplateSharedImageDistributor

Nombre Descripción Valor
galleryImageId Identificador de recurso de la imagen de Shared Image Gallery string (obligatorio)
replicationRegions string[] (obligatorio)
tipo Tipo de distribución. 'sharedImage' (obligatorio)

ImageTemplateShellCustomizer

Nombre Descripción Valor
Guión Script de shell que se va a ejecutar para personalizar. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. cuerda
tipo Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "shell" puede ser shellCustomizer. 'shell' (obligatorio)

ImageTemplateSource

Nombre Descripción Valor
tipo Establezca en "ISO" para el tipo ImageTemplateIsoSource. Establezca en "PlatformImage" para el tipo ImageTemplatePlatformImageSource. 'ISO'
'PlatformImage' (obligatorio)

Microsoft.VirtualMachineImages/imageTemplates

Nombre Descripción Valor
apiVersion La versión de api '2018-02-01-preview'
ubicación Ubicación del recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^[A-Za-z0-9-_]{1,64}$ (obligatorio)
Propiedades ImageTemplateProperties
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso 'Microsoft.VirtualMachineImages/imageTemplates'

ResourceTags

Nombre Descripción Valor

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Azure Image Builder con azure Windows Baseline

Implementación en Azure 		Crea un entorno de Azure Image Builder y crea una imagen de Windows Server con las actualizaciones más recientes de Windows y la línea de base de Windows de Azure aplicadas.
configuración del servicio Dev Box

Implementación en Azure 		Esta plantilla crearía todos los recursos de administración de Dev Box según la guía de inicio rápido de Dev Box (/azure/dev-box/quickstart-create-dev-box). Puede ver todos los recursos creados o ir directamente a DevPortal.microsoft.com para crear su primer cuadro de desarrollo.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso imageTemplates se puede implementar con operaciones que tienen como destino:

  • grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.VirtualMachineImages/imageTemplates, agregue el siguiente Terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      customize = [
        {
          name = "string"
          type = "string"
          // For remaining properties, see ImageTemplateCustomizer objects
        }
      ]
      distribute = [
        {
          artifactTags = {
            {customized property} = "string"
          }
          runOutputName = "string"
          type = "string"
          // For remaining properties, see ImageTemplateDistributor objects
        }
      ]
      source = {
        type = "string"
        // For remaining properties, see ImageTemplateSource objects
      }
    }
  })
}

Objetos ImageTemplateDistributor

Establezca el tipo propiedad para especificar el tipo de objeto.

Para managedImage, use:

{
  imageId = "string"
  location = "string"
  type = "managedImage"
}

Para sharedImage, use:

{
  galleryImageId = "string"
  replicationRegions = [
    "string"
  ]
  type = "sharedImage"
}

Objetos ImageTemplateCustomizer

Establezca el tipo propiedad para especificar el tipo de objeto.

Para shell, use:

{
  script = "string"
  type = "shell"
}

Objetos ImageTemplateSource

Establezca el tipo propiedad para especificar el tipo de objeto.

Para iso, use:

{
  sha256Checksum = "string"
  sourceURI = "string"
  type = "ISO"
}

Para PlatformImage, use:

{
  offer = "string"
  publisher = "string"
  sku = "string"
  type = "PlatformImage"
  version = "string"
}

Valores de propiedad

ImageTemplateCustomizer

Nombre Descripción Valor
nombre Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de personalización cuerda
tipo Establezca en "shell" para el tipo ImageTemplateShellCustomizer. 'shell' (obligatorio)

ImageTemplateDistributor

Nombre Descripción Valor
artifactTags Etiquetas que se aplicarán al artefacto una vez que el distribuidor haya creado o actualizado. ImageTemplateDistributorArtifactTags
runOutputName Nombre que se va a usar para el RunOutput asociado. cuerda

Restricciones:
Patrón = ^[A-Za-z0-9-_]{1,64}$ (obligatorio)
tipo Establezca en "managedImage" para el tipo ImageTemplateManagedImageDistributor. Establezca en "sharedImage" para el tipo ImageTemplateSharedImageDistributor. 'managedImage'
'sharedImage' (obligatorio)

ImageTemplateDistributorArtifactTags

Nombre Descripción Valor

ImageTemplateIsoSource

Nombre Descripción Valor
sha256Checksum Suma de comprobación SHA256 de la imagen ISO. string (obligatorio)
sourceURI Dirección URL para obtener la imagen ISO. Esta dirección URL debe ser accesible para el proveedor de recursos en el momento de la creación de imageTemplate. string (obligatorio)
tipo Especifica el tipo de imagen de origen con el que desea empezar. 'ISO' (obligatorio)

ImageTemplateManagedImageDistributor

Nombre Descripción Valor
imageId Identificador de recurso de la imagen de disco administrado string (obligatorio)
ubicación La ubicación de Azure de la imagen debe coincidir si la imagen ya existe string (obligatorio)
tipo Tipo de distribución. 'managedImage' (obligatorio)

ImageTemplatePlatformImageSource

Nombre Descripción Valor
ofrecer Oferta de imagen de la Imágenes de la Galería de Azure. cuerda
editor Image Publisher en Imágenes de la Galería de Azure. cuerda
Sku SKU de imagen de la Imágenes de la Galería de Azure. cuerda
tipo Especifica el tipo de imagen de origen con el que desea empezar. 'PlatformImage' (obligatorio)
Versión Versión de imagen de la Imágenes de La galería de Azure. cuerda

ImageTemplateProperties

Nombre Descripción Valor
Personalizar Especifica las propiedades usadas para describir los pasos de personalización de la imagen, como el origen de la imagen, etc. ImageTemplateCustomizer []
distribuir Los destinos de distribución a los que debe ir la salida de la imagen. ImageTemplateDistributor[] (obligatorio)
fuente Especifica las propiedades usadas para describir la imagen de origen. ImageTemplateSource (obligatorio)

ImageTemplateSharedImageDistributor

Nombre Descripción Valor
galleryImageId Identificador de recurso de la imagen de Shared Image Gallery string (obligatorio)
replicationRegions string[] (obligatorio)
tipo Tipo de distribución. 'sharedImage' (obligatorio)

ImageTemplateShellCustomizer

Nombre Descripción Valor
Guión Script de shell que se va a ejecutar para personalizar. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. cuerda
tipo Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "shell" puede ser shellCustomizer. 'shell' (obligatorio)

ImageTemplateSource

Nombre Descripción Valor
tipo Establezca en "ISO" para el tipo ImageTemplateIsoSource. Establezca en "PlatformImage" para el tipo ImageTemplatePlatformImageSource. 'ISO'
'PlatformImage' (obligatorio)

Microsoft.VirtualMachineImages/imageTemplates

Nombre Descripción Valor
ubicación Ubicación del recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^[A-Za-z0-9-_]{1,64}$ (obligatorio)
Propiedades ImageTemplateProperties
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview"

ResourceTags

Nombre Descripción Valor