Microsoft.VirtualMachineImages imageTemplates 2019-02-01-preview

Article
12/17/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@2019-02-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    customize: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ]
    distribute: [
      {
        artifactTags: {
          {customized property}: 'string'
        }
        runOutputName: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ]
    source: {
      type: 'string'
      // For remaining properties, see ImageTemplateSource objects
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Objets ImageTemplateCustomizer

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

Pour PowerShell, utilisez :

{
  inline: [
    'string'
  ]
  script: 'string'
  type: 'PowerShell'
  validExitCodes: [
    int
  ]
}

Pour Shell, utilisez :

{
  inline: [
    'string'
  ]
  script: 'string'
  type: 'Shell'
}

Pour windowsRestart, utilisez :

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

Objets ImageTemplateSource

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

Pour ISO, utilisez :

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

Pour ManagedImage, utilisez :

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

Pour PlatformImage, utilisez :

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

Objets ImageTemplateDistributor

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

Pour ManagedImage, utilisez :

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

Pour SharedImage, utilisez :

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

Pour de disque dur virtuel, utilisez :

{
  type: 'VHD'
}

Valeurs de propriété

ImageTemplateCustomizer

Nom	Description	Valeur
nom	Nom convivial pour fournir un contexte sur ce que fait cette étape de personnalisation	corde
type	Défini sur « PowerShell » pour le type ImageTemplatePowerShellCustomizer. Défini sur « Shell » pour le type ImageTemplateShellCustomizer. Défini sur « WindowsRestart » pour le type ImageTemplateRestartCustomizer.	'PowerShell' 'Shell' 'WindowsRestart' (obligatoire)

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.	ImageTemplateDistributorArtifactTags
runOutputName	Nom à utiliser pour le RunOutput associé.	corde Contraintes: Modèle = `^[A-Za-z0-9-_]{1,64}$` (obligatoire)
type	Défini sur « ManagedImage » pour le type ImageTemplateManagedImageDistributor. Défini sur « SharedImage » pour le type ImageTemplateSharedImageDistributor. Défini sur « VHD » pour le type ImageTemplateVhdDistributor.	'ManagedImage' 'SharedImage' 'VHD' (obligatoire)

ImageTemplateDistributorArtifactTags

Nom	Description	Valeur

ImageTemplateIsoSource

Nom	Description	Valeur
sha256Checksum	Somme de contrôle SHA256 de l’image ISO.	chaîne (obligatoire)
sourceURI	URI pour obtenir l’image ISO. Cet URI doit être accessible au fournisseur de ressources au moment de la création du modèle d’image.	chaîne (obligatoire)
type	Spécifie le type d’image source à utiliser.	'ISO' (obligatoire)

ImageTemplateManagedImageDistributor

Nom	Description	Valeur
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)
type	Type de distribution.	'ManagedImage' (obligatoire)

ImageTemplateManagedImageSource

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

ImageTemplatePlatformImageSource

Nom	Description	Valeur
offrir	Offre d’image à partir des images de la galerie Azure .	corde
éditeur	Éditeur d’images dans Azure Gallery Images.	corde
Sku	Référence sku d’image à partir des images de la galerie Azure .	corde
type	Spécifie le type d’image source à utiliser.	'PlatformImage' (obligatoire)
Version	Version d’image à partir des images de la galerie Azure .	corde

ImageTemplatePowerShellCustomizer

Nom	Description	Valeur
Inline	Tableau de commandes PowerShell à exécuter	string[]
script	Script PowerShell à exécuter pour la personnalisation. Il peut s’agir d’un lien github, d’UN URI SAP pour stockage Azure, etc.	corde
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)
validExitCodes	Codes de sortie valides pour le script PowerShell. [Par défaut : 0]	int[]

ImageTemplateProperties

Nom	Description	Valeur
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)
source	Spécifie les propriétés utilisées pour décrire l’image source.	ImageTemplateSource (obligatoire)

ImageTemplateRestartCustomizer

Nom	Description	Valeur
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
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)

ImageTemplateSharedImageDistributor

Nom	Description	Valeur
galleryImageId	ID de ressource de l’image de la galerie d’images partagées	chaîne (obligatoire)
replicationRegions		string[] (obligatoire)
type	Type de distribution.	'SharedImage' (obligatoire)

ImageTemplateShellCustomizer

Nom	Description	Valeur
Inline	Tableau de commandes shell à exécuter	string[]
script	Script shell à exécuter pour la personnalisation. Il peut s’agir d’un lien github, d’UN URI SAP pour stockage Azure, etc.	corde
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)

ImageTemplateSource

Nom	Description	Valeur
type	Défini sur « ISO » pour le type ImageTemplateIsoSource. Défini sur « ManagedImage » pour le type ImageTemplateManagedImageSource. Défini sur « PlatformImage » pour le type ImageTemplatePlatformImageSource.	'ISO' 'ManagedImage' 'PlatformImage' (obligatoire)

ImageTemplateVhdDistributor

Nom	Description	Valeur
type	Type de distribution.	'VHD' (obligatoire)