Imagen Microsoft.VirtualMachineImagesTemplates 2022-02-14

Artículo
12/17/2024

Definición de recursos de Bicep

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

grupos de recursos: consulte comandos de implementación de grupos de recursos

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@2022-02-14' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    buildTimeoutInMinutes: int
    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
    }
    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'
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos ImageTemplateInVMValidator

Establezca el tipo propiedad para especificar el tipo de objeto.

Para powerShell, use:

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

Para shell, use:

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

Objetos ImageTemplateCustomizer

Establezca el tipo propiedad para especificar el tipo de objeto.

Para archivo, use:

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

Para powerShell, use:

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

Para shell, use:

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

Para WindowsRestart, use:

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

Para WindowsUpdate, use:

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

Objetos ImageTemplateDistributor

Establezca el tipo propiedad para especificar el tipo de objeto.

Para ManagedImage, use:

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

Para SharedImage, use:

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

Para VHD, use:

{
  type: 'VHD'
}

Objetos ImageTemplateSource

Establezca el tipo propiedad para especificar el tipo de objeto.

Para ManagedImage, use:

{
  imageId: 'string'
  type: 'ManagedImage'
}

Para PlatformImage, use:

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

Para SharedImageVersion, use:

{
  imageVersionId: 'string'
  type: 'SharedImageVersion'
}

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 "File" para el tipo ImageTemplateFileCustomizer. Establezca en "PowerShell" para el tipo ImageTemplatePowerShellCustomizer. Establezca en "Shell" para el tipo ImageTemplateShellCustomizer. Establezca en "WindowsRestart" para el tipo ImageTemplateRestartCustomizer. Establezca en "WindowsUpdate" para el tipo ImageTemplateWindowsUpdateCustomizer.	'File' 'PowerShell' 'Shell' "WindowsRestart" 'WindowsUpdate' (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. Establezca en "VHD" para el tipo ImageTemplateVhdDistributor.	'ManagedImage' 'SharedImage' 'VHD' (obligatorio)

ImageTemplateDistributorArtifactTags

Nombre	Descripción	Valor

ImageTemplateFileCustomizer

Nombre	Descripción	Valor
destino	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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del archivo proporcionado en el campo sourceUri anterior	cuerda
sourceUri	Identificador 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.	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'File' (obligatorio)

ImageTemplateIdentity

Nombre	Descripción	Valor
tipo	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	Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.	UserAssignedIdentities

ImageTemplateInVMValidator

Nombre	Descripción	Valor
nombre	Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de validación	cuerda
tipo	Establezca en "PowerShell" para el tipo ImageTemplatePowerShellValidator. Establezca en "Shell" para el tipo ImageTemplateShellValidator.	'PowerShell' 'Shell' (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)

ImageTemplateManagedImageSource

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

ImageTemplatePlatformImageSource

Nombre	Descripción	Valor
ofrecer	Oferta de imagen de la Imágenes de la Galería de Azure.	cuerda
planInfo	Configuración opcional del plan de compra para la imagen de plataforma.	PlatformImagePurchasePlan
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. 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.	cuerda

ImageTemplatePowerShellCustomizer

Nombre	Descripción	Valor
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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'PowerShell' (obligatorio)
validExitCodes	Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0]	int[]

ImageTemplatePowerShellValidator

Nombre	Descripción	Valor
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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior	cuerda
tipo	Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser validación del shell.	'PowerShell' (obligatorio)
validExitCodes	Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0]	int[]

ImageTemplateProperties

Nombre	Descripción	Valor
buildTimeoutInMinutes	Duración máxima para esperar 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 Restricciones: Valor mínimo = 0 Valor máximo = 960
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)
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á.	cuerda
validar	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

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

ImageTemplateRestartCustomizer

Nombre	Descripción	Valor
restartCheckCommand	Comando para comprobar si el reinicio se realizó correctamente [Valor predeterminado: '']	cuerda
restartCommand	Comando para ejecutar el reinicio [Valor predeterminado: 'shutdown /r /f /t 0 /c "packer restart"']	cuerda
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']	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'WindowsRestart' (obligatorio)

ImageTemplateSharedImageDistributor

Nombre	Descripción	Valor
excludeFromLatest	Marca que indica si la versión de la imagen creada debe excluirse de la versión más reciente. Omitir 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 usará para almacenar la imagen compartida. Omita usar el valor predeterminado (Standard_LRS).	"Standard_LRS" "Standard_ZRS"
tipo	Tipo de distribución.	'SharedImage' (obligatorio)

ImageTemplateSharedImageVersionSource

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

ImageTemplateShellCustomizer

Nombre	Descripción	Valor
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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'Shell' (obligatorio)

ImageTemplateShellValidator

Nombre	Descripción	Valor
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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri	cuerda
tipo	Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser validación del shell.	'Shell' (obligatorio)

ImageTemplateSource

Nombre	Descripción	Valor
tipo	Establezca en "ManagedImage" para el tipo ImageTemplateManagedImageSource. Establezca en "PlatformImage" para el tipo ImageTemplatePlatformImageSource. Establezca en "SharedImageVersion" para el tipo ImageTemplateSharedImageVersionSource.	'ManagedImage' 'PlatformImage' 'SharedImageVersion' (obligatorio)

ImageTemplateVhdDistributor

Nombre	Descripción	Valor
tipo	Tipo de distribución.	'VHD' (obligatorio)

ImageTemplateVmProfile

Nombre	Descripción	Valor
osDiskSizeGB	Tamaño del disco del sistema operativo en GB. Omita o especifique 0 para usar el tamaño de disco del sistema operativo predeterminado de Azure.	Int Restricciones: Valor mínimo = 0
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 gen1 y Standard_D2ds_v4 para imágenes de Gen2).	cuerda
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. Omita si no es necesario usar ninguna red virtual específica.	virtualNetworkConfig

ImageTemplateWindowsUpdateCustomizer

Nombre	Descripción	Valor
filtros	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.	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'WindowsUpdate' (obligatorio)
updateLimit	Número máximo de actualizaciones que se aplicarán a la vez. Omitir o especificar 0 para usar el valor predeterminado (1000)	Int Restricciones: Valor mínimo = 0

Microsoft.VirtualMachineImages/imageTemplates

Nombre	Descripción	Valor
identidad	Identidad de la plantilla de imagen, si está configurada.	ImageTemplateIdentity (obligatorio)
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	cuerda Restricciones: Patrón = `^[A-Za-z0-9-_.]{1,64}$` (obligatorio)
Propiedades	Las propiedades de la plantilla de imagen	ImageTemplateProperties
Etiquetas	Etiquetas del recurso	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

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)

TrackedResourceTags

Nombre	Descripción	Valor

UserAssignedIdentities

Nombre	Descripción	Valor

UserAssignedIdentity

Nombre	Descripción	Valor

VirtualNetworkConfig

Nombre	Descripción	Valor
proxyVmSize	Tamaño de la máquina virtual 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).	cuerda
subnetId	Identificador de recurso de una subred existente previamente.	cuerda

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo	Descripción
plantilla de imagen de máquina virtual	Módulo de recursos de AVM para la plantilla de imagen de máquina virtual

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar 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:

grupos de recursos: consulte comandos de implementación de grupos de recursos

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": "2022-02-14",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "buildTimeoutInMinutes": "int",
    "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
    },
    "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"
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objetos ImageTemplateInVMValidator

Establezca el tipo propiedad para especificar el tipo de objeto.

Para powerShell, use:

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

Para shell, use:

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

Objetos ImageTemplateCustomizer

Establezca el tipo propiedad para especificar el tipo de objeto.

Para archivo, use:

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

Para powerShell, use:

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

Para shell, use:

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

Para WindowsRestart, use:

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

Para WindowsUpdate, use:

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

Objetos ImageTemplateDistributor

Establezca el tipo propiedad para especificar el tipo de objeto.

Para ManagedImage, use:

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

Para SharedImage, use:

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

Para VHD, use:

{
  "type": "VHD"
}

Objetos ImageTemplateSource

Establezca el tipo propiedad para especificar el tipo de objeto.

Para ManagedImage, use:

{
  "imageId": "string",
  "type": "ManagedImage"
}

Para PlatformImage, use:

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

Para SharedImageVersion, use:

{
  "imageVersionId": "string",
  "type": "SharedImageVersion"
}

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 "File" para el tipo ImageTemplateFileCustomizer. Establezca en "PowerShell" para el tipo ImageTemplatePowerShellCustomizer. Establezca en "Shell" para el tipo ImageTemplateShellCustomizer. Establezca en "WindowsRestart" para el tipo ImageTemplateRestartCustomizer. Establezca en "WindowsUpdate" para el tipo ImageTemplateWindowsUpdateCustomizer.	'File' 'PowerShell' 'Shell' "WindowsRestart" 'WindowsUpdate' (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. Establezca en "VHD" para el tipo ImageTemplateVhdDistributor.	'ManagedImage' 'SharedImage' 'VHD' (obligatorio)

ImageTemplateDistributorArtifactTags

Nombre	Descripción	Valor

ImageTemplateFileCustomizer

Nombre	Descripción	Valor
destino	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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del archivo proporcionado en el campo sourceUri anterior	cuerda
sourceUri	Identificador 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.	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'File' (obligatorio)

ImageTemplateIdentity

Nombre	Descripción	Valor
tipo	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	Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.	UserAssignedIdentities

ImageTemplateInVMValidator

Nombre	Descripción	Valor
nombre	Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de validación	cuerda
tipo	Establezca en "PowerShell" para el tipo ImageTemplatePowerShellValidator. Establezca en "Shell" para el tipo ImageTemplateShellValidator.	'PowerShell' 'Shell' (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)

ImageTemplateManagedImageSource

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

ImageTemplatePlatformImageSource

Nombre	Descripción	Valor
ofrecer	Oferta de imagen de la Imágenes de la Galería de Azure.	cuerda
planInfo	Configuración opcional del plan de compra para la imagen de plataforma.	PlatformImagePurchasePlan
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. 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.	cuerda

ImageTemplatePowerShellCustomizer

Nombre	Descripción	Valor
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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'PowerShell' (obligatorio)
validExitCodes	Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0]	int[]

ImageTemplatePowerShellValidator

Nombre	Descripción	Valor
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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior	cuerda
tipo	Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser validación del shell.	'PowerShell' (obligatorio)
validExitCodes	Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0]	int[]

ImageTemplateProperties

Nombre	Descripción	Valor
buildTimeoutInMinutes	Duración máxima para esperar 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 Restricciones: Valor mínimo = 0 Valor máximo = 960
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)
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á.	cuerda
validar	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

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

ImageTemplateRestartCustomizer

Nombre	Descripción	Valor
restartCheckCommand	Comando para comprobar si el reinicio se realizó correctamente [Valor predeterminado: '']	cuerda
restartCommand	Comando para ejecutar el reinicio [Valor predeterminado: 'shutdown /r /f /t 0 /c "packer restart"']	cuerda
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']	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'WindowsRestart' (obligatorio)

ImageTemplateSharedImageDistributor

Nombre	Descripción	Valor
excludeFromLatest	Marca que indica si la versión de la imagen creada debe excluirse de la versión más reciente. Omitir 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 usará para almacenar la imagen compartida. Omita usar el valor predeterminado (Standard_LRS).	"Standard_LRS" "Standard_ZRS"
tipo	Tipo de distribución.	'SharedImage' (obligatorio)

ImageTemplateSharedImageVersionSource

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

ImageTemplateShellCustomizer

Nombre	Descripción	Valor
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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'Shell' (obligatorio)

ImageTemplateShellValidator

Nombre	Descripción	Valor
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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri	cuerda
tipo	Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser validación del shell.	'Shell' (obligatorio)

ImageTemplateSource

Nombre	Descripción	Valor
tipo	Establezca en "ManagedImage" para el tipo ImageTemplateManagedImageSource. Establezca en "PlatformImage" para el tipo ImageTemplatePlatformImageSource. Establezca en "SharedImageVersion" para el tipo ImageTemplateSharedImageVersionSource.	'ManagedImage' 'PlatformImage' 'SharedImageVersion' (obligatorio)

ImageTemplateVhdDistributor

Nombre	Descripción	Valor
tipo	Tipo de distribución.	'VHD' (obligatorio)

ImageTemplateVmProfile

Nombre	Descripción	Valor
osDiskSizeGB	Tamaño del disco del sistema operativo en GB. Omita o especifique 0 para usar el tamaño de disco del sistema operativo predeterminado de Azure.	Int Restricciones: Valor mínimo = 0
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 gen1 y Standard_D2ds_v4 para imágenes de Gen2).	cuerda
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. Omita si no es necesario usar ninguna red virtual específica.	virtualNetworkConfig

ImageTemplateWindowsUpdateCustomizer

Nombre	Descripción	Valor
filtros	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.	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'WindowsUpdate' (obligatorio)
updateLimit	Número máximo de actualizaciones que se aplicarán a la vez. Omitir o especificar 0 para usar el valor predeterminado (1000)	Int Restricciones: Valor mínimo = 0

Microsoft.VirtualMachineImages/imageTemplates

Nombre	Descripción	Valor
apiVersion	La versión de api	'2022-02-14'
identidad	Identidad de la plantilla de imagen, si está configurada.	ImageTemplateIdentity (obligatorio)
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	cuerda Restricciones: Patrón = `^[A-Za-z0-9-_.]{1,64}$` (obligatorio)
Propiedades	Las propiedades de la plantilla de imagen	ImageTemplateProperties
Etiquetas	Etiquetas del recurso	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	'Microsoft.VirtualMachineImages/imageTemplates'

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)

TrackedResourceTags

Nombre	Descripción	Valor

UserAssignedIdentities

Nombre	Descripción	Valor

UserAssignedIdentity

Nombre	Descripción	Valor

VirtualNetworkConfig

Nombre	Descripción	Valor
proxyVmSize	Tamaño de la máquina virtual 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).	cuerda
subnetId	Identificador de recurso de una subred existente previamente.	cuerda

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Plantilla	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 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@2022-02-14"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      buildTimeoutInMinutes = int
      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
      }
      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 ImageTemplateInVMValidator

Establezca el tipo propiedad para especificar el tipo de objeto.

Para powerShell, use:

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

Para shell, use:

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

Objetos ImageTemplateCustomizer

Establezca el tipo propiedad para especificar el tipo de objeto.

Para archivo, use:

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

Para powerShell, use:

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

Para shell, use:

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

Para WindowsRestart, use:

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

Para WindowsUpdate, use:

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

Objetos ImageTemplateDistributor

Establezca el tipo propiedad para especificar el tipo de objeto.

Para ManagedImage, use:

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

Para SharedImage, use:

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

Para VHD, use:

{
  type = "VHD"
}

Objetos ImageTemplateSource

Establezca el tipo propiedad para especificar el tipo de objeto.

Para ManagedImage, use:

{
  imageId = "string"
  type = "ManagedImage"
}

Para PlatformImage, use:

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

Para SharedImageVersion, use:

{
  imageVersionId = "string"
  type = "SharedImageVersion"
}

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 "File" para el tipo ImageTemplateFileCustomizer. Establezca en "PowerShell" para el tipo ImageTemplatePowerShellCustomizer. Establezca en "Shell" para el tipo ImageTemplateShellCustomizer. Establezca en "WindowsRestart" para el tipo ImageTemplateRestartCustomizer. Establezca en "WindowsUpdate" para el tipo ImageTemplateWindowsUpdateCustomizer.	'File' 'PowerShell' 'Shell' "WindowsRestart" 'WindowsUpdate' (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. Establezca en "VHD" para el tipo ImageTemplateVhdDistributor.	'ManagedImage' 'SharedImage' 'VHD' (obligatorio)

ImageTemplateDistributorArtifactTags

Nombre	Descripción	Valor

ImageTemplateFileCustomizer

Nombre	Descripción	Valor
destino	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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del archivo proporcionado en el campo sourceUri anterior	cuerda
sourceUri	Identificador 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.	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'File' (obligatorio)

ImageTemplateIdentity

Nombre	Descripción	Valor
tipo	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	Conjunto de identidades asignadas por el usuario asociadas al recurso. Las claves de diccionario userAssignedIdentities serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Los valores del diccionario pueden ser objetos vacíos ({}) en las solicitudes.	UserAssignedIdentities

ImageTemplateInVMValidator

Nombre	Descripción	Valor
nombre	Nombre descriptivo para proporcionar contexto sobre lo que hace este paso de validación	cuerda
tipo	Establezca en "PowerShell" para el tipo ImageTemplatePowerShellValidator. Establezca en "Shell" para el tipo ImageTemplateShellValidator.	'PowerShell' 'Shell' (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)

ImageTemplateManagedImageSource

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

ImageTemplatePlatformImageSource

Nombre	Descripción	Valor
ofrecer	Oferta de imagen de la Imágenes de la Galería de Azure.	cuerda
planInfo	Configuración opcional del plan de compra para la imagen de plataforma.	PlatformImagePurchasePlan
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. 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.	cuerda

ImageTemplatePowerShellCustomizer

Nombre	Descripción	Valor
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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'PowerShell' (obligatorio)
validExitCodes	Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0]	int[]

ImageTemplatePowerShellValidator

Nombre	Descripción	Valor
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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del script de Power Shell proporcionado en el campo scriptUri anterior	cuerda
tipo	Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser validación del shell.	'PowerShell' (obligatorio)
validExitCodes	Códigos de salida válidos para el script de PowerShell. [Valor predeterminado: 0]	int[]

ImageTemplateProperties

Nombre	Descripción	Valor
buildTimeoutInMinutes	Duración máxima para esperar 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 Restricciones: Valor mínimo = 0 Valor máximo = 960
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)
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á.	cuerda
validar	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

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

ImageTemplateRestartCustomizer

Nombre	Descripción	Valor
restartCheckCommand	Comando para comprobar si el reinicio se realizó correctamente [Valor predeterminado: '']	cuerda
restartCommand	Comando para ejecutar el reinicio [Valor predeterminado: 'shutdown /r /f /t 0 /c "packer restart"']	cuerda
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']	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'WindowsRestart' (obligatorio)

ImageTemplateSharedImageDistributor

Nombre	Descripción	Valor
excludeFromLatest	Marca que indica si la versión de la imagen creada debe excluirse de la versión más reciente. Omitir 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 usará para almacenar la imagen compartida. Omita usar el valor predeterminado (Standard_LRS).	"Standard_LRS" "Standard_ZRS"
tipo	Tipo de distribución.	'SharedImage' (obligatorio)

ImageTemplateSharedImageVersionSource

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

ImageTemplateShellCustomizer

Nombre	Descripción	Valor
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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'Shell' (obligatorio)

ImageTemplateShellValidator

Nombre	Descripción	Valor
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.	cuerda
sha256Checksum	Suma de comprobación SHA256 del script de shell proporcionado en el campo scriptUri	cuerda
tipo	Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser validación del shell.	'Shell' (obligatorio)

ImageTemplateSource

Nombre	Descripción	Valor
tipo	Establezca en "ManagedImage" para el tipo ImageTemplateManagedImageSource. Establezca en "PlatformImage" para el tipo ImageTemplatePlatformImageSource. Establezca en "SharedImageVersion" para el tipo ImageTemplateSharedImageVersionSource.	'ManagedImage' 'PlatformImage' 'SharedImageVersion' (obligatorio)

ImageTemplateVhdDistributor

Nombre	Descripción	Valor
tipo	Tipo de distribución.	'VHD' (obligatorio)

ImageTemplateVmProfile

Nombre	Descripción	Valor
osDiskSizeGB	Tamaño del disco del sistema operativo en GB. Omita o especifique 0 para usar el tamaño de disco del sistema operativo predeterminado de Azure.	Int Restricciones: Valor mínimo = 0
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 gen1 y Standard_D2ds_v4 para imágenes de Gen2).	cuerda
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. Omita si no es necesario usar ninguna red virtual específica.	virtualNetworkConfig

ImageTemplateWindowsUpdateCustomizer

Nombre	Descripción	Valor
filtros	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.	cuerda
tipo	Tipo de herramienta de personalización que desea usar en la imagen. Por ejemplo, "Shell" puede ser personalizador de shell.	'WindowsUpdate' (obligatorio)
updateLimit	Número máximo de actualizaciones que se aplicarán a la vez. Omitir o especificar 0 para usar el valor predeterminado (1000)	Int Restricciones: Valor mínimo = 0

Microsoft.VirtualMachineImages/imageTemplates

Nombre	Descripción	Valor
identidad	Identidad de la plantilla de imagen, si está configurada.	ImageTemplateIdentity (obligatorio)
ubicación	Ubicación geográfica donde reside el recurso	string (obligatorio)
nombre	El nombre del recurso	cuerda Restricciones: Patrón = `^[A-Za-z0-9-_.]{1,64}$` (obligatorio)
Propiedades	Las propiedades de la plantilla de imagen	ImageTemplateProperties
Etiquetas	Etiquetas del recurso	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft.VirtualMachineImages/imageTemplates@2022-02-14"

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)

TrackedResourceTags

Nombre	Descripción	Valor

UserAssignedIdentities

Nombre	Descripción	Valor

UserAssignedIdentity

Nombre	Descripción	Valor

VirtualNetworkConfig

Nombre	Descripción	Valor
proxyVmSize	Tamaño de la máquina virtual 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).	cuerda
subnetId	Identificador de recurso de una subred existente previamente.	cuerda

Compartir a través de

Imagen Microsoft.VirtualMachineImagesTemplates 2022-02-14

Definición de recursos de Bicep

Formato de recurso

Objetos ImageTemplateInVMValidator

Objetos ImageTemplateCustomizer

Objetos ImageTemplateDistributor

Objetos ImageTemplateSource

Valores de propiedad

ImageTemplateCustomizer

ImageTemplateDistributor

ImageTemplateDistributorArtifactTags

ImageTemplateFileCustomizer

ImageTemplateIdentity

ImageTemplateInVMValidator

ImageTemplateManagedImageDistributor

ImageTemplateManagedImageSource

ImageTemplatePlatformImageSource

ImageTemplatePowerShellCustomizer

ImageTemplatePowerShellValidator

ImageTemplateProperties

ImageTemplatePropertiesValidate

ImageTemplateRestartCustomizer

ImageTemplateSharedImageDistributor

ImageTemplateSharedImageVersionSource

ImageTemplateShellCustomizer

ImageTemplateShellValidator

ImageTemplateSource

ImageTemplateVhdDistributor

ImageTemplateVmProfile

ImageTemplateWindowsUpdateCustomizer

Microsoft.VirtualMachineImages/imageTemplates

PlatformImagePurchasePlan

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

VirtualNetworkConfig

Ejemplos de uso

Módulos comprobados de Azure

Ejemplos de inicio rápido de Azure

Definición de recursos de plantilla de ARM

Formato de recurso

Objetos ImageTemplateInVMValidator

Objetos ImageTemplateCustomizer

Objetos ImageTemplateDistributor

Objetos ImageTemplateSource

Valores de propiedad

ImageTemplateCustomizer

ImageTemplateDistributor

ImageTemplateDistributorArtifactTags

ImageTemplateFileCustomizer

ImageTemplateIdentity

ImageTemplateInVMValidator

ImageTemplateManagedImageDistributor

ImageTemplateManagedImageSource

ImageTemplatePlatformImageSource

ImageTemplatePowerShellCustomizer

ImageTemplatePowerShellValidator

ImageTemplateProperties

ImageTemplatePropertiesValidate

ImageTemplateRestartCustomizer

ImageTemplateSharedImageDistributor

ImageTemplateSharedImageVersionSource

ImageTemplateShellCustomizer

ImageTemplateShellValidator

ImageTemplateSource

ImageTemplateVhdDistributor

ImageTemplateVmProfile

ImageTemplateWindowsUpdateCustomizer

Microsoft.VirtualMachineImages/imageTemplates

PlatformImagePurchasePlan

TrackedResourceTags

UserAssignedIdentities

UserAssignedIdentity

VirtualNetworkConfig

Ejemplos de uso

Plantillas de inicio rápido de Azure

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Objetos ImageTemplateInVMValidator