Share via

Imagen Microsoft.VirtualMachineImagesTemplates

  • Artículo

Definición de recursos de Bicep

El tipo de recurso imageTemplates se puede implementar en:

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

Formato de los recursos

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

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2022-02-14' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {}
  }
  properties: {
    buildTimeoutInMinutes: int
    customize: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ]
    distribute: [
      {
        artifactTags: {}
        runOutputName: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ]
    source: {
      type: 'string'
      // For remaining properties, see ImageTemplateSource objects
    }
    stagingResourceGroup: 'string'
    validate: {
      continueDistributeOnFailure: bool
      inVMValidations: [
        {
          name: 'string'
          type: 'string'
          // For remaining properties, see ImageTemplateInVMValidator objects
        }
      ]
      sourceValidationOnly: bool
    }
    vmProfile: {
      osDiskSizeGB: int
      userAssignedIdentities: [
        'string'
      ]
      vmSize: 'string'
      vnetConfig: {
        proxyVmSize: 'string'
        subnetId: 'string'
      }
    }
  }
}

Objetos ImageTemplateCustomizer

Establezca la propiedad type para especificar el tipo de objeto.

Para Archivo, use:

  type: 'File'
  destination: 'string'
  sha256Checksum: 'string'
  sourceUri: 'string'

Para PowerShell, use:

  type: 'PowerShell'
  inline: [
    'string'
  ]
  runAsSystem: bool
  runElevated: bool
  scriptUri: 'string'
  sha256Checksum: 'string'
  validExitCodes: [
    int
  ]

Para Shell, use:

  type: 'Shell'
  inline: [
    'string'
  ]
  scriptUri: 'string'
  sha256Checksum: 'string'

Para WindowsRestart, use:

  type: 'WindowsRestart'
  restartCheckCommand: 'string'
  restartCommand: 'string'
  restartTimeout: 'string'

Para WindowsUpdate, use:

  type: 'WindowsUpdate'
  filters: [
    'string'
  ]
  searchCriteria: 'string'
  updateLimit: int

Objetos ImageTemplateDistributor

Establezca la propiedad type para especificar el tipo de objeto.

Para ManagedImage, use:

  type: 'ManagedImage'
  imageId: 'string'
  location: 'string'

Para SharedImage, use:

  type: 'SharedImage'
  excludeFromLatest: bool
  galleryImageId: 'string'
  replicationRegions: [
    'string'
  ]
  storageAccountType: 'string'

Para VHD, use:

  type: 'VHD'

Objetos ImageTemplateSource

Establezca la propiedad type para especificar el tipo de objeto.

Para ManagedImage, use:

  type: 'ManagedImage'
  imageId: 'string'

Para PlatformImage, use:

  type: 'PlatformImage'
  offer: 'string'
  planInfo: {
    planName: 'string'
    planProduct: 'string'
    planPublisher: 'string'
  }
  publisher: 'string'
  sku: 'string'
  version: 'string'

Para SharedImageVersion, use:

  type: 'SharedImageVersion'
  imageVersionId: 'string'

Objetos ImageTemplateInVMValidator

Establezca la propiedad type para especificar el tipo de objeto.

Para PowerShell, use:

  type: 'PowerShell'
  inline: [
    'string'
  ]
  runAsSystem: bool
  runElevated: bool
  scriptUri: 'string'
  sha256Checksum: 'string'
  validExitCodes: [
    int
  ]

Para Shell, use:

  type: 'Shell'
  inline: [
    'string'
  ]
  scriptUri: 'string'
  sha256Checksum: 'string'

Valores de propiedad

imageTemplates

Nombre Descripción Value
name El nombre del recurso string (obligatorio)
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
identidad Identidad de la plantilla de imagen, si está configurada. ImageTemplateIdentity (obligatorio)
properties Propiedades de la plantilla de imagen ImageTemplateProperties

ImageTemplateIdentity

Nombre Descripción Value
type Tipo de identidad que se usa para la plantilla de imagen. El tipo "None" quitará las identidades de la plantilla de imagen. 'Ninguno'
"UserAssigned"
userAssignedIdentities Lista de identidades de usuario asociadas a la plantilla de imagen. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recurso de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. object

ImageTemplateProperties

Nombre Descripción Valor
buildTimeoutInMinutes Duración máxima de espera al compilar la plantilla de imagen (incluye todas las personalizaciones, validaciones y distribuciones). Omita o especifique 0 para usar el valor predeterminado (4 horas). int
Personalización 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)
source Especifica las propiedades usadas para describir la imagen de origen. ImageTemplateSource (obligatorio)
stagingResourceGroup Identificador del grupo de recursos de almacenamiento provisional en la misma suscripción que la plantilla de imagen que se usará para compilar la imagen. Si este campo está vacío, se creará un grupo de recursos con un nombre aleatorio. Si el grupo de recursos especificado en este campo no existe, se creará con el mismo nombre. Si el grupo de recursos especificado existe, debe estar vacío y en la misma región que la plantilla de imagen. El grupo de recursos creado se eliminará durante la eliminación de la plantilla si este campo está vacío o el grupo de recursos especificado no existe, pero si el grupo de recursos especificado existe los recursos creados en el grupo de recursos se eliminarán durante la eliminación de la plantilla y el propio grupo de recursos permanecerá. string
validate Opciones de configuración y lista de validaciones que se van a realizar en la imagen resultante. ImageTemplatePropertiesValidate
vmProfile Describe cómo se configura la máquina virtual para compilar imágenes ImageTemplateVmProfile

ImageTemplateCustomizer

Nombre Descripción Value
name Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de personalización string
type Establecimiento del tipo de objeto Archivo
PowerShell
Shell
WindowsRestart
WindowsUpdate (obligatorio)

ImageTemplateFileCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. 'Archivo' (obligatorio)
destination Ruta de acceso absoluta a un archivo (con estructuras de directorio anidadas ya creadas) donde el archivo (desde sourceUri) se cargará en en la máquina virtual. string
sha256Checksum Suma de comprobación SHA256 del archivo proporcionado en el campo sourceUri anterior string
SourceUri URI del archivo que se va a cargar para personalizar la máquina virtual. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. string

ImageTemplatePowerShellCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. 'PowerShell' (obligatorio)
inline Matriz de comandos de PowerShell que se van a ejecutar string[]
runAsSystem Si se especifica, el script de PowerShell se ejecutará con privilegios elevados mediante el usuario del sistema local. Solo puede ser true cuando el campo runElevated anterior está establecido en true. bool
runElevated Si se especifica, el script de PowerShell se ejecutará con privilegios elevados. bool
scriptUri URI del script de PowerShell que se va a ejecutar para personalizar. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. string
sha256Checksum Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior string
validExitCodes Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0] int[]

ImageTemplateShellCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. 'Shell' (obligatorio)
inline Matriz de comandos de shell que se van a ejecutar string[]
scriptUri URI del 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. string
sha256Checksum Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri string

ImageTemplateRestartCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. 'WindowsRestart' (obligatorio)
restartCheckCommand Comando para comprobar si el reinicio se ha realizado correctamente [Valor predeterminado: ''] string
restartCommand Comando para ejecutar el reinicio [Valor predeterminado: 'shutdown /r /f /t 0 /c "packer restart"'] string
restartTimeout Tiempo de espera de reinicio especificado como una cadena de magnitud y unidad, por ejemplo, "5m" (5 minutos) o "2h" (2 horas) [Valor predeterminado: '5m'] string

ImageTemplateWindowsUpdateCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. 'WindowsUpdate' (obligatorio)
filters Matriz de filtros para seleccionar las actualizaciones que se van a aplicar. Omita o especifique una matriz vacía para usar el valor predeterminado (sin filtro). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo. string[]
searchCriteria Criterios para buscar actualizaciones. Omita o especifique una cadena vacía para usar el valor predeterminado (buscar todo). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo. string
updateLimit Número máximo de actualizaciones que se aplicarán a la vez. Omita o especifique 0 para usar el valor predeterminado (1000) int

ImageTemplateDistributor

Nombre Descripción Valor
artifactTags Etiquetas que se aplicarán al artefacto una vez que el distribuidor haya creado o actualizado. object
runOutputName Nombre que se va a usar para el RunOutput asociado. string (obligatorio)
tipo Establecimiento del tipo de objeto ManagedImage
SharedImage
VHD (obligatorio)

ImageTemplateManagedImageDistributor

Nombre Descripción Value
type Tipo de distribución. 'ManagedImage' (obligatorio)
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)

ImageTemplateSharedImageDistributor

Nombre Descripción Value
type Tipo de distribución. 'SharedImage' (obligatorio)
excludeFromLatest Marca que indica si la versión de la imagen creada debe excluirse de la versión más reciente. Omita usar el valor predeterminado (false). bool
galleryImageId Identificador de recurso de la imagen de Shared Image Gallery string (obligatorio)
replicationRegions Lista de regiones en las que se replicará la imagen. string[] (obligatorio)
storageAccountType Tipo de cuenta de almacenamiento que se usará para almacenar la imagen compartida. Omita usar el valor predeterminado (Standard_LRS). 'Standard_LRS'
'Standard_ZRS'

ImageTemplateVhdDistributor

Nombre Descripción Value
type Tipo de distribución. 'VHD' (obligatorio)

ImageTemplateSource

Nombre Descripción Value
type Establecimiento del tipo de objeto ManagedImage
PlatformImage
SharedImageVersion (obligatorio)

ImageTemplateManagedImageSource

Nombre Descripción Value
type Especifica el tipo de imagen de origen con el que desea empezar. 'ManagedImage' (obligatorio)
imageId Identificador de recurso de ARM de la imagen administrada en la suscripción del cliente string (obligatorio)

ImageTemplatePlatformImageSource

Nombre Descripción Value
type Especifica el tipo de imagen de origen con el que desea empezar. 'PlatformImage' (obligatorio)
offer Oferta de imagen de las imágenes de la Galería de Azure. string
planInfo Configuración opcional del plan de compra para la imagen de plataforma. PlatformImagePurchasePlan
publisher Image Publisher en imágenes de la Galería de Azure. string
sku SKU de imagen de las imágenes de la Galería de Azure. string
version Versión de la imagen de las imágenes de la Galería de Azure. Si se especifica "latest" aquí, la versión se evalúa cuando tiene lugar la compilación de la imagen, no cuando se envía la plantilla. string

PlatformImagePurchasePlan

Nombre Descripción Valor
planName Nombre del plan de compra. string (obligatorio)
planProduct Producto del plan de compra. string (obligatorio)
planPublisher Publicador del plan de compra. string (obligatorio)

ImageTemplateSharedImageVersionSource

Nombre Descripción Value
type Especifica el tipo de imagen de origen con el que desea empezar. 'SharedImageVersion' (obligatorio)
imageVersionId Identificador de recurso de ARM de la versión de la imagen en la galería de imágenes compartidas string (obligatorio)

ImageTemplatePropertiesValidate

Nombre Descripción Valor
continueDistributeOnFailure Si se produce un error en la validación y este campo se establece en false, las imágenes de salida no se distribuirán. Este es el comportamiento predeterminado. Si se produce un error en la validación y este campo se establece en true, las imágenes de salida se seguirán distribuyendo. Use esta opción con precaución, ya que puede dar lugar a que se distribuyan imágenes incorrectas para su uso. En cualquier caso (true o false), la ejecución de la imagen de un extremo a otro se notificará como con errores en caso de error de validación. [Nota: Este campo no tiene ningún efecto si la validación se realiza correctamente.] bool
inVMValidations Lista de validaciones que se van a realizar. ImageTemplateInVMValidator[]
sourceValidationOnly Si este campo se establece en true, la imagen especificada en la sección "source" se validará directamente. No se ejecutará ninguna compilación independiente para generar y, a continuación, validar una imagen personalizada. bool

ImageTemplateInVMValidator

Nombre Descripción Value
name Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de validación string
type Establecimiento del tipo de objeto PowerShell
Shell (obligatorio)

ImageTemplatePowerShellValidator

Nombre Descripción Value
type Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser validación del shell. 'PowerShell' (obligatorio)
inline Matriz de comandos de PowerShell que se van a ejecutar string[]
runAsSystem Si se especifica, el script de PowerShell se ejecutará con privilegios elevados mediante el usuario del sistema local. Solo puede ser true cuando el campo runElevated anterior se establece en true. bool
runElevated Si se especifica, el script de PowerShell se ejecutará con privilegios elevados. bool
scriptUri URI del script de PowerShell que se va a ejecutar para la validación. Puede ser un vínculo de GitHub, un URI de Azure Storage, etc. string
sha256Checksum Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior string
validExitCodes Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0] int[]

ImageTemplateShellValidator

Nombre Descripción Value
type Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser validación del shell. 'Shell' (obligatorio)
inline Matriz de comandos de shell que se van a ejecutar string[]
scriptUri URI del script de shell que se va a ejecutar para la validación. Puede ser un vínculo de GitHub, un URI de Azure Storage, etc. string
sha256Checksum Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri string

ImageTemplateVmProfile

Nombre Descripción Valor
osDiskSizeGB Tamaño del disco del sistema operativo en GB. Omita o especifique 0 para usar el tamaño predeterminado del disco del sistema operativo de Azure. int
userAssignedIdentities Matriz opcional de identificadores de recursos de identidades administradas asignadas por el usuario que se van a configurar en la máquina virtual de compilación y la máquina virtual de validación. Esto puede incluir la identidad de la plantilla de imagen. string[]
vmSize Tamaño de la máquina virtual que se usa para compilar, personalizar y capturar imágenes. Omita o especifique una cadena vacía para usar el valor predeterminado (Standard_D1_v2 para imágenes de Gen1 y Standard_D2ds_v4 para imágenes de Gen2). string
vnetConfig Configuración opcional de la red virtual que se va a usar para implementar la máquina virtual de compilación y la máquina virtual de validación en. Omítalo si no es necesario usar ninguna red virtual específica. VirtualNetworkConfig

VirtualNetworkConfig

Nombre Descripción Valor
proxyVmSize Tamaño de la máquina virtual de proxy que se usa para pasar el tráfico a la máquina virtual de compilación y a la máquina virtual de validación. Omita o especifique una cadena vacía para usar el valor predeterminado (Standard_A1_v2). string
subnetId Identificador de recurso de una subred preexistente. string

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 la versión más reciente de Windows Novedades y La línea de base de Windows de Azure aplicada.
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. Puede ver todos los recursos creados o ir directamente a DevPortal.microsoft.com para crear su primer dev Box.

Definición de recursos de plantilla de ARM

El tipo de recurso imageTemplates se puede implementar en:

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

Formato de los recursos

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

{
  "type": "Microsoft.VirtualMachineImages/imageTemplates",
  "apiVersion": "2022-02-14",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {}
  },
  "properties": {
    "buildTimeoutInMinutes": "int",
    "customize": [
      {
        "name": "string",
        "type": "string"
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ],
    "distribute": [
      {
        "artifactTags": {},
        "runOutputName": "string",
        "type": "string"
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ],
    "source": {
      "type": "string"
      // For remaining properties, see ImageTemplateSource objects
    },
    "stagingResourceGroup": "string",
    "validate": {
      "continueDistributeOnFailure": "bool",
      "inVMValidations": [
        {
          "name": "string",
          "type": "string"
          // For remaining properties, see ImageTemplateInVMValidator objects
        }
      ],
      "sourceValidationOnly": "bool"
    },
    "vmProfile": {
      "osDiskSizeGB": "int",
      "userAssignedIdentities": [ "string" ],
      "vmSize": "string",
      "vnetConfig": {
        "proxyVmSize": "string",
        "subnetId": "string"
      }
    }
  }
}

Objetos ImageTemplateCustomizer

Establezca la propiedad type para especificar el tipo de objeto.

Para Archivo, use:

  "type": "File",
  "destination": "string",
  "sha256Checksum": "string",
  "sourceUri": "string"

Para PowerShell, use:

  "type": "PowerShell",
  "inline": [ "string" ],
  "runAsSystem": "bool",
  "runElevated": "bool",
  "scriptUri": "string",
  "sha256Checksum": "string",
  "validExitCodes": [ "int" ]

Para Shell, use:

  "type": "Shell",
  "inline": [ "string" ],
  "scriptUri": "string",
  "sha256Checksum": "string"

Para WindowsRestart, use:

  "type": "WindowsRestart",
  "restartCheckCommand": "string",
  "restartCommand": "string",
  "restartTimeout": "string"

Para WindowsUpdate, use:

  "type": "WindowsUpdate",
  "filters": [ "string" ],
  "searchCriteria": "string",
  "updateLimit": "int"

Objetos ImageTemplateDistributor

Establezca la propiedad type para especificar el tipo de objeto.

Para ManagedImage, use:

  "type": "ManagedImage",
  "imageId": "string",
  "location": "string"

Para SharedImage, use:

  "type": "SharedImage",
  "excludeFromLatest": "bool",
  "galleryImageId": "string",
  "replicationRegions": [ "string" ],
  "storageAccountType": "string"

Para VHD, use:

  "type": "VHD"

Objetos ImageTemplateSource

Establezca la propiedad type para especificar el tipo de objeto.

Para ManagedImage, use:

  "type": "ManagedImage",
  "imageId": "string"

Para PlatformImage, use:

  "type": "PlatformImage",
  "offer": "string",
  "planInfo": {
    "planName": "string",
    "planProduct": "string",
    "planPublisher": "string"
  },
  "publisher": "string",
  "sku": "string",
  "version": "string"

Para SharedImageVersion, use:

  "type": "SharedImageVersion",
  "imageVersionId": "string"

Objetos ImageTemplateInVMValidator

Establezca la propiedad type para especificar el tipo de objeto.

Para PowerShell, use:

  "type": "PowerShell",
  "inline": [ "string" ],
  "runAsSystem": "bool",
  "runElevated": "bool",
  "scriptUri": "string",
  "sha256Checksum": "string",
  "validExitCodes": [ "int" ]

Para Shell, use:

  "type": "Shell",
  "inline": [ "string" ],
  "scriptUri": "string",
  "sha256Checksum": "string"

Valores de propiedad

imageTemplates

Nombre Descripción Value
type Tipo de recurso 'Microsoft.VirtualMachineImages/imageTemplates'
apiVersion La versión de la API de recursos '2022-02-14'
name El nombre del recurso string (obligatorio)
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas.
identidad Identidad de la plantilla de imagen, si está configurada. ImageTemplateIdentity (obligatorio)
properties Propiedades de la plantilla de imagen ImageTemplateProperties

ImageTemplateIdentity

Nombre Descripción Value
type Tipo de identidad que se usa para la plantilla de imagen. El tipo "None" quitará las identidades de la plantilla de imagen. 'Ninguno'
"UserAssigned"
userAssignedIdentities Lista de identidades de usuario asociadas a la plantilla de imagen. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recurso de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. object

ImageTemplateProperties

Nombre Descripción Valor
buildTimeoutInMinutes Duración máxima de espera al compilar la plantilla de imagen (incluye todas las personalizaciones, validaciones y distribuciones). Omita o especifique 0 para usar el valor predeterminado (4 horas). int
Personalización 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)
source Especifica las propiedades usadas para describir la imagen de origen. ImageTemplateSource (obligatorio)
stagingResourceGroup Identificador del grupo de recursos de almacenamiento provisional en la misma suscripción que la plantilla de imagen que se usará para compilar la imagen. Si este campo está vacío, se creará un grupo de recursos con un nombre aleatorio. Si el grupo de recursos especificado en este campo no existe, se creará con el mismo nombre. Si el grupo de recursos especificado existe, debe estar vacío y en la misma región que la plantilla de imagen. El grupo de recursos creado se eliminará durante la eliminación de la plantilla si este campo está vacío o el grupo de recursos especificado no existe, pero si el grupo de recursos especificado existe los recursos creados en el grupo de recursos se eliminarán durante la eliminación de la plantilla y el propio grupo de recursos permanecerá. string
validate Opciones de configuración y lista de validaciones que se van a realizar en la imagen resultante. ImageTemplatePropertiesValidate
vmProfile Describe cómo se configura la máquina virtual para compilar imágenes. ImageTemplateVmProfile

ImageTemplateCustomizer

Nombre Descripción Value
name Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de personalización string
type Establecimiento del tipo de objeto Archivo
PowerShell
Shell
WindowsRestart
WindowsUpdate (obligatorio)

ImageTemplateFileCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. 'File' (obligatorio)
destination Ruta de acceso absoluta a un archivo (con estructuras de directorio anidadas ya creadas) donde el archivo (desde sourceUri) se cargará en en la máquina virtual. string
sha256Checksum Suma de comprobación SHA256 del archivo proporcionado en el campo sourceUri anterior string
SourceUri URI del archivo que se va a cargar para personalizar la máquina virtual. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. string

ImageTemplatePowerShellCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. 'PowerShell' (obligatorio)
inline Matriz de comandos de PowerShell que se van a ejecutar string[]
runAsSystem Si se especifica, el script de PowerShell se ejecutará con privilegios elevados mediante el usuario del sistema local. Solo puede ser true cuando el campo runElevated anterior está establecido en true. bool
runElevated Si se especifica, el script de PowerShell se ejecutará con privilegios elevados. bool
scriptUri URI del script de PowerShell que se va a ejecutar para personalizar. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. string
sha256Checksum Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior string
validExitCodes Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0] int[]

ImageTemplateShellCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. 'Shell' (obligatorio)
inline Matriz de comandos de shell que se van a ejecutar string[]
scriptUri URI del 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. string
sha256Checksum Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri string

ImageTemplateRestartCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. 'WindowsRestart' (obligatorio)
restartCheckCommand Comando para comprobar si el reinicio se ha realizado correctamente [Valor predeterminado: ''] string
restartCommand Comando para ejecutar el reinicio [Valor predeterminado: 'shutdown /r /f /t 0 /c "packer restart"'] string
restartTimeout Tiempo de espera de reinicio especificado como una cadena de magnitud y unidad, por ejemplo, "5m" (5 minutos) o "2h" (2 horas) [Valor predeterminado: '5m'] string

ImageTemplateWindowsUpdateCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. 'WindowsUpdate' (obligatorio)
filters Matriz de filtros para seleccionar las actualizaciones que se van a aplicar. Omita o especifique una matriz vacía para usar el valor predeterminado (sin filtro). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo. string[]
searchCriteria Criterios para buscar actualizaciones. Omita o especifique una cadena vacía para usar el valor predeterminado (buscar todo). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo. string
updateLimit Número máximo de actualizaciones que se aplicarán a la vez. Omita o especifique 0 para usar el valor predeterminado (1000) int

ImageTemplateDistributor

Nombre Descripción Valor
artifactTags Etiquetas que se aplicarán al artefacto una vez que el distribuidor haya creado o actualizado. object
runOutputName Nombre que se va a usar para el RunOutput asociado. string (obligatorio)
tipo Establecimiento del tipo de objeto ManagedImage
SharedImage
VHD (obligatorio)

ImageTemplateManagedImageDistributor

Nombre Descripción Value
type Tipo de distribución. 'ManagedImage' (obligatorio)
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)

ImageTemplateSharedImageDistributor

Nombre Descripción Value
type Tipo de distribución. 'SharedImage' (obligatorio)
excludeFromLatest Marca que indica si la versión de la imagen creada debe excluirse de la versión más reciente. Omita para usar el valor predeterminado (false). bool
galleryImageId Identificador de recurso de la imagen de Shared Image Gallery string (obligatorio)
replicationRegions Lista de regiones en las que se replicará la imagen string[] (obligatorio)
storageAccountType Tipo de cuenta de almacenamiento que se va a usar para almacenar la imagen compartida. Omita usar el valor predeterminado (Standard_LRS). 'Standard_LRS'
'Standard_ZRS'

ImageTemplateVhdDistributor

Nombre Descripción Value
type Tipo de distribución. 'VHD' (obligatorio)

ImageTemplateSource

Nombre Descripción Value
type Establecimiento del tipo de objeto ManagedImage
PlatformImage
SharedImageVersion (obligatorio)

ImageTemplateManagedImageSource

Nombre Descripción Value
type Especifica el tipo de imagen de origen con el que desea empezar. 'ManagedImage' (obligatorio)
imageId Identificador de recurso de ARM de la imagen administrada en la suscripción del cliente string (obligatorio)

ImageTemplatePlatformImageSource

Nombre Descripción Value
type Especifica el tipo de imagen de origen con el que desea empezar. 'PlatformImage' (obligatorio)
offer Oferta de imagen de las imágenes de la Galería de Azure. string
planInfo Configuración opcional del plan de compra para la imagen de plataforma. PlatformImagePurchasePlan
publisher Image Publisher en imágenes de la Galería de Azure. string
sku SKU de imagen de las imágenes de la Galería de Azure. string
version Versión de imagen de las imágenes de la Galería de Azure. Si se especifica 'latest' aquí, la versión se evalúa cuando tiene lugar la compilación de la imagen, no cuando se envía la plantilla. string

PlatformImagePurchasePlan

Nombre Descripción Valor
planName Nombre del plan de compra. string (obligatorio)
planProduct Producto del plan de compra. string (obligatorio)
planPublisher Publicador del plan de compra. string (obligatorio)

ImageTemplateSharedImageVersionSource

Nombre Descripción Value
type Especifica el tipo de imagen de origen con el que desea empezar. 'SharedImageVersion' (obligatorio)
imageVersionId Identificador de recurso de ARM de la versión de la imagen en la galería de imágenes compartidas string (obligatorio)

ImageTemplatePropertiesValidate

Nombre Descripción Valor
continueDistributeOnFailure Si se produce un error en la validación y este campo se establece en false, las imágenes de salida no se distribuirán. Este es el comportamiento predeterminado. Si se produce un error en la validación y este campo se establece en true, las imágenes de salida se seguirán distribuyendo. Use esta opción con precaución, ya que puede dar lugar a que se distribuyan imágenes incorrectas para su uso. En cualquier caso (true o false), la ejecución de la imagen de un extremo a otro se notificará como con errores en caso de error de validación. [Nota: Este campo no tiene ningún efecto si la validación se realiza correctamente]. bool
inVMValidations Lista de validaciones que se van a realizar. ImageTemplateInVMValidator[]
sourceValidationOnly Si este campo se establece en true, la imagen especificada en la sección "source" se validará directamente. No se ejecutará ninguna compilación independiente para generar y, a continuación, validar una imagen personalizada. bool

ImageTemplateInVMValidator

Nombre Descripción Value
name Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de validación string
type Establecimiento del tipo de objeto PowerShell
Shell (obligatorio)

ImageTemplatePowerShellValidator

Nombre Descripción Value
type Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser la validación del shell. 'PowerShell' (obligatorio)
inline Matriz de comandos de PowerShell que se van a ejecutar string[]
runAsSystem Si se especifica, el script de PowerShell se ejecutará con privilegios elevados mediante el usuario del sistema local. Solo puede ser true cuando el campo runElevated anterior está establecido en true. bool
runElevated Si se especifica, el script de PowerShell se ejecutará con privilegios elevados. bool
scriptUri URI del script de PowerShell que se va a ejecutar para la validación. Puede ser un vínculo de GitHub, un URI de Azure Storage, etc. string
sha256Checksum Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior string
validExitCodes Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0] int[]

ImageTemplateShellValidator

Nombre Descripción Value
type Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser la validación del shell. 'Shell' (obligatorio)
inline Matriz de comandos de shell que se van a ejecutar string[]
scriptUri URI del script de shell que se va a ejecutar para la validación. Puede ser un vínculo de GitHub, un URI de Azure Storage, etc. string
sha256Checksum Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri string

ImageTemplateVmProfile

Nombre Descripción Valor
osDiskSizeGB Tamaño del disco del sistema operativo en GB. Omita o especifique 0 para usar el tamaño predeterminado del disco del sistema operativo de Azure. int
userAssignedIdentities Matriz opcional de identificadores de recursos de identidades administradas asignadas por el usuario que se van a configurar en la máquina virtual de compilación y en la máquina virtual de validación. Esto puede incluir la identidad de la plantilla de imagen. string[]
vmSize Tamaño de la máquina virtual que se usa para compilar, personalizar y capturar imágenes. Omita o especifique una cadena vacía para usar el valor predeterminado (Standard_D1_v2 para imágenes de Gen1 y Standard_D2ds_v4 para imágenes de Gen2). string
vnetConfig Configuración opcional de la red virtual que se va a usar para implementar la máquina virtual de compilación y la máquina virtual de validación en. Omítalo si no es necesario usar ninguna red virtual específica. VirtualNetworkConfig

VirtualNetworkConfig

Nombre Descripción Valor
proxyVmSize Tamaño de la máquina virtual de proxy que se usa para pasar el tráfico a la máquina virtual de compilación y a la máquina virtual de validación. Omita o especifique una cadena vacía para usar el valor predeterminado (Standard_A1_v2). string
subnetId Identificador de recurso de una subred preexistente. string

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 la versión más reciente de Windows Novedades y La línea de base de Windows de Azure aplicada.
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. Puede ver todos los recursos creados o ir directamente a DevPortal.microsoft.com para crear su primer dev Box.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso imageTemplates se puede implementar en:

  • Grupos de recursos

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

Formato de los recursos

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "UserAssigned"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      buildTimeoutInMinutes = int
      customize = [
        {
          name = "string"
          type = "string"
          // For remaining properties, see ImageTemplateCustomizer objects
        }
      ]
      distribute = [
        {
          artifactTags = {}
          runOutputName = "string"
          type = "string"
          // For remaining properties, see ImageTemplateDistributor objects
        }
      ]
      source = {
        type = "string"
        // For remaining properties, see ImageTemplateSource objects
      }
      stagingResourceGroup = "string"
      validate = {
        continueDistributeOnFailure = bool
        inVMValidations = [
          {
            name = "string"
            type = "string"
            // For remaining properties, see ImageTemplateInVMValidator objects
          }
        ]
        sourceValidationOnly = bool
      }
      vmProfile = {
        osDiskSizeGB = int
        userAssignedIdentities = [
          "string"
        ]
        vmSize = "string"
        vnetConfig = {
          proxyVmSize = "string"
          subnetId = "string"
        }
      }
    }
  })
}

Objetos ImageTemplateCustomizer

Establezca la propiedad type para especificar el tipo de objeto.

Para Archivo, use:

  type = "File"
  destination = "string"
  sha256Checksum = "string"
  sourceUri = "string"

Para PowerShell, use:

  type = "PowerShell"
  inline = [
    "string"
  ]
  runAsSystem = bool
  runElevated = bool
  scriptUri = "string"
  sha256Checksum = "string"
  validExitCodes = [
    int
  ]

Para Shell, use:

  type = "Shell"
  inline = [
    "string"
  ]
  scriptUri = "string"
  sha256Checksum = "string"

Para WindowsRestart, use:

  type = "WindowsRestart"
  restartCheckCommand = "string"
  restartCommand = "string"
  restartTimeout = "string"

Para WindowsUpdate, use:

  type = "WindowsUpdate"
  filters = [
    "string"
  ]
  searchCriteria = "string"
  updateLimit = int

Objetos ImageTemplateDistributor

Establezca la propiedad type para especificar el tipo de objeto.

Para ManagedImage, use:

  type = "ManagedImage"
  imageId = "string"
  location = "string"

Para SharedImage, use:

  type = "SharedImage"
  excludeFromLatest = bool
  galleryImageId = "string"
  replicationRegions = [
    "string"
  ]
  storageAccountType = "string"

Para VHD, use:

  type = "VHD"

Objetos ImageTemplateSource

Establezca la propiedad type para especificar el tipo de objeto.

Para ManagedImage, use:

  type = "ManagedImage"
  imageId = "string"

Para PlatformImage, use:

  type = "PlatformImage"
  offer = "string"
  planInfo = {
    planName = "string"
    planProduct = "string"
    planPublisher = "string"
  }
  publisher = "string"
  sku = "string"
  version = "string"

Para SharedImageVersion, use:

  type = "SharedImageVersion"
  imageVersionId = "string"

Objetos ImageTemplateInVMValidator

Establezca la propiedad type para especificar el tipo de objeto.

Para PowerShell, use:

  type = "PowerShell"
  inline = [
    "string"
  ]
  runAsSystem = bool
  runElevated = bool
  scriptUri = "string"
  sha256Checksum = "string"
  validExitCodes = [
    int
  ]

Para Shell, use:

  type = "Shell"
  inline = [
    "string"
  ]
  scriptUri = "string"
  sha256Checksum = "string"

Valores de propiedad

imageTemplates

Nombre Descripción Value
type Tipo de recurso "Microsoft.VirtualMachineImages/imageTemplates@2022-02-14"
name El nombre del recurso string (obligatorio)
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
parent_id Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. string (obligatorio)
etiquetas Etiquetas del recurso. Diccionario de nombres y valores de etiqueta.
identidad Identidad de la plantilla de imagen, si está configurada. ImageTemplateIdentity (obligatorio)
properties Propiedades de la plantilla de imagen ImageTemplateProperties

ImageTemplateIdentity

Nombre Descripción Value
type Tipo de identidad que se usa para la plantilla de imagen. El tipo "None" quitará las identidades de la plantilla de imagen. "UserAssigned"
identity_ids Lista de identidades de usuario asociadas a la plantilla de imagen. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recurso de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. Matriz de identificadores de identidad de usuario.

ImageTemplateProperties

Nombre Descripción Valor
buildTimeoutInMinutes Duración máxima de espera al compilar la plantilla de imagen (incluye todas las personalizaciones, validaciones y distribuciones). Omita o especifique 0 para usar el valor predeterminado (4 horas). int
Personalización 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)
source Especifica las propiedades usadas para describir la imagen de origen. ImageTemplateSource (obligatorio)
stagingResourceGroup Identificador del grupo de recursos de almacenamiento provisional en la misma suscripción que la plantilla de imagen que se usará para compilar la imagen. Si este campo está vacío, se creará un grupo de recursos con un nombre aleatorio. Si el grupo de recursos especificado en este campo no existe, se creará con el mismo nombre. Si el grupo de recursos especificado existe, debe estar vacío y en la misma región que la plantilla de imagen. El grupo de recursos creado se eliminará durante la eliminación de la plantilla si este campo está vacío o el grupo de recursos especificado no existe, pero si el grupo de recursos especificado existe los recursos creados en el grupo de recursos se eliminarán durante la eliminación de la plantilla y el propio grupo de recursos permanecerá. string
validate Opciones de configuración y lista de validaciones que se van a realizar en la imagen resultante. ImageTemplatePropertiesValidate
vmProfile Describe cómo se configura la máquina virtual para compilar imágenes. ImageTemplateVmProfile

ImageTemplateCustomizer

Nombre Descripción Value
name Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de personalización string
type Establecimiento del tipo de objeto Archivo
PowerShell
Shell
WindowsRestart
WindowsUpdate (obligatorio)

ImageTemplateFileCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. "Archivo" (obligatorio)
destination Ruta de acceso absoluta a un archivo (con estructuras de directorio anidadas ya creadas) donde el archivo (desde sourceUri) se cargará en en la máquina virtual. string
sha256Checksum Suma de comprobación SHA256 del archivo proporcionado en el campo sourceUri anterior string
SourceUri URI del archivo que se va a cargar para personalizar la máquina virtual. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. string

ImageTemplatePowerShellCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. "PowerShell" (obligatorio)
inline Matriz de comandos de PowerShell que se van a ejecutar string[]
runAsSystem Si se especifica, el script de PowerShell se ejecutará con privilegios elevados mediante el usuario del sistema local. Solo puede ser true cuando el campo runElevated anterior se establece en true. bool
runElevated Si se especifica, el script de PowerShell se ejecutará con privilegios elevados. bool
scriptUri URI del script de PowerShell que se va a ejecutar para la personalización. Puede ser un vínculo de GitHub, un URI de SAS para Azure Storage, etc. string
sha256Checksum Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior string
validExitCodes Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0] int[]

ImageTemplateShellCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. "Shell" (obligatorio)
inline Matriz de comandos de shell que se van a ejecutar string[]
scriptUri URI del 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. string
sha256Checksum Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri string

ImageTemplateRestartCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. "WindowsRestart" (obligatorio)
restartCheckCommand Comando para comprobar si el reinicio se ha realizado correctamente [Valor predeterminado: ''] string
restartCommand Comando para ejecutar el reinicio [Valor predeterminado: 'shutdown /r /f /t 0 /c "packer restart"'] string
restartTimeout Tiempo de espera de reinicio especificado como una cadena de magnitud y unidad, por ejemplo, "5m" (5 minutos) o "2h" (2 horas) [Valor predeterminado: '5m'] string

ImageTemplateWindowsUpdateCustomizer

Nombre Descripción Value
type Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell. "WindowsUpdate" (obligatorio)
filters Matriz de filtros para seleccionar las actualizaciones que se van a aplicar. Omita o especifique una matriz vacía para usar el valor predeterminado (sin filtro). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo. string[]
searchCriteria Criterios para buscar actualizaciones. Omita o especifique una cadena vacía para usar el valor predeterminado (buscar todo). Consulte el vínculo anterior para obtener ejemplos y una descripción detallada de este campo. string
updateLimit Número máximo de actualizaciones que se aplicarán a la vez. Omita o especifique 0 para usar el valor predeterminado (1000) int

ImageTemplateDistributor

Nombre Descripción Valor
artifactTags Etiquetas que se aplicarán al artefacto una vez que el distribuidor haya creado o actualizado. object
runOutputName Nombre que se va a usar para el RunOutput asociado. string (obligatorio)
tipo Establecimiento del tipo de objeto ManagedImage
SharedImage
VHD (obligatorio)

ImageTemplateManagedImageDistributor

Nombre Descripción Value
type Tipo de distribución. "ManagedImage" (obligatorio)
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)

ImageTemplateSharedImageDistributor

Nombre Descripción Value
type Tipo de distribución. "SharedImage" (obligatorio)
excludeFromLatest Marca que indica si la versión de la imagen creada debe excluirse de la versión más reciente. Omita para usar el valor predeterminado (false). bool
galleryImageId Identificador de recurso de la imagen de Shared Image Gallery string (obligatorio)
replicationRegions Lista de regiones en las que se replicará la imagen string[] (obligatorio)
storageAccountType Tipo de cuenta de almacenamiento que se va a usar para almacenar la imagen compartida. Omita usar el valor predeterminado (Standard_LRS). "Standard_LRS"
"Standard_ZRS"

ImageTemplateVhdDistributor

Nombre Descripción Value
type Tipo de distribución. "VHD" (obligatorio)

ImageTemplateSource

Nombre Descripción Value
type Establecimiento del tipo de objeto ManagedImage
PlatformImage
SharedImageVersion (obligatorio)

ImageTemplateManagedImageSource

Nombre Descripción Value
type Especifica el tipo de imagen de origen con el que desea empezar. "ManagedImage" (obligatorio)
imageId Identificador de recurso de ARM de la imagen administrada en la suscripción del cliente string (obligatorio)

ImageTemplatePlatformImageSource

Nombre Descripción Value
type Especifica el tipo de imagen de origen con el que desea empezar. "PlatformImage" (obligatorio)
offer Oferta de imagen de las imágenes de la Galería de Azure. string
planInfo Configuración opcional del plan de compra para la imagen de plataforma. PlatformImagePurchasePlan
publisher Image Publisher en imágenes de la Galería de Azure. string
sku SKU de imagen de las imágenes de la Galería de Azure. string
version Versión de imagen de las imágenes de la Galería de Azure. Si se especifica 'latest' aquí, la versión se evalúa cuando tiene lugar la compilación de la imagen, no cuando se envía la plantilla. string

PlatformImagePurchasePlan

Nombre Descripción Valor
planName Nombre del plan de compra. string (obligatorio)
planProduct Producto del plan de compra. string (obligatorio)
planPublisher Publicador del plan de compra. string (obligatorio)

ImageTemplateSharedImageVersionSource

Nombre Descripción Value
type Especifica el tipo de imagen de origen con el que desea empezar. "SharedImageVersion" (obligatorio)
imageVersionId Identificador de recurso de ARM de la versión de la imagen en la galería de imágenes compartidas string (obligatorio)

ImageTemplatePropertiesValidate

Nombre Descripción Valor
continueDistributeOnFailure Si se produce un error en la validación y este campo se establece en false, las imágenes de salida no se distribuirán. Este es el comportamiento predeterminado. Si se produce un error en la validación y este campo se establece en true, las imágenes de salida se seguirán distribuyendo. Use esta opción con precaución, ya que puede dar lugar a que se distribuyan imágenes incorrectas para su uso. En cualquier caso (true o false), la ejecución de la imagen de un extremo a otro se notificará como con errores en caso de error de validación. [Nota: Este campo no tiene ningún efecto si la validación se realiza correctamente]. bool
inVMValidations Lista de validaciones que se van a realizar. ImageTemplateInVMValidator[]
sourceValidationOnly Si este campo se establece en true, la imagen especificada en la sección "source" se validará directamente. No se ejecutará ninguna compilación independiente para generar y, a continuación, validar una imagen personalizada. bool

ImageTemplateInVMValidator

Nombre Descripción Value
name Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de validación string
type Establecimiento del tipo de objeto PowerShell
Shell (obligatorio)

ImageTemplatePowerShellValidator

Nombre Descripción Value
type Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser la validación del shell. "PowerShell" (obligatorio)
inline Matriz de comandos de PowerShell que se van a ejecutar string[]
runAsSystem Si se especifica, el script de PowerShell se ejecutará con privilegios elevados mediante el usuario del sistema local. Solo puede ser true cuando el campo runElevated anterior está establecido en true. bool
runElevated Si se especifica, el script de PowerShell se ejecutará con privilegios elevados. bool
scriptUri URI del script de PowerShell que se va a ejecutar para la validación. Puede ser un vínculo de GitHub, un URI de Azure Storage, etc. string
sha256Checksum Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior string
validExitCodes Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0] int[]

ImageTemplateShellValidator

Nombre Descripción Value
type Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser la validación del shell. "Shell" (obligatorio)
inline Matriz de comandos de shell que se van a ejecutar string[]
scriptUri URI del script de shell que se va a ejecutar para la validación. Puede ser un vínculo de GitHub, un URI de Azure Storage, etc. string
sha256Checksum Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri string

ImageTemplateVmProfile

Nombre Descripción Valor
osDiskSizeGB Tamaño del disco del sistema operativo en GB. Omita o especifique 0 para usar el tamaño predeterminado del disco del sistema operativo de Azure. int
userAssignedIdentities Matriz opcional de identificadores de recursos de identidades administradas asignadas por el usuario que se van a configurar en la máquina virtual de compilación y en la máquina virtual de validación. Esto puede incluir la identidad de la plantilla de imagen. string[]
vmSize Tamaño de la máquina virtual que se usa para compilar, personalizar y capturar imágenes. Omita o especifique una cadena vacía para usar el valor predeterminado (Standard_D1_v2 para imágenes de Gen1 y Standard_D2ds_v4 para imágenes de Gen2). string
vnetConfig Configuración opcional de la red virtual que se va a usar para implementar la máquina virtual de compilación y la máquina virtual de validación en. Omítalo si no es necesario usar ninguna red virtual específica. VirtualNetworkConfig

VirtualNetworkConfig

Nombre Descripción Valor
proxyVmSize Tamaño de la máquina virtual de proxy que se usa para pasar tráfico a la máquina virtual de compilación y a la máquina virtual de validación. Omita o especifique una cadena vacía para usar el valor predeterminado (Standard_A1_v2). string
subnetId Identificador de recurso de una subred preexistente. string