Microsoft.VirtualMachineImages imageTemplates

Article
10/19/2024

Définition de ressource Bicep

Le type de ressource imageTemplates peut être déployé avec des opérations qui ciblent :

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.VirtualMachineImages/imageTemplates, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2024-02-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    autoRun: {
      state: 'string'
    }
    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
      }
    ]
    errorHandling: {
      onCustomizerError: 'string'
      onValidationError: 'string'
    }
    managedResourceTags: {}
    optimize: {
      vmBoot: {
        state: 'string'
      }
    }
    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: {
        containerInstanceSubnetId: 'string'
        proxyVmSize: 'string'
        subnetId: 'string'
      }
    }
  }
}

Objets ImageTemplateCustomizer

Définissez le type propriété pour spécifier le type d’objet.

Pour fichier, utilisez :

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

Pour PowerShell, utilisez :

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

Pour Shell, utilisez :

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

Pour windowsRestart, utilisez :

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

Pour WindowsUpdate, utilisez :

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

Objets ImageTemplateDistributor

Définissez le type propriété pour spécifier le type d’objet.

Pour ManagedImage, utilisez :

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

Pour SharedImage, utilisez :

  type: 'SharedImage'
  excludeFromLatest: bool
  galleryImageId: 'string'
  replicationRegions: [
    'string'
  ]
  storageAccountType: 'string'
  targetRegions: [
    {
      name: 'string'
      replicaCount: int
      storageAccountType: 'string'
    }
  ]
  versioning: {
    scheme: 'string'
    // For remaining properties, see DistributeVersioner objects
  }

Pour de disque dur virtuel, utilisez :

  type: 'VHD'
  uri: 'string'

Objets DistributeVersioner

Définissez le schéma propriété pour spécifier le type d’objet.

Pour dernière, utilisez :

  scheme: 'Latest'
  major: int

Pour source, utilisez :

  scheme: 'Source'

Objets ImageTemplateSource

Définissez le type propriété pour spécifier le type d’objet.

Pour ManagedImage, utilisez :

  type: 'ManagedImage'
  imageId: 'string'

Pour PlatformImage, utilisez :

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

Pour SharedImageVersion, utilisez :

  type: 'SharedImageVersion'
  imageVersionId: 'string'

Objets ImageTemplateInVMValidator

Définissez le type propriété pour spécifier le type d’objet.

Pour fichier, utilisez :

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

Pour PowerShell, utilisez :

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

Pour Shell, utilisez :

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

Valeurs de propriété

imageTemplates

Nom	Description	Valeur
nom	Nom de la ressource	chaîne (obligatoire)
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
étiquettes	Balises de ressource.	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
identité	Identité du modèle d’image, s’il est configuré.	ImageTemplateIdentity (obligatoire)
Propriétés	Propriétés du modèle d’image	ImageTemplateProperties

ImageTemplateIdentity

Nom	Description	Valeur
type	Type d’identité utilisé pour le modèle d’image. Le type « None » supprime toutes les identités du modèle d’image.	'None' 'UserAssigned'
userAssignedIdentities	Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.	UserAssignedIdentities

UserAssignedIdentities

Nom	Description	Valeur
{propriété personnalisée}		UserAssignedIdentity

UserAssignedIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

ImageTemplateProperties

Nom	Description	Valeur
autoRun	Indique si le modèle d’image doit être exécuté automatiquement lors de la création ou de la mise à jour du modèle.	ImageTemplateAutoRun
buildTimeoutInMinutes	Durée maximale d’attente lors de la création du modèle d’image (inclut toutes les personnalisations, l’optimisation, les validations et les distributions). Omettez ou spécifiez 0 pour utiliser la valeur par défaut (4 heures).	Int Contraintes: Valeur minimale = 0 Valeur maximale = 960
Personnaliser	Spécifie les propriétés utilisées pour décrire les étapes de personnalisation de l’image, telles que la source d’image, etc.	ImageTemplateCustomizer[]
distribuer	Cible de distribution vers laquelle la sortie de l’image doit être générée.	ImageTemplateDistributor[] (obligatoire)
errorHandling	Options de gestion des erreurs lors d’une défaillance de build	ImageTemplatePropertiesErrorHandling
managedResourceTags	Balises qui seront appliquées au groupe de ressources et/ou aux ressources créées par le service.	objet
optimiser	Spécifie l’optimisation à effectuer sur l’image.	ImageTemplatePropertiesOptimize
source	Spécifie les propriétés utilisées pour décrire l’image source.	ImageTemplateSource (obligatoire)
stagingResourceGroup	ID de groupe de ressources intermédiaires dans le même abonnement que le modèle d’image qui sera utilisé pour générer l’image. Si ce champ est vide, un groupe de ressources avec un nom aléatoire est créé. Si le groupe de ressources spécifié dans ce champ n’existe pas, il est créé avec le même nom. Si le groupe de ressources spécifié existe, il doit être vide et dans la même région que le modèle d’image. Le groupe de ressources créé est supprimé lors de la suppression du modèle si ce champ est vide ou si le groupe de ressources spécifié n’existe pas, mais si le groupe de ressources spécifié existe, les ressources créées dans le groupe de ressources sont supprimées pendant la suppression du modèle et le groupe de ressources lui-même reste.	corde
valider	Options de configuration et liste des validations à effectuer sur l’image résultante.	ImageTemplatePropertiesValidate
vmProfile	Décrit comment la machine virtuelle est configurée pour générer des images	ImageTemplateVmProfile

ImageTemplateAutoRun

Nom	Description	Valeur
état	L’activation de ce champ déclenche une génération automatique sur la création ou la mise à jour du modèle d’image.	'Désactivé' 'Activé'

ImageTemplateCustomizer

Nom	Description	Valeur
nom	Nom convivial pour fournir un contexte sur ce que fait cette étape de personnalisation	corde
type	Définir le type d’objet	fichier PowerShell Shell WindowsRestart windowsUpdate (obligatoire)

ImageTemplateFileCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	'File' (obligatoire)
destination	Chemin absolu d’un fichier (avec des structures de répertoires imbriquées déjà créées) dans lequel le fichier (à partir de sourceUri) sera chargé dans la machine virtuelle	corde
sha256Checksum	Somme de contrôle SHA256 du fichier fourni dans le champ sourceUri ci-dessus	corde
sourceUri	URI du fichier à charger pour personnaliser la machine virtuelle. Il peut s’agir d’un lien github, d’UN URI SAP pour stockage Azure, etc.	corde

ImageTemplatePowerShellCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	'PowerShell' (obligatoire)
Inline	Tableau de commandes PowerShell à exécuter	string[]
runAsSystem	Si spécifié, le script PowerShell est exécuté avec des privilèges élevés à l’aide de l’utilisateur du système local. Ne peut être vrai que lorsque le champ runElevated ci-dessus a la valeur true.	Bool
runElevated	Si spécifié, le script PowerShell est exécuté avec des privilèges élevés	Bool
scriptUri	URI du script PowerShell à exécuter pour la personnalisation. Il peut s’agir d’un lien github, d’UN URI SAP pour stockage Azure, etc.	corde
sha256Checksum	Somme de contrôle SHA256 du script Power Shell fourni dans le champ scriptUri ci-dessus	corde
validExitCodes	Codes de sortie valides pour le script PowerShell. [Par défaut : 0]	int[]

ImageTemplateShellCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	'Shell' (obligatoire)
Inline	Tableau de commandes shell à exécuter	string[]
scriptUri	URI du script shell à exécuter pour la personnalisation. Il peut s’agir d’un lien github, d’UN URI SAP pour stockage Azure, etc.	corde
sha256Checksum	Somme de contrôle SHA256 du script shell fournie dans le champ scriptUri	corde

ImageTemplateRestartCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	'WindowsRestart' (obligatoire)
restartCheckCommand	Commande pour vérifier si le redémarrage a réussi [Valeur par défaut : '']	corde
restartCommand	Commande pour exécuter le redémarrage [Par défaut : 'shutdown /r /f /t 0 /c « packer restart"']	corde
restartTimeout	Délai de redémarrage spécifié sous la forme d’une chaîne de magnitude et d’unité, par exemple « 5 m » (5 minutes) ou « 2h » (2 heures) [Valeur par défaut : « 5m » ]	corde

ImageTemplateWindowsUpdateCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	'WindowsUpdate' (obligatoire)
Filtres	Tableau de filtres pour sélectionner les mises à jour à appliquer. Omettez ou spécifiez un tableau vide pour utiliser la valeur par défaut (aucun filtre). Reportez-vous au lien ci-dessus pour obtenir des exemples et une description détaillée de ce champ.	string[]
searchCriteria	Critères de recherche des mises à jour. Omettez ou spécifiez une chaîne vide pour utiliser la valeur par défaut (recherche tout). Reportez-vous au lien ci-dessus pour obtenir des exemples et une description détaillée de ce champ.	corde
updateLimit	Nombre maximal de mises à jour à appliquer à la fois. Omettez ou spécifiez 0 pour utiliser la valeur par défaut (1000)	Int Contraintes: Valeur minimale = 0

ImageTemplateDistributor

Nom	Description	Valeur
artifactTags	Balises qui seront appliquées à l’artefact une fois qu’il a été créé/mis à jour par le serveur de distribution.	objet
runOutputName	Nom à utiliser pour le RunOutput associé.	chaîne (obligatoire) Contraintes: Modèle = `^[A-Za-z0-9-_.]{1,64}$`
type	Définir le type d’objet	ManagedImage SharedImage disque dur virtuel (obligatoire)

ImageTemplateManagedImageDistributor

Nom	Description	Valeur
type	Type de distribution.	'ManagedImage' (obligatoire)
imageId	ID de ressource de l’image de disque managé	chaîne (obligatoire)
emplacement	Emplacement Azure de l’image, doit correspondre si l’image existe déjà	chaîne (obligatoire)

ImageTemplateSharedImageDistributor

Nom	Description	Valeur
type	Type de distribution.	'SharedImage' (obligatoire)
excludeFromLatest	Indicateur qui indique si la version de l’image créée doit être exclue de la dernière version. Omettez d’utiliser la valeur par défaut (false).	Bool
galleryImageId	ID de ressource de l’image de la galerie de calcul Azure	chaîne (obligatoire)
replicationRegions	[Déconseillé] Liste des régions vers laquelle l’image sera répliquée. Cette liste ne peut être spécifiée que si targetRegions n’est pas spécifié. Ce champ est déconseillé : utilisez plutôt targetRegions.	string[]
storageAccountType	[Déconseillé] Type de compte de stockage à utiliser pour stocker l’image partagée. Omettez d’utiliser la valeur par défaut (Standard_LRS). Ce champ ne peut être spécifié que si replicationRegions est spécifié. Ce champ est déconseillé : utilisez plutôt targetRegions.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'
targetRegions	Régions cibles vers lesquelles la version d’image distribuée sera répliquée. Cet objet remplace replicationRegions et peut être spécifié uniquement si replicationRegions n’est pas spécifié.	TargetRegion[]
contrôle de version	Décrit comment générer un nouveau numéro de version x.y.z pour la distribution.	DistributeVersioner

TargetRegion

Nom	Description	Valeur
nom	Nom de la région.	chaîne (obligatoire)
replicaCount	Nombre de réplicas de la version d’image à créer dans cette région. Omettez d’utiliser la valeur par défaut (1).	Int Contraintes: Valeur minimale = 1
storageAccountType	Spécifie le type de compte de stockage à utiliser pour stocker l’image dans cette région. Omettez d’utiliser la valeur par défaut (Standard_LRS).	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

DistributeVersioner

Nom	Description	Valeur
schéma	Définir le type d’objet	dernière source (obligatoire)

DistributeVersionerLatest

Nom	Description	Valeur
schéma	Schéma de numérotation de version à utiliser.	'Latest' (obligatoire)
majeur	Version principale du numéro de version généré. Déterminez ce qui est « le plus récent » en fonction des versions avec cette valeur comme version principale. -1 équivaut à le laisser non défini.	Int

DistributeVersionerSource

Nom	Description	Valeur
schéma	Schéma de numérotation de version à utiliser.	'Source' (obligatoire)

ImageTemplateVhdDistributor

Nom	Description	Valeur
type	Type de distribution.	'VHD' (obligatoire)
URI	URI de stockage Azure facultatif pour l’objet blob de disque dur virtuel distribué. Omettez d’utiliser la chaîne par défaut (chaîne vide) dans laquelle le disque dur virtuel serait publié sur le compte de stockage dans le groupe de ressources intermédiaire.	corde

ImageTemplatePropertiesErrorHandling

Nom	Description	Valeur
onCustomizerError	S’il existe une erreur de personnalisateur et que ce champ est défini sur « nettoyage », la machine virtuelle de build et les ressources réseau associées sont nettoyées. Il s’agit du comportement par défaut. S’il existe une erreur de personnalisateur et que ce champ est défini sur « abandon », la machine virtuelle de build est conservée.	'abandon' 'cleanup'
onValidationError	S’il existe une erreur de validation et que ce champ est défini sur « nettoyage », la machine virtuelle de build et les ressources réseau associées sont nettoyées. Il s’agit du comportement par défaut. S’il existe une erreur de validation et que ce champ est défini sur « abandon », la machine virtuelle de build est conservée.	'abandon' 'cleanup'

ImageTemplatePropertiesOptimize

Nom	Description	Valeur
vmBoot	L’optimisation est appliquée à l’image pour un démarrage de machine virtuelle plus rapide.	ImageTemplatePropertiesOptimizeVmBoot

ImageTemplatePropertiesOptimizeVmBoot

Nom	Description	Valeur
état	L’activation de ce champ améliore le temps de démarrage de la machine virtuelle en optimisant la sortie finale de l’image personnalisée.	'Désactivé' 'Activé'

ImageTemplateSource

Nom	Description	Valeur
type	Définir le type d’objet	ManagedImage PlatformImage sharedImageVersion (obligatoire)

ImageTemplateManagedImageSource

Nom	Description	Valeur
type	Spécifie le type d’image source à utiliser.	'ManagedImage' (obligatoire)
imageId	ID de ressource ARM de l’image managée dans l’abonnement client	chaîne (obligatoire)

ImageTemplatePlatformImageSource

Nom	Description	Valeur
type	Spécifie le type d’image source à utiliser.	'PlatformImage' (obligatoire)
offrir	Offre d’image à partir des images de la galerie Azure .	corde
planInfo	Configuration facultative du plan d’achat pour l’image de plateforme.	PlatformImagePurchasePlan
éditeur	Éditeur d’images dans Azure Gallery Images.	corde
Sku	Référence sku d’image à partir des images de la galerie Azure .	corde
Version	Version d’image à partir des images de la galerie Azure . Si « latest » est spécifié ici, la version est évaluée lorsque la build de l’image a lieu, et non lorsque le modèle est envoyé.	corde

PlatformImagePurchasePlan

Nom	Description	Valeur
planName	Nom du plan d’achat.	chaîne (obligatoire)
planProduct	Produit du plan d’achat.	chaîne (obligatoire)
planPublisher	Éditeur du plan d’achat.	chaîne (obligatoire)

ImageTemplateSharedImageVersionSource

Nom	Description	Valeur
type	Spécifie le type d’image source à utiliser.	'SharedImageVersion' (obligatoire)
imageVersionId	ID de ressource ARM de la version de l’image. Lorsque le nom de la version de l’image est « le plus récent », la version est évaluée lorsque la build de l’image a lieu.	chaîne (obligatoire)

ImageTemplatePropertiesValidate

Nom	Description	Valeur
continueDistributeOnFailure	Si la validation échoue et que ce champ a la valeur false, les images de sortie ne sont pas distribuées. Il s’agit du comportement par défaut. Si la validation échoue et que ce champ est défini sur true, les images de sortie sont toujours distribuées. Utilisez cette option avec précaution, car cela peut entraîner la distribution d’images incorrectes pour une utilisation. Dans les deux cas (true ou false), l’exécution de l’image de bout en bout est signalée comme ayant échoué en cas d’échec de validation. [Remarque : Ce champ n’a aucun effet si la validation réussit.]	Bool
inVMValidations	Liste des validations à effectuer.	ImageTemplateInVMValidator[]
sourceValidationOnly	Si ce champ est défini sur true, l’image spécifiée dans la section « source » est directement validée. Aucune build distincte n’est exécutée pour générer, puis valider une image personnalisée.	Bool

ImageTemplateInVMValidator

Nom	Description	Valeur
nom	Nom convivial pour fournir un contexte sur ce que fait cette étape de validation	corde
type	Définir le type d’objet	fichier PowerShell Shell (obligatoire)

ImageTemplateFileValidator

Nom	Description	Valeur
type	Type de validation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être la validation de l’interpréteur de commandes	'File' (obligatoire)
destination	Chemin absolu d’un fichier (avec des structures de répertoires imbriquées déjà créées) dans lequel le fichier (à partir de sourceUri) sera chargé dans la machine virtuelle	corde
sha256Checksum	Somme de contrôle SHA256 du fichier fourni dans le champ sourceUri ci-dessus	corde
sourceUri	URI du fichier à charger sur la machine virtuelle pour validation. Il peut s’agir d’un lien github, d’UN URI de stockage Azure (autorisé ou SAP), etc.	corde

ImageTemplatePowerShellValidator

Nom	Description	Valeur
type	Type de validation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être la validation de l’interpréteur de commandes	'PowerShell' (obligatoire)
Inline	Tableau de commandes PowerShell à exécuter	string[]
runAsSystem	Si spécifié, le script PowerShell est exécuté avec des privilèges élevés à l’aide de l’utilisateur du système local. Ne peut être vrai que lorsque le champ runElevated ci-dessus a la valeur true.	Bool
runElevated	Si spécifié, le script PowerShell est exécuté avec des privilèges élevés	Bool
scriptUri	URI du script PowerShell à exécuter pour la validation. Il peut s’agir d’un lien github, d’UN URI de stockage Azure, etc.	corde
sha256Checksum	Somme de contrôle SHA256 du script Power Shell fourni dans le champ scriptUri ci-dessus	corde
validExitCodes	Codes de sortie valides pour le script PowerShell. [Par défaut : 0]	int[]

ImageTemplateShellValidator

Nom	Description	Valeur
type	Type de validation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être la validation de l’interpréteur de commandes	'Shell' (obligatoire)
Inline	Tableau de commandes shell à exécuter	string[]
scriptUri	URI du script shell à exécuter pour la validation. Il peut s’agir d’un lien github, d’UN URI de stockage Azure, etc.	corde
sha256Checksum	Somme de contrôle SHA256 du script shell fournie dans le champ scriptUri	corde

ImageTemplateVmProfile

Nom	Description	Valeur
osDiskSizeGB	Taille du disque du système d’exploitation en Go. Omettez ou spécifiez 0 pour utiliser la taille de disque du système d’exploitation par défaut d’Azure.	Int Contraintes: Valeur minimale = 0
userAssignedIdentities	Tableau facultatif d’ID de ressources des identités managées affectées par l’utilisateur à configurer sur la machine virtuelle de build et la machine virtuelle de validation. Cela peut inclure l’identité du modèle d’image.	string[]
vmSize	Taille de la machine virtuelle utilisée pour générer, personnaliser et capturer des images. Omettez ou spécifiez une chaîne vide pour utiliser la valeur par défaut (Standard_D1_v2 pour les images Gen1 et Standard_D2ds_v4 pour les images Gen2).	corde
vnetConfig	Configuration facultative du réseau virtuel à utiliser pour déployer la machine virtuelle de build et la machine virtuelle de validation dans. Omettez si aucun réseau virtuel spécifique ne doit être utilisé.	VirtualNetworkConfig

VirtualNetworkConfig

Nom	Description	Valeur
containerInstanceSubnetId	ID de ressource d’un sous-réseau préexistant sur lequel Azure Container Instance sera déployé pour les builds isolées. Ce champ peut être spécifié uniquement si `subnetId` est également spécifié et doit se trouver sur le même réseau virtuel que le sous-réseau spécifié dans `subnetId`.	corde
proxyVmSize	Taille de la machine virtuelle proxy utilisée pour passer le trafic vers la machine virtuelle de build et la machine virtuelle de validation. Cela ne doit pas être spécifié si `containerInstanceSubnetId` est spécifié, car aucune machine virtuelle proxy n’est déployée dans ce cas. Omettez ou spécifiez une chaîne vide pour utiliser la valeur par défaut (Standard_A1_v2).	corde
subnetId	ID de ressource d’un sous-réseau préexistant sur lequel la machine virtuelle de build et la machine virtuelle de validation seront déployées	corde

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle	Description
Azure Image Builder avec azure Windows Baseline	Crée un environnement Azure Image Builder et génère une image Windows Server avec les dernières mises à jour Windows et la base de référence Azure Windows appliquée.
configurer le service Dev Box	Ce modèle créerait toutes les ressources d’administration Dev Box en fonction du guide de démarrage rapide de Dev Box (https://video2.skills-academy.com/azure/dev-box/quickstart-create-dev-box). Vous pouvez afficher toutes les ressources créées ou accéder directement à DevPortal.microsoft.com pour créer votre première zone de développement.

Définition de ressource de modèle ARM

Le type de ressource imageTemplates peut être déployé avec des opérations qui ciblent :

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.VirtualMachineImages/imageTemplates, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.VirtualMachineImages/imageTemplates",
  "apiVersion": "2024-02-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "autoRun": {
      "state": "string"
    },
    "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
      }
    ],
    "errorHandling": {
      "onCustomizerError": "string",
      "onValidationError": "string"
    },
    "managedResourceTags": {},
    "optimize": {
      "vmBoot": {
        "state": "string"
      }
    },
    "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": {
        "containerInstanceSubnetId": "string",
        "proxyVmSize": "string",
        "subnetId": "string"
      }
    }
  }
}

Objets ImageTemplateCustomizer

Définissez le type propriété pour spécifier le type d’objet.

Pour fichier, utilisez :

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

Pour PowerShell, utilisez :

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

Pour Shell, utilisez :

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

Pour windowsRestart, utilisez :

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

Pour WindowsUpdate, utilisez :

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

Objets ImageTemplateDistributor

Définissez le type propriété pour spécifier le type d’objet.

Pour ManagedImage, utilisez :

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

Pour SharedImage, utilisez :

  "type": "SharedImage",
  "excludeFromLatest": "bool",
  "galleryImageId": "string",
  "replicationRegions": [ "string" ],
  "storageAccountType": "string",
  "targetRegions": [
    {
      "name": "string",
      "replicaCount": "int",
      "storageAccountType": "string"
    }
  ],
  "versioning": {
    "scheme": "string"
    // For remaining properties, see DistributeVersioner objects
  }

Pour de disque dur virtuel, utilisez :

  "type": "VHD",
  "uri": "string"

Objets DistributeVersioner

Définissez le schéma propriété pour spécifier le type d’objet.

Pour dernière, utilisez :

  "scheme": "Latest",
  "major": "int"

Pour source, utilisez :

  "scheme": "Source"

Objets ImageTemplateSource

Définissez le type propriété pour spécifier le type d’objet.

Pour ManagedImage, utilisez :

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

Pour PlatformImage, utilisez :

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

Pour SharedImageVersion, utilisez :

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

Objets ImageTemplateInVMValidator

Définissez le type propriété pour spécifier le type d’objet.

Pour fichier, utilisez :

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

Pour PowerShell, utilisez :

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

Pour Shell, utilisez :

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

Valeurs de propriété

imageTemplates

Nom	Description	Valeur
type	Type de ressource	'Microsoft.VirtualMachineImages/imageTemplates'
apiVersion	Version de l’API de ressource	'2024-02-01'
nom	Nom de la ressource	chaîne (obligatoire)
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
étiquettes	Balises de ressource.	Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
identité	Identité du modèle d’image, s’il est configuré.	ImageTemplateIdentity (obligatoire)
Propriétés	Propriétés du modèle d’image	ImageTemplateProperties

ImageTemplateIdentity

Nom	Description	Valeur
type	Type d’identité utilisé pour le modèle d’image. Le type « None » supprime toutes les identités du modèle d’image.	'None' 'UserAssigned'
userAssignedIdentities	Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.	UserAssignedIdentities

UserAssignedIdentities

Nom	Description	Valeur
{propriété personnalisée}		UserAssignedIdentity

UserAssignedIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

ImageTemplateProperties

Nom	Description	Valeur
autoRun	Indique si le modèle d’image doit être exécuté automatiquement lors de la création ou de la mise à jour du modèle.	ImageTemplateAutoRun
buildTimeoutInMinutes	Durée maximale d’attente lors de la création du modèle d’image (inclut toutes les personnalisations, l’optimisation, les validations et les distributions). Omettez ou spécifiez 0 pour utiliser la valeur par défaut (4 heures).	Int Contraintes: Valeur minimale = 0 Valeur maximale = 960
Personnaliser	Spécifie les propriétés utilisées pour décrire les étapes de personnalisation de l’image, telles que la source d’image, etc.	ImageTemplateCustomizer[]
distribuer	Cible de distribution vers laquelle la sortie de l’image doit être générée.	ImageTemplateDistributor[] (obligatoire)
errorHandling	Options de gestion des erreurs lors d’une défaillance de build	ImageTemplatePropertiesErrorHandling
managedResourceTags	Balises qui seront appliquées au groupe de ressources et/ou aux ressources créées par le service.	objet
optimiser	Spécifie l’optimisation à effectuer sur l’image.	ImageTemplatePropertiesOptimize
source	Spécifie les propriétés utilisées pour décrire l’image source.	ImageTemplateSource (obligatoire)
stagingResourceGroup	ID de groupe de ressources intermédiaires dans le même abonnement que le modèle d’image qui sera utilisé pour générer l’image. Si ce champ est vide, un groupe de ressources avec un nom aléatoire est créé. Si le groupe de ressources spécifié dans ce champ n’existe pas, il est créé avec le même nom. Si le groupe de ressources spécifié existe, il doit être vide et dans la même région que le modèle d’image. Le groupe de ressources créé est supprimé lors de la suppression du modèle si ce champ est vide ou si le groupe de ressources spécifié n’existe pas, mais si le groupe de ressources spécifié existe, les ressources créées dans le groupe de ressources sont supprimées pendant la suppression du modèle et le groupe de ressources lui-même reste.	corde
valider	Options de configuration et liste des validations à effectuer sur l’image résultante.	ImageTemplatePropertiesValidate
vmProfile	Décrit comment la machine virtuelle est configurée pour générer des images	ImageTemplateVmProfile

ImageTemplateAutoRun

Nom	Description	Valeur
état	L’activation de ce champ déclenche une génération automatique sur la création ou la mise à jour du modèle d’image.	'Désactivé' 'Activé'

ImageTemplateCustomizer

Nom	Description	Valeur
nom	Nom convivial pour fournir un contexte sur ce que fait cette étape de personnalisation	corde
type	Définir le type d’objet	fichier PowerShell Shell WindowsRestart windowsUpdate (obligatoire)

ImageTemplateFileCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	'File' (obligatoire)
destination	Chemin absolu d’un fichier (avec des structures de répertoires imbriquées déjà créées) dans lequel le fichier (à partir de sourceUri) sera chargé dans la machine virtuelle	corde
sha256Checksum	Somme de contrôle SHA256 du fichier fourni dans le champ sourceUri ci-dessus	corde
sourceUri	URI du fichier à charger pour personnaliser la machine virtuelle. Il peut s’agir d’un lien github, d’UN URI SAP pour stockage Azure, etc.	corde

ImageTemplatePowerShellCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	'PowerShell' (obligatoire)
Inline	Tableau de commandes PowerShell à exécuter	string[]
runAsSystem	Si spécifié, le script PowerShell est exécuté avec des privilèges élevés à l’aide de l’utilisateur du système local. Ne peut être vrai que lorsque le champ runElevated ci-dessus a la valeur true.	Bool
runElevated	Si spécifié, le script PowerShell est exécuté avec des privilèges élevés	Bool
scriptUri	URI du script PowerShell à exécuter pour la personnalisation. Il peut s’agir d’un lien github, d’UN URI SAP pour stockage Azure, etc.	corde
sha256Checksum	Somme de contrôle SHA256 du script Power Shell fourni dans le champ scriptUri ci-dessus	corde
validExitCodes	Codes de sortie valides pour le script PowerShell. [Par défaut : 0]	int[]

ImageTemplateShellCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	'Shell' (obligatoire)
Inline	Tableau de commandes shell à exécuter	string[]
scriptUri	URI du script shell à exécuter pour la personnalisation. Il peut s’agir d’un lien github, d’UN URI SAP pour stockage Azure, etc.	corde
sha256Checksum	Somme de contrôle SHA256 du script shell fournie dans le champ scriptUri	corde

ImageTemplateRestartCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	'WindowsRestart' (obligatoire)
restartCheckCommand	Commande pour vérifier si le redémarrage a réussi [Valeur par défaut : '']	corde
restartCommand	Commande pour exécuter le redémarrage [Par défaut : 'shutdown /r /f /t 0 /c « packer restart"']	corde
restartTimeout	Délai de redémarrage spécifié sous la forme d’une chaîne de magnitude et d’unité, par exemple « 5 m » (5 minutes) ou « 2h » (2 heures) [Valeur par défaut : « 5m » ]	corde

ImageTemplateWindowsUpdateCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	'WindowsUpdate' (obligatoire)
Filtres	Tableau de filtres pour sélectionner les mises à jour à appliquer. Omettez ou spécifiez un tableau vide pour utiliser la valeur par défaut (aucun filtre). Reportez-vous au lien ci-dessus pour obtenir des exemples et une description détaillée de ce champ.	string[]
searchCriteria	Critères de recherche des mises à jour. Omettez ou spécifiez une chaîne vide pour utiliser la valeur par défaut (recherche tout). Reportez-vous au lien ci-dessus pour obtenir des exemples et une description détaillée de ce champ.	corde
updateLimit	Nombre maximal de mises à jour à appliquer à la fois. Omettez ou spécifiez 0 pour utiliser la valeur par défaut (1000)	Int Contraintes: Valeur minimale = 0

ImageTemplateDistributor

Nom	Description	Valeur
artifactTags	Balises qui seront appliquées à l’artefact une fois qu’il a été créé/mis à jour par le serveur de distribution.	objet
runOutputName	Nom à utiliser pour le RunOutput associé.	chaîne (obligatoire) Contraintes: Modèle = `^[A-Za-z0-9-_.]{1,64}$`
type	Définir le type d’objet	ManagedImage SharedImage disque dur virtuel (obligatoire)

ImageTemplateManagedImageDistributor

Nom	Description	Valeur
type	Type de distribution.	'ManagedImage' (obligatoire)
imageId	ID de ressource de l’image de disque managé	chaîne (obligatoire)
emplacement	Emplacement Azure de l’image, doit correspondre si l’image existe déjà	chaîne (obligatoire)

ImageTemplateSharedImageDistributor

Nom	Description	Valeur
type	Type de distribution.	'SharedImage' (obligatoire)
excludeFromLatest	Indicateur qui indique si la version de l’image créée doit être exclue de la dernière version. Omettez d’utiliser la valeur par défaut (false).	Bool
galleryImageId	ID de ressource de l’image de la galerie de calcul Azure	chaîne (obligatoire)
replicationRegions	[Déconseillé] Liste des régions vers laquelle l’image sera répliquée. Cette liste ne peut être spécifiée que si targetRegions n’est pas spécifié. Ce champ est déconseillé : utilisez plutôt targetRegions.	string[]
storageAccountType	[Déconseillé] Type de compte de stockage à utiliser pour stocker l’image partagée. Omettez d’utiliser la valeur par défaut (Standard_LRS). Ce champ ne peut être spécifié que si replicationRegions est spécifié. Ce champ est déconseillé : utilisez plutôt targetRegions.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'
targetRegions	Régions cibles vers lesquelles la version d’image distribuée sera répliquée. Cet objet remplace replicationRegions et peut être spécifié uniquement si replicationRegions n’est pas spécifié.	TargetRegion[]
contrôle de version	Décrit comment générer un nouveau numéro de version x.y.z pour la distribution.	DistributeVersioner

TargetRegion

Nom	Description	Valeur
nom	Nom de la région.	chaîne (obligatoire)
replicaCount	Nombre de réplicas de la version d’image à créer dans cette région. Omettez d’utiliser la valeur par défaut (1).	Int Contraintes: Valeur minimale = 1
storageAccountType	Spécifie le type de compte de stockage à utiliser pour stocker l’image dans cette région. Omettez d’utiliser la valeur par défaut (Standard_LRS).	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

DistributeVersioner

Nom	Description	Valeur
schéma	Définir le type d’objet	dernière source (obligatoire)

DistributeVersionerLatest

Nom	Description	Valeur
schéma	Schéma de numérotation de version à utiliser.	'Latest' (obligatoire)
majeur	Version principale du numéro de version généré. Déterminez ce qui est « le plus récent » en fonction des versions avec cette valeur comme version principale. -1 équivaut à le laisser non défini.	Int

DistributeVersionerSource

Nom	Description	Valeur
schéma	Schéma de numérotation de version à utiliser.	'Source' (obligatoire)

ImageTemplateVhdDistributor

Nom	Description	Valeur
type	Type de distribution.	'VHD' (obligatoire)
URI	URI de stockage Azure facultatif pour l’objet blob de disque dur virtuel distribué. Omettez d’utiliser la chaîne par défaut (chaîne vide) dans laquelle le disque dur virtuel serait publié sur le compte de stockage dans le groupe de ressources intermédiaire.	corde

ImageTemplatePropertiesErrorHandling

Nom	Description	Valeur
onCustomizerError	S’il existe une erreur de personnalisateur et que ce champ est défini sur « nettoyage », la machine virtuelle de build et les ressources réseau associées sont nettoyées. Il s’agit du comportement par défaut. S’il existe une erreur de personnalisateur et que ce champ est défini sur « abandon », la machine virtuelle de build est conservée.	'abandon' 'cleanup'
onValidationError	S’il existe une erreur de validation et que ce champ est défini sur « nettoyage », la machine virtuelle de build et les ressources réseau associées sont nettoyées. Il s’agit du comportement par défaut. S’il existe une erreur de validation et que ce champ est défini sur « abandon », la machine virtuelle de build est conservée.	'abandon' 'cleanup'

ImageTemplatePropertiesOptimize

Nom	Description	Valeur
vmBoot	L’optimisation est appliquée à l’image pour un démarrage de machine virtuelle plus rapide.	ImageTemplatePropertiesOptimizeVmBoot

ImageTemplatePropertiesOptimizeVmBoot

Nom	Description	Valeur
état	L’activation de ce champ améliore le temps de démarrage de la machine virtuelle en optimisant la sortie finale de l’image personnalisée.	'Désactivé' 'Activé'

ImageTemplateSource

Nom	Description	Valeur
type	Définir le type d’objet	ManagedImage PlatformImage sharedImageVersion (obligatoire)

ImageTemplateManagedImageSource

Nom	Description	Valeur
type	Spécifie le type d’image source à utiliser.	'ManagedImage' (obligatoire)
imageId	ID de ressource ARM de l’image managée dans l’abonnement client	chaîne (obligatoire)

ImageTemplatePlatformImageSource

Nom	Description	Valeur
type	Spécifie le type d’image source à utiliser.	'PlatformImage' (obligatoire)
offrir	Offre d’image à partir des images de la galerie Azure .	corde
planInfo	Configuration facultative du plan d’achat pour l’image de plateforme.	PlatformImagePurchasePlan
éditeur	Éditeur d’images dans Azure Gallery Images.	corde
Sku	Référence sku d’image à partir des images de la galerie Azure .	corde
Version	Version d’image à partir des images de la galerie Azure . Si « latest » est spécifié ici, la version est évaluée lorsque la build de l’image a lieu, et non lorsque le modèle est envoyé.	corde

PlatformImagePurchasePlan

Nom	Description	Valeur
planName	Nom du plan d’achat.	chaîne (obligatoire)
planProduct	Produit du plan d’achat.	chaîne (obligatoire)
planPublisher	Éditeur du plan d’achat.	chaîne (obligatoire)

ImageTemplateSharedImageVersionSource

Nom	Description	Valeur
type	Spécifie le type d’image source à utiliser.	'SharedImageVersion' (obligatoire)
imageVersionId	ID de ressource ARM de la version de l’image. Lorsque le nom de la version de l’image est « le plus récent », la version est évaluée lorsque la build de l’image a lieu.	chaîne (obligatoire)

ImageTemplatePropertiesValidate

Nom	Description	Valeur
continueDistributeOnFailure	Si la validation échoue et que ce champ a la valeur false, les images de sortie ne sont pas distribuées. Il s’agit du comportement par défaut. Si la validation échoue et que ce champ est défini sur true, les images de sortie sont toujours distribuées. Utilisez cette option avec précaution, car cela peut entraîner la distribution d’images incorrectes pour une utilisation. Dans les deux cas (true ou false), l’exécution de l’image de bout en bout est signalée comme ayant échoué en cas d’échec de validation. [Remarque : Ce champ n’a aucun effet si la validation réussit.]	Bool
inVMValidations	Liste des validations à effectuer.	ImageTemplateInVMValidator[]
sourceValidationOnly	Si ce champ est défini sur true, l’image spécifiée dans la section « source » est directement validée. Aucune build distincte n’est exécutée pour générer, puis valider une image personnalisée.	Bool

ImageTemplateInVMValidator

Nom	Description	Valeur
nom	Nom convivial pour fournir un contexte sur ce que fait cette étape de validation	corde
type	Définir le type d’objet	fichier PowerShell Shell (obligatoire)

ImageTemplateFileValidator

Nom	Description	Valeur
type	Type de validation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être la validation de l’interpréteur de commandes	'File' (obligatoire)
destination	Chemin absolu d’un fichier (avec des structures de répertoires imbriquées déjà créées) dans lequel le fichier (à partir de sourceUri) sera chargé dans la machine virtuelle	corde
sha256Checksum	Somme de contrôle SHA256 du fichier fourni dans le champ sourceUri ci-dessus	corde
sourceUri	URI du fichier à charger sur la machine virtuelle pour validation. Il peut s’agir d’un lien github, d’UN URI de stockage Azure (autorisé ou SAP), etc.	corde

ImageTemplatePowerShellValidator

Nom	Description	Valeur
type	Type de validation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être la validation de l’interpréteur de commandes	'PowerShell' (obligatoire)
Inline	Tableau de commandes PowerShell à exécuter	string[]
runAsSystem	Si spécifié, le script PowerShell est exécuté avec des privilèges élevés à l’aide de l’utilisateur du système local. Ne peut être vrai que lorsque le champ runElevated ci-dessus a la valeur true.	Bool
runElevated	Si spécifié, le script PowerShell est exécuté avec des privilèges élevés	Bool
scriptUri	URI du script PowerShell à exécuter pour la validation. Il peut s’agir d’un lien github, d’UN URI de stockage Azure, etc.	corde
sha256Checksum	Somme de contrôle SHA256 du script Power Shell fourni dans le champ scriptUri ci-dessus	corde
validExitCodes	Codes de sortie valides pour le script PowerShell. [Par défaut : 0]	int[]

ImageTemplateShellValidator

Nom	Description	Valeur
type	Type de validation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être la validation de l’interpréteur de commandes	'Shell' (obligatoire)
Inline	Tableau de commandes shell à exécuter	string[]
scriptUri	URI du script shell à exécuter pour la validation. Il peut s’agir d’un lien github, d’UN URI de stockage Azure, etc.	corde
sha256Checksum	Somme de contrôle SHA256 du script shell fournie dans le champ scriptUri	corde

ImageTemplateVmProfile

Nom	Description	Valeur
osDiskSizeGB	Taille du disque du système d’exploitation en Go. Omettez ou spécifiez 0 pour utiliser la taille de disque du système d’exploitation par défaut d’Azure.	Int Contraintes: Valeur minimale = 0
userAssignedIdentities	Tableau facultatif d’ID de ressources des identités managées affectées par l’utilisateur à configurer sur la machine virtuelle de build et la machine virtuelle de validation. Cela peut inclure l’identité du modèle d’image.	string[]
vmSize	Taille de la machine virtuelle utilisée pour générer, personnaliser et capturer des images. Omettez ou spécifiez une chaîne vide pour utiliser la valeur par défaut (Standard_D1_v2 pour les images Gen1 et Standard_D2ds_v4 pour les images Gen2).	corde
vnetConfig	Configuration facultative du réseau virtuel à utiliser pour déployer la machine virtuelle de build et la machine virtuelle de validation dans. Omettez si aucun réseau virtuel spécifique ne doit être utilisé.	VirtualNetworkConfig

VirtualNetworkConfig

Nom	Description	Valeur
containerInstanceSubnetId	ID de ressource d’un sous-réseau préexistant sur lequel Azure Container Instance sera déployé pour les builds isolées. Ce champ peut être spécifié uniquement si `subnetId` est également spécifié et doit se trouver sur le même réseau virtuel que le sous-réseau spécifié dans `subnetId`.	corde
proxyVmSize	Taille de la machine virtuelle proxy utilisée pour passer le trafic vers la machine virtuelle de build et la machine virtuelle de validation. Cela ne doit pas être spécifié si `containerInstanceSubnetId` est spécifié, car aucune machine virtuelle proxy n’est déployée dans ce cas. Omettez ou spécifiez une chaîne vide pour utiliser la valeur par défaut (Standard_A1_v2).	corde
subnetId	ID de ressource d’un sous-réseau préexistant sur lequel la machine virtuelle de build et la machine virtuelle de validation seront déployées	corde

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle	Description
Azure Image Builder avec azure Windows Baseline	Crée un environnement Azure Image Builder et génère une image Windows Server avec les dernières mises à jour Windows et la base de référence Azure Windows appliquée.
configurer le service Dev Box	Ce modèle créerait toutes les ressources d’administration Dev Box en fonction du guide de démarrage rapide de Dev Box (https://video2.skills-academy.com/azure/dev-box/quickstart-create-dev-box). Vous pouvez afficher toutes les ressources créées ou accéder directement à DevPortal.microsoft.com pour créer votre première zone de développement.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource imageTemplates peut être déployé avec des opérations qui ciblent :

groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.VirtualMachineImages/imageTemplates, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.VirtualMachineImages/imageTemplates@2024-02-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "UserAssigned"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      autoRun = {
        state = "string"
      }
      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
        }
      ]
      errorHandling = {
        onCustomizerError = "string"
        onValidationError = "string"
      }
      managedResourceTags = {}
      optimize = {
        vmBoot = {
          state = "string"
        }
      }
      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 = {
          containerInstanceSubnetId = "string"
          proxyVmSize = "string"
          subnetId = "string"
        }
      }
    }
  })
}

Objets ImageTemplateCustomizer

Définissez le type propriété pour spécifier le type d’objet.

Pour fichier, utilisez :

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

Pour PowerShell, utilisez :

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

Pour Shell, utilisez :

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

Pour windowsRestart, utilisez :

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

Pour WindowsUpdate, utilisez :

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

Objets ImageTemplateDistributor

Définissez le type propriété pour spécifier le type d’objet.

Pour ManagedImage, utilisez :

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

Pour SharedImage, utilisez :

  type = "SharedImage"
  excludeFromLatest = bool
  galleryImageId = "string"
  replicationRegions = [
    "string"
  ]
  storageAccountType = "string"
  targetRegions = [
    {
      name = "string"
      replicaCount = int
      storageAccountType = "string"
    }
  ]
  versioning = {
    scheme = "string"
    // For remaining properties, see DistributeVersioner objects
  }

Pour de disque dur virtuel, utilisez :

  type = "VHD"
  uri = "string"

Objets DistributeVersioner

Définissez le schéma propriété pour spécifier le type d’objet.

Pour dernière, utilisez :

  scheme = "Latest"
  major = int

Pour source, utilisez :

  scheme = "Source"

Objets ImageTemplateSource

Définissez le type propriété pour spécifier le type d’objet.

Pour ManagedImage, utilisez :

  type = "ManagedImage"
  imageId = "string"

Pour PlatformImage, utilisez :

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

Pour SharedImageVersion, utilisez :

  type = "SharedImageVersion"
  imageVersionId = "string"

Objets ImageTemplateInVMValidator

Définissez le type propriété pour spécifier le type d’objet.

Pour fichier, utilisez :

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

Pour PowerShell, utilisez :

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

Pour Shell, utilisez :

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

Valeurs de propriété

imageTemplates

Nom	Description	Valeur
type	Type de ressource	« Microsoft.VirtualMachineImages/imageTemplates@2024-02-01 »
nom	Nom de la ressource	chaîne (obligatoire)
emplacement	Emplacement géographique où réside la ressource	chaîne (obligatoire)
parent_id	Pour effectuer un déploiement sur un groupe de ressources, utilisez l’ID de ce groupe de ressources.	chaîne (obligatoire)
étiquettes	Balises de ressource.	Dictionnaire de noms et de valeurs d’étiquettes.
identité	Identité du modèle d’image, s’il est configuré.	ImageTemplateIdentity (obligatoire)
Propriétés	Propriétés du modèle d’image	ImageTemplateProperties

ImageTemplateIdentity

Nom	Description	Valeur
type	Type d’identité utilisé pour le modèle d’image. Le type « None » supprime toutes les identités du modèle d’image.	« UserAssigned »
identity_ids	Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.	Tableau d’ID d’identité utilisateur.

UserAssignedIdentities

Nom	Description	Valeur
{propriété personnalisée}		UserAssignedIdentity

UserAssignedIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

ImageTemplateProperties

Nom	Description	Valeur
autoRun	Indique si le modèle d’image doit être exécuté automatiquement lors de la création ou de la mise à jour du modèle.	ImageTemplateAutoRun
buildTimeoutInMinutes	Durée maximale d’attente lors de la création du modèle d’image (inclut toutes les personnalisations, l’optimisation, les validations et les distributions). Omettez ou spécifiez 0 pour utiliser la valeur par défaut (4 heures).	Int Contraintes: Valeur minimale = 0 Valeur maximale = 960
Personnaliser	Spécifie les propriétés utilisées pour décrire les étapes de personnalisation de l’image, telles que la source d’image, etc.	ImageTemplateCustomizer[]
distribuer	Cible de distribution vers laquelle la sortie de l’image doit être générée.	ImageTemplateDistributor[] (obligatoire)
errorHandling	Options de gestion des erreurs lors d’une défaillance de build	ImageTemplatePropertiesErrorHandling
managedResourceTags	Balises qui seront appliquées au groupe de ressources et/ou aux ressources créées par le service.	objet
optimiser	Spécifie l’optimisation à effectuer sur l’image.	ImageTemplatePropertiesOptimize
source	Spécifie les propriétés utilisées pour décrire l’image source.	ImageTemplateSource (obligatoire)
stagingResourceGroup	ID de groupe de ressources intermédiaires dans le même abonnement que le modèle d’image qui sera utilisé pour générer l’image. Si ce champ est vide, un groupe de ressources avec un nom aléatoire est créé. Si le groupe de ressources spécifié dans ce champ n’existe pas, il est créé avec le même nom. Si le groupe de ressources spécifié existe, il doit être vide et dans la même région que le modèle d’image. Le groupe de ressources créé est supprimé lors de la suppression du modèle si ce champ est vide ou si le groupe de ressources spécifié n’existe pas, mais si le groupe de ressources spécifié existe, les ressources créées dans le groupe de ressources sont supprimées pendant la suppression du modèle et le groupe de ressources lui-même reste.	corde
valider	Options de configuration et liste des validations à effectuer sur l’image résultante.	ImageTemplatePropertiesValidate
vmProfile	Décrit comment la machine virtuelle est configurée pour générer des images	ImageTemplateVmProfile

ImageTemplateAutoRun

Nom	Description	Valeur
état	L’activation de ce champ déclenche une génération automatique sur la création ou la mise à jour du modèle d’image.	« Désactivé » « Activé »

ImageTemplateCustomizer

Nom	Description	Valeur
nom	Nom convivial pour fournir un contexte sur ce que fait cette étape de personnalisation	corde
type	Définir le type d’objet	fichier PowerShell Shell WindowsRestart windowsUpdate (obligatoire)

ImageTemplateFileCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	« Fichier » (obligatoire)
destination	Chemin absolu d’un fichier (avec des structures de répertoires imbriquées déjà créées) dans lequel le fichier (à partir de sourceUri) sera chargé dans la machine virtuelle	corde
sha256Checksum	Somme de contrôle SHA256 du fichier fourni dans le champ sourceUri ci-dessus	corde
sourceUri	URI du fichier à charger pour personnaliser la machine virtuelle. Il peut s’agir d’un lien github, d’UN URI SAP pour stockage Azure, etc.	corde

ImageTemplatePowerShellCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	« PowerShell » (obligatoire)
Inline	Tableau de commandes PowerShell à exécuter	string[]
runAsSystem	Si spécifié, le script PowerShell est exécuté avec des privilèges élevés à l’aide de l’utilisateur du système local. Ne peut être vrai que lorsque le champ runElevated ci-dessus a la valeur true.	Bool
runElevated	Si spécifié, le script PowerShell est exécuté avec des privilèges élevés	Bool
scriptUri	URI du script PowerShell à exécuter pour la personnalisation. Il peut s’agir d’un lien github, d’UN URI SAP pour stockage Azure, etc.	corde
sha256Checksum	Somme de contrôle SHA256 du script Power Shell fourni dans le champ scriptUri ci-dessus	corde
validExitCodes	Codes de sortie valides pour le script PowerShell. [Par défaut : 0]	int[]

ImageTemplateShellCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	« Shell » (obligatoire)
Inline	Tableau de commandes shell à exécuter	string[]
scriptUri	URI du script shell à exécuter pour la personnalisation. Il peut s’agir d’un lien github, d’UN URI SAP pour stockage Azure, etc.	corde
sha256Checksum	Somme de contrôle SHA256 du script shell fournie dans le champ scriptUri	corde

ImageTemplateRestartCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	« WindowsRestart » (obligatoire)
restartCheckCommand	Commande pour vérifier si le redémarrage a réussi [Valeur par défaut : '']	corde
restartCommand	Commande pour exécuter le redémarrage [Par défaut : 'shutdown /r /f /t 0 /c « packer restart"']	corde
restartTimeout	Délai de redémarrage spécifié sous la forme d’une chaîne de magnitude et d’unité, par exemple « 5 m » (5 minutes) ou « 2h » (2 heures) [Valeur par défaut : « 5m » ]	corde

ImageTemplateWindowsUpdateCustomizer

Nom	Description	Valeur
type	Type d’outil de personnalisation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être personnalisateur d’interpréteur de commandes	« WindowsUpdate » (obligatoire)
Filtres	Tableau de filtres pour sélectionner les mises à jour à appliquer. Omettez ou spécifiez un tableau vide pour utiliser la valeur par défaut (aucun filtre). Reportez-vous au lien ci-dessus pour obtenir des exemples et une description détaillée de ce champ.	string[]
searchCriteria	Critères de recherche des mises à jour. Omettez ou spécifiez une chaîne vide pour utiliser la valeur par défaut (recherche tout). Reportez-vous au lien ci-dessus pour obtenir des exemples et une description détaillée de ce champ.	corde
updateLimit	Nombre maximal de mises à jour à appliquer à la fois. Omettez ou spécifiez 0 pour utiliser la valeur par défaut (1000)	Int Contraintes: Valeur minimale = 0

ImageTemplateDistributor

Nom	Description	Valeur
artifactTags	Balises qui seront appliquées à l’artefact une fois qu’il a été créé/mis à jour par le serveur de distribution.	objet
runOutputName	Nom à utiliser pour le RunOutput associé.	chaîne (obligatoire) Contraintes: Modèle = `^[A-Za-z0-9-_.]{1,64}$`
type	Définir le type d’objet	ManagedImage SharedImage disque dur virtuel (obligatoire)

ImageTemplateManagedImageDistributor

Nom	Description	Valeur
type	Type de distribution.	« ManagedImage » (obligatoire)
imageId	ID de ressource de l’image de disque managé	chaîne (obligatoire)
emplacement	Emplacement Azure de l’image, doit correspondre si l’image existe déjà	chaîne (obligatoire)

ImageTemplateSharedImageDistributor

Nom	Description	Valeur
type	Type de distribution.	« SharedImage » (obligatoire)
excludeFromLatest	Indicateur qui indique si la version de l’image créée doit être exclue de la dernière version. Omettez d’utiliser la valeur par défaut (false).	Bool
galleryImageId	ID de ressource de l’image de la galerie de calcul Azure	chaîne (obligatoire)
replicationRegions	[Déconseillé] Liste des régions vers laquelle l’image sera répliquée. Cette liste ne peut être spécifiée que si targetRegions n’est pas spécifié. Ce champ est déconseillé : utilisez plutôt targetRegions.	string[]
storageAccountType	[Déconseillé] Type de compte de stockage à utiliser pour stocker l’image partagée. Omettez d’utiliser la valeur par défaut (Standard_LRS). Ce champ ne peut être spécifié que si replicationRegions est spécifié. Ce champ est déconseillé : utilisez plutôt targetRegions.	« Premium_LRS » « Standard_LRS » « Standard_ZRS »
targetRegions	Régions cibles vers lesquelles la version d’image distribuée sera répliquée. Cet objet remplace replicationRegions et peut être spécifié uniquement si replicationRegions n’est pas spécifié.	TargetRegion[]
contrôle de version	Décrit comment générer un nouveau numéro de version x.y.z pour la distribution.	DistributeVersioner

TargetRegion

Nom	Description	Valeur
nom	Nom de la région.	chaîne (obligatoire)
replicaCount	Nombre de réplicas de la version d’image à créer dans cette région. Omettez d’utiliser la valeur par défaut (1).	Int Contraintes: Valeur minimale = 1
storageAccountType	Spécifie le type de compte de stockage à utiliser pour stocker l’image dans cette région. Omettez d’utiliser la valeur par défaut (Standard_LRS).	« Premium_LRS » « Standard_LRS » « Standard_ZRS »

DistributeVersioner

Nom	Description	Valeur
schéma	Définir le type d’objet	dernière source (obligatoire)

DistributeVersionerLatest

Nom	Description	Valeur
schéma	Schéma de numérotation de version à utiliser.	« Latest » (obligatoire)
majeur	Version principale du numéro de version généré. Déterminez ce qui est « le plus récent » en fonction des versions avec cette valeur comme version principale. -1 équivaut à le laisser non défini.	Int

DistributeVersionerSource

Nom	Description	Valeur
schéma	Schéma de numérotation de version à utiliser.	« Source » (obligatoire)

ImageTemplateVhdDistributor

Nom	Description	Valeur
type	Type de distribution.	« VHD » (obligatoire)
URI	URI de stockage Azure facultatif pour l’objet blob de disque dur virtuel distribué. Omettez d’utiliser la chaîne par défaut (chaîne vide) dans laquelle le disque dur virtuel serait publié sur le compte de stockage dans le groupe de ressources intermédiaire.	corde

ImageTemplatePropertiesErrorHandling

Nom	Description	Valeur
onCustomizerError	S’il existe une erreur de personnalisateur et que ce champ est défini sur « nettoyage », la machine virtuelle de build et les ressources réseau associées sont nettoyées. Il s’agit du comportement par défaut. S’il existe une erreur de personnalisateur et que ce champ est défini sur « abandon », la machine virtuelle de build est conservée.	« abandon » « nettoyage »
onValidationError	S’il existe une erreur de validation et que ce champ est défini sur « nettoyage », la machine virtuelle de build et les ressources réseau associées sont nettoyées. Il s’agit du comportement par défaut. S’il existe une erreur de validation et que ce champ est défini sur « abandon », la machine virtuelle de build est conservée.	« abandon » « nettoyage »

ImageTemplatePropertiesOptimize

Nom	Description	Valeur
vmBoot	L’optimisation est appliquée à l’image pour un démarrage de machine virtuelle plus rapide.	ImageTemplatePropertiesOptimizeVmBoot

ImageTemplatePropertiesOptimizeVmBoot

Nom	Description	Valeur
état	L’activation de ce champ améliore le temps de démarrage de la machine virtuelle en optimisant la sortie finale de l’image personnalisée.	« Désactivé » « Activé »

ImageTemplateSource

Nom	Description	Valeur
type	Définir le type d’objet	ManagedImage PlatformImage sharedImageVersion (obligatoire)

ImageTemplateManagedImageSource

Nom	Description	Valeur
type	Spécifie le type d’image source à utiliser.	« ManagedImage » (obligatoire)
imageId	ID de ressource ARM de l’image managée dans l’abonnement client	chaîne (obligatoire)

ImageTemplatePlatformImageSource

Nom	Description	Valeur
type	Spécifie le type d’image source à utiliser.	« PlatformImage » (obligatoire)
offrir	Offre d’image à partir des images de la galerie Azure .	corde
planInfo	Configuration facultative du plan d’achat pour l’image de plateforme.	PlatformImagePurchasePlan
éditeur	Éditeur d’images dans Azure Gallery Images.	corde
Sku	Référence sku d’image à partir des images de la galerie Azure .	corde
Version	Version d’image à partir des images de la galerie Azure . Si « latest » est spécifié ici, la version est évaluée lorsque la build de l’image a lieu, et non lorsque le modèle est envoyé.	corde

PlatformImagePurchasePlan

Nom	Description	Valeur
planName	Nom du plan d’achat.	chaîne (obligatoire)
planProduct	Produit du plan d’achat.	chaîne (obligatoire)
planPublisher	Éditeur du plan d’achat.	chaîne (obligatoire)

ImageTemplateSharedImageVersionSource

Nom	Description	Valeur
type	Spécifie le type d’image source à utiliser.	« SharedImageVersion » (obligatoire)
imageVersionId	ID de ressource ARM de la version de l’image. Lorsque le nom de la version de l’image est « le plus récent », la version est évaluée lorsque la build de l’image a lieu.	chaîne (obligatoire)

ImageTemplatePropertiesValidate

Nom	Description	Valeur
continueDistributeOnFailure	Si la validation échoue et que ce champ a la valeur false, les images de sortie ne sont pas distribuées. Il s’agit du comportement par défaut. Si la validation échoue et que ce champ est défini sur true, les images de sortie sont toujours distribuées. Utilisez cette option avec précaution, car cela peut entraîner la distribution d’images incorrectes pour une utilisation. Dans les deux cas (true ou false), l’exécution de l’image de bout en bout est signalée comme ayant échoué en cas d’échec de validation. [Remarque : Ce champ n’a aucun effet si la validation réussit.]	Bool
inVMValidations	Liste des validations à effectuer.	ImageTemplateInVMValidator[]
sourceValidationOnly	Si ce champ est défini sur true, l’image spécifiée dans la section « source » est directement validée. Aucune build distincte n’est exécutée pour générer, puis valider une image personnalisée.	Bool

ImageTemplateInVMValidator

Nom	Description	Valeur
nom	Nom convivial pour fournir un contexte sur ce que fait cette étape de validation	corde
type	Définir le type d’objet	fichier PowerShell Shell (obligatoire)

ImageTemplateFileValidator

Nom	Description	Valeur
type	Type de validation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être la validation de l’interpréteur de commandes	« Fichier » (obligatoire)
destination	Chemin absolu d’un fichier (avec des structures de répertoires imbriquées déjà créées) dans lequel le fichier (à partir de sourceUri) sera chargé dans la machine virtuelle	corde
sha256Checksum	Somme de contrôle SHA256 du fichier fourni dans le champ sourceUri ci-dessus	corde
sourceUri	URI du fichier à charger sur la machine virtuelle pour validation. Il peut s’agir d’un lien github, d’UN URI de stockage Azure (autorisé ou SAP), etc.	corde

ImageTemplatePowerShellValidator

Nom	Description	Valeur
type	Type de validation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être la validation de l’interpréteur de commandes	« PowerShell » (obligatoire)
Inline	Tableau de commandes PowerShell à exécuter	string[]
runAsSystem	Si spécifié, le script PowerShell est exécuté avec des privilèges élevés à l’aide de l’utilisateur du système local. Ne peut être vrai que lorsque le champ runElevated ci-dessus a la valeur true.	Bool
runElevated	Si spécifié, le script PowerShell est exécuté avec des privilèges élevés	Bool
scriptUri	URI du script PowerShell à exécuter pour la validation. Il peut s’agir d’un lien github, d’UN URI de stockage Azure, etc.	corde
sha256Checksum	Somme de contrôle SHA256 du script Power Shell fourni dans le champ scriptUri ci-dessus	corde
validExitCodes	Codes de sortie valides pour le script PowerShell. [Par défaut : 0]	int[]

ImageTemplateShellValidator

Nom	Description	Valeur
type	Type de validation que vous souhaitez utiliser sur l’image. Par exemple, « Shell » peut être la validation de l’interpréteur de commandes	« Shell » (obligatoire)
Inline	Tableau de commandes shell à exécuter	string[]
scriptUri	URI du script shell à exécuter pour la validation. Il peut s’agir d’un lien github, d’UN URI de stockage Azure, etc.	corde
sha256Checksum	Somme de contrôle SHA256 du script shell fournie dans le champ scriptUri	corde

ImageTemplateVmProfile

Nom	Description	Valeur
osDiskSizeGB	Taille du disque du système d’exploitation en Go. Omettez ou spécifiez 0 pour utiliser la taille de disque du système d’exploitation par défaut d’Azure.	Int Contraintes: Valeur minimale = 0
userAssignedIdentities	Tableau facultatif d’ID de ressources des identités managées affectées par l’utilisateur à configurer sur la machine virtuelle de build et la machine virtuelle de validation. Cela peut inclure l’identité du modèle d’image.	string[]
vmSize	Taille de la machine virtuelle utilisée pour générer, personnaliser et capturer des images. Omettez ou spécifiez une chaîne vide pour utiliser la valeur par défaut (Standard_D1_v2 pour les images Gen1 et Standard_D2ds_v4 pour les images Gen2).	corde
vnetConfig	Configuration facultative du réseau virtuel à utiliser pour déployer la machine virtuelle de build et la machine virtuelle de validation dans. Omettez si aucun réseau virtuel spécifique ne doit être utilisé.	VirtualNetworkConfig

VirtualNetworkConfig

Nom	Description	Valeur
containerInstanceSubnetId	ID de ressource d’un sous-réseau préexistant sur lequel Azure Container Instance sera déployé pour les builds isolées. Ce champ peut être spécifié uniquement si `subnetId` est également spécifié et doit se trouver sur le même réseau virtuel que le sous-réseau spécifié dans `subnetId`.	corde
proxyVmSize	Taille de la machine virtuelle proxy utilisée pour passer le trafic vers la machine virtuelle de build et la machine virtuelle de validation. Cela ne doit pas être spécifié si `containerInstanceSubnetId` est spécifié, car aucune machine virtuelle proxy n’est déployée dans ce cas. Omettez ou spécifiez une chaîne vide pour utiliser la valeur par défaut (Standard_A1_v2).	corde
subnetId	ID de ressource d’un sous-réseau préexistant sur lequel la machine virtuelle de build et la machine virtuelle de validation seront déployées	corde

Partager via

Microsoft.VirtualMachineImages imageTemplates

Définition de ressource Bicep

Format de ressource

Objets ImageTemplateCustomizer

Objets ImageTemplateDistributor

Objets DistributeVersioner

Objets ImageTemplateSource

Objets ImageTemplateInVMValidator

Valeurs de propriété

imageTemplates

ImageTemplateIdentity

UserAssignedIdentities

UserAssignedIdentity

ImageTemplateProperties

ImageTemplateAutoRun

ImageTemplateCustomizer

ImageTemplateFileCustomizer

ImageTemplatePowerShellCustomizer

ImageTemplateShellCustomizer

ImageTemplateRestartCustomizer

ImageTemplateWindowsUpdateCustomizer

ImageTemplateDistributor

ImageTemplateManagedImageDistributor

ImageTemplateSharedImageDistributor

TargetRegion

DistributeVersioner

DistributeVersionerLatest

DistributeVersionerSource

ImageTemplateVhdDistributor

ImageTemplatePropertiesErrorHandling

ImageTemplatePropertiesOptimize

ImageTemplatePropertiesOptimizeVmBoot

ImageTemplateSource

ImageTemplateManagedImageSource

ImageTemplatePlatformImageSource

PlatformImagePurchasePlan

ImageTemplateSharedImageVersionSource

ImageTemplatePropertiesValidate

ImageTemplateInVMValidator

ImageTemplateFileValidator

ImageTemplatePowerShellValidator

ImageTemplateShellValidator

ImageTemplateVmProfile

VirtualNetworkConfig

Modèles de démarrage rapide

Définition de ressource de modèle ARM

Format de ressource

Objets ImageTemplateCustomizer

Objets ImageTemplateDistributor

Objets DistributeVersioner

Objets ImageTemplateSource

Objets ImageTemplateInVMValidator

Valeurs de propriété

imageTemplates

ImageTemplateIdentity

UserAssignedIdentities

UserAssignedIdentity

ImageTemplateProperties

ImageTemplateAutoRun

ImageTemplateCustomizer

ImageTemplateFileCustomizer

ImageTemplatePowerShellCustomizer

ImageTemplateShellCustomizer

ImageTemplateRestartCustomizer

ImageTemplateWindowsUpdateCustomizer

ImageTemplateDistributor

ImageTemplateManagedImageDistributor

ImageTemplateSharedImageDistributor

TargetRegion

DistributeVersioner

DistributeVersionerLatest

DistributeVersionerSource

ImageTemplateVhdDistributor

ImageTemplatePropertiesErrorHandling

ImageTemplatePropertiesOptimize

ImageTemplatePropertiesOptimizeVmBoot

ImageTemplateSource

ImageTemplateManagedImageSource

ImageTemplatePlatformImageSource