Microsoft.VirtualMachineImages imageTemplates 2019-05-01-preview

Makale
07/20/2023

Bicep kaynak tanımı

imageTemplates kaynak türü şu şekilde dağıtılabilir:

Kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.VirtualMachineImages/imageTemplates kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2019-05-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {}
  }
  properties: {
    buildTimeoutInMinutes: int
    customize: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ]
    distribute: [
      {
        artifactTags: {}
        runOutputName: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ]
    source: {
      type: 'string'
      // For remaining properties, see ImageTemplateSource objects
    }
    vmProfile: {
      vmSize: 'string'
    }
  }
}

ImageTemplateCustomizer nesneleri

nesnenin türünü belirtmek için type özelliğini ayarlayın.

Dosya için şunu kullanın:

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

PowerShell için şunu kullanın:

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

Shell için şunu kullanın:

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

WindowsRestart için şunu kullanın:

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

ImageTemplateDistributor nesneleri

nesnenin türünü belirtmek için type özelliğini ayarlayın.

ManagedImage için şunu kullanın:

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

SharedImage için şunu kullanın:

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

VHD için şunu kullanın:

  type: 'VHD'

ImageTemplateSource nesneleri

nesnenin türünü belirtmek için type özelliğini ayarlayın.

ISO için şunu kullanın:

  type: 'ISO'
  sha256Checksum: 'string'
  sourceUri: 'string'

ManagedImage için şunu kullanın:

  type: 'ManagedImage'
  imageId: 'string'

PlatformImage için şunu kullanın:

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

SharedImageVersion için şunu kullanın:

  type: 'SharedImageVersion'
  imageVersionId: 'string'

Özellik değerleri

imageTemplates

Ad	Açıklama	Değer
name	Kaynak adı	dize (gerekli)
location	Kaynak konumu	dize (gerekli)
etiketler	Kaynak etiketleri	Etiket adlarının ve değerlerinin sözlüğü. Bkz . Şablonlardaki etiketler
identity	Görüntü şablonunun kimliği (yapılandırıldıysa).	ImageTemplateIdentity
properties	Görüntü şablonunun özellikleri	ImageTemplateProperties

ImageTemplateIdentity

Ad	Açıklama	Değer
tür	Görüntü şablonu için kullanılan kimlik türü. 'Hiçbiri' türü, görüntü şablonundan tüm kimlikleri kaldırır.	'Yok' 'UserAssigned'
userAssignedIdentities	Görüntü şablonuyla ilişkili kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlüğü anahtarı başvuruları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	object

ImageTemplateProperties

Ad	Açıklama	Değer
buildTimeoutInMinutes	Görüntü şablonunu oluştururken beklenme süresi üst sınırı. Varsayılan değeri (4 saat) kullanmak için 0 değerini atlar veya belirtin.	int
Özelleştir	Görüntü kaynağı vb. gibi görüntünün özelleştirme adımlarını açıklamak için kullanılan özellikleri belirtir	ImageTemplateCustomizer[]
Dağıtmak	Dağıtım, görüntü çıkışının gitmesi gereken yeri hedefler.	ImageTemplateDistributor[] (gerekli)
kaynak	Kaynak görüntüyü açıklamak için kullanılan özellikleri belirtir.	ImageTemplateSource (gerekli)
vmProfile	Sanal makinenin görüntü oluşturmak için nasıl ayarlandığını açıklar	ImageTemplateVmProfile

ImageTemplateCustomizer

Ad	Açıklama	Değer
name	Bu özelleştirme adımının yaptığı işlemle ilgili bağlam sağlamak için Kolay Ad	string
tür	Nesne türünü ayarlama	Dosya PowerShell Kabuk WindowsRestart (gerekli)

ImageTemplateFileCustomizer

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir	'File' (gerekli)
hedef	Dosyanın (sourceUri'den) VM'ye yüklendiği dosyanın mutlak yolu (iç içe dizin yapıları zaten oluşturulmuştur)	string
sha256Checksum	Yukarıdaki sourceUri alanında sağlanan dosyanın SHA256 sağlama toplamı	string
Sourceuri	VM'yi özelleştirmek için karşıya yüklenecek dosyanın URI'si. Github bağlantısı, Azure Depolama için SAS URI'sı vb. olabilir	string

ImageTemplatePowerShellCustomizer

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir	'PowerShell' (gerekli)
inline	Yürütülecek PowerShell komutları dizisi	string[]
runElevated	Belirtilirse PowerShell betiği yükseltilmiş ayrıcalıklarla çalıştırılır	bool
scriptUri	Özelleştirme için çalıştırılacak PowerShell betiğinin URI'sini seçin. Github bağlantısı, Azure Depolama için SAS URI'sı vb. olabilir	string
sha256Checksum	Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı	string
validExitCodes	PowerShell betiği için geçerli çıkış kodları. [Varsayılan: 0]	int[]

ImageTemplateShellCustomizer

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir	'Shell' (gerekli)
inline	Yürütülecek kabuk komutları dizisi	string[]
scriptUri	Özelleştirme için çalıştırılacak kabuk betiğinin URI'si. Github bağlantısı, Azure Depolama için SAS URI'sı vb. olabilir	string
sha256Checksum	scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı	string

ImageTemplateRestartCustomizer

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştirici olabilir	'WindowsRestart' (gerekli)
restartCheckCommand	Yeniden başlatmanın başarılı olup olmadığını denetleme komutu [Varsayılan: '']	string
restartCommand	Yeniden başlatmayı yürütme komutu [Varsayılan: 'shutdown /r /f /t 0 /c "packer restart"']	string
restartTimeout	Yeniden başlatma zaman aşımı büyüklük ve birim dizesi olarak belirtilir; örneğin ,'5m' (5 dakika) veya '2h' (2 saat) [Varsayılan: '5m']	string

ImageTemplateDistributor

Ad	Açıklama	Değer
artifactTags	Dağıtımcı tarafından oluşturulduktan/güncelleştirildikten sonra yapıta uygulanacak etiketler.	object
runOutputName	İlişkili RunOutput için kullanılacak ad.	dize (gerekli)
tür	Nesne türünü ayarlama	ManagedImage SharedImage VHD (gerekli)

ImageTemplateManagedImageDistributor

Ad	Açıklama	Değer
tür	Dağıtım türü.	'ManagedImage' (gerekli)
imageId	Yönetilen Disk Görüntüsünün Kaynak Kimliği	dize (gerekli)
location	Görüntü için Azure konumu, görüntü zaten varsa eşleşmelidir	dize (gerekli)

ImageTemplateSharedImageDistributor

Ad	Açıklama	Değer
tür	Dağıtım türü.	'SharedImage' (gerekli)
galleryImageId	Paylaşılan Görüntü Galerisi görüntüsünün Kaynak Kimliği	dize (gerekli)
replicationRegions	Görüntünün çoğaltılacağı bölgelerin listesi	string[] (gerekli)

ImageTemplateVhdDistributor

Ad	Açıklama	Değer
tür	Dağıtım türü.	'VHD' (gerekli)

ImageTemplateSource

Ad	Açıklama	Değer
tür	Nesne türünü ayarlama	ISO ManagedImage PlatformImage SharedImageVersion (gerekli)

ImageTemplateIsoSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntünün türünü belirtir.	'ISO' (gerekli)
sha256Checksum	ISO görüntüsünün SHA256 Sağlama Toplamı.	dize (gerekli)
Sourceuri	ISO görüntüsünü almak için URI. Bu URI'nin görüntü şablonu oluşturulurken kaynak sağlayıcısı tarafından erişilebilir olması gerekir.	dize (gerekli)

ImageTemplateManagedImageSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntünün türünü belirtir.	'ManagedImage' (gerekli)
imageId	Müşteri aboneliğinde yönetilen görüntünün ARM kaynak kimliği	dize (gerekli)

ImageTemplatePlatformImageSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntünün türünü belirtir.	'PlatformImage' (gerekli)
teklif	Azure Galeri Görüntüleri'nden görüntü teklifi.	string
yayımcı	Azure Galeri Görüntüleri'nde Görüntü Yayımcısı.	string
Sku	Azure Galeri Görüntüleri'nden görüntü sku'su.	string
sürüm	Azure Galeri Görüntüleri'nden görüntü sürümü.	string

ImageTemplateSharedImageVersionSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntünün türünü belirtir.	'SharedImageVersion' (gerekli)
imageVersionId	Paylaşılan görüntü galerisindeki görüntü sürümünün ARM kaynak kimliği	dize (gerekli)

ImageTemplateVmProfile

Ad	Açıklama	Değer
vmSize	Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu. Varsayılan (Standard_D1_v2) kullanmak için boş dizeyi atlar veya belirtin.	string

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon	Description
Azure Windows Temeli ile Azure Görüntü Oluşturucusu	Azure Image Builder ortamı oluşturur ve en son Windows Güncelleştirmeler ve Azure Windows Temeli uygulanmış bir Windows Server görüntüsü oluşturur.
Dev Box hizmetini yapılandırma	Bu şablon, Dev Box hızlı başlangıç kılavuzuna göre tüm Dev Box yönetici kaynaklarını oluşturur. Oluşturulan tüm kaynakları görüntüleyebilir veya doğrudan DevPortal.microsoft.com giderek ilk Geliştirme Kutunuzu oluşturabilirsiniz.

ARM şablonu kaynak tanımı

imageTemplates kaynak türü şu kaynaklara dağıtılabilir:

Kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.VirtualMachineImages/imageTemplates kaynağı oluşturmak için şablonunuza aşağıdaki JSON'u ekleyin.

{
  "type": "Microsoft.VirtualMachineImages/imageTemplates",
  "apiVersion": "2019-05-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {}
  },
  "properties": {
    "buildTimeoutInMinutes": "int",
    "customize": [
      {
        "name": "string",
        "type": "string"
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ],
    "distribute": [
      {
        "artifactTags": {},
        "runOutputName": "string",
        "type": "string"
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ],
    "source": {
      "type": "string"
      // For remaining properties, see ImageTemplateSource objects
    },
    "vmProfile": {
      "vmSize": "string"
    }
  }
}

ImageTemplateCustomizer nesneleri

nesne türünü belirtmek için type özelliğini ayarlayın.

Dosya için şunu kullanın:

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

PowerShell için şunu kullanın:

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

Kabuk için şunu kullanın:

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

WindowsRestart için şunu kullanın:

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

ImageTemplateDistributor nesneleri

nesne türünü belirtmek için type özelliğini ayarlayın.

ManagedImage için şunu kullanın:

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

SharedImage için şunu kullanın:

  "type": "SharedImage",
  "galleryImageId": "string",
  "replicationRegions": [ "string" ]

VHD için şunu kullanın:

  "type": "VHD"

ImageTemplateSource nesneleri

nesne türünü belirtmek için type özelliğini ayarlayın.

ISO için şunu kullanın:

  "type": "ISO",
  "sha256Checksum": "string",
  "sourceUri": "string"

ManagedImage için şunu kullanın:

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

PlatformImage için şunu kullanın:

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

SharedImageVersion için şunu kullanın:

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

Özellik değerleri

imageTemplates

Ad	Açıklama	Değer
tür	Kaynak türü	'Microsoft.VirtualMachineImages/imageTemplates'
apiVersion	Kaynak API'sinin sürümü	'2019-05-01-preview'
name	Kaynak adı	dize (gerekli)
location	Kaynak konumu	dize (gerekli)
etiketler	Kaynak etiketleri	Etiket adlarının ve değerlerinin sözlüğü. Bkz. Şablonlardaki etiketler
identity	Yapılandırıldıysa, görüntü şablonunun kimliği.	ImageTemplateIdentity
properties	Görüntü şablonunun özellikleri	ImageTemplateProperties

ImageTemplateIdentity

Ad	Açıklama	Değer
tür	Görüntü şablonu için kullanılan kimlik türü. 'Hiçbiri' türü, görüntü şablonundan tüm kimlikleri kaldırır.	'Yok' 'UserAssigned'
userAssignedIdentities	Görüntü şablonuyla ilişkilendirilmiş kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlüğü anahtar başvuruları şu biçimde ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	object

ImageTemplateProperties

Ad	Açıklama	Değer
buildTimeoutInMinutes	Görüntü şablonunu oluştururken beklenme süresi üst sınırı. Varsayılan değeri (4 saat) kullanmak için 0 değerini atlar veya belirtin.	int
Özelleştir	Görüntü kaynağı vb. gibi görüntünün özelleştirme adımlarını açıklamak için kullanılan özellikleri belirtir	ImageTemplateCustomizer[]
Dağıtmak	Dağıtım, görüntü çıkışının gitmesi gereken yeri hedefler.	ImageTemplateDistributor[] (gerekli)
kaynak	Kaynak görüntüyü açıklamak için kullanılan özellikleri belirtir.	ImageTemplateSource (gerekli)
vmProfile	Sanal makinenin görüntü oluşturmak için nasıl ayarlandığını açıklar	ImageTemplateVmProfile

ImageTemplateCustomizer

Ad	Açıklama	Değer
name	Bu özelleştirme adımının ne yaptığıyla ilgili bağlam sağlamak için Kolay Ad	string
tür	Nesne türünü ayarlama	Dosya PowerShell Kabuk WindowsRestart (gerekli)

ImageTemplateFileCustomizer

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştiricisi olabilir	'Dosya' (gerekli)
hedef	Dosyanın (sourceUri'den) VM'ye yüklendiği dosyanın mutlak yolu (iç içe dizin yapıları önceden oluşturulmuş)	string
sha256Checksum	Yukarıdaki sourceUri alanında sağlanan dosyanın SHA256 sağlama toplamı	string
Sourceuri	VM'yi özelleştirmek için karşıya yüklenecek dosyanın URI'si. Github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	string

ImageTemplatePowerShellCustomizer

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştiricisi olabilir	'PowerShell' (gerekli)
inline	Yürütülecek PowerShell komutları dizisi	dize[]
runElevated	Belirtilirse PowerShell betiği yükseltilmiş ayrıcalıklarla çalıştırılır	bool
scriptUri	Özelleştirme için çalıştırılacak PowerShell betiğinin URI'sini seçin. Github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	string
sha256Checksum	Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı	string
validExitCodes	PowerShell betiği için geçerli çıkış kodları. [Varsayılan: 0]	int[]

ImageTemplateShellCustomizer

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştiricisi olabilir	'Shell' (gerekli)
inline	Yürütülecek kabuk komutları dizisi	dize[]
scriptUri	Özelleştirme için çalıştırılacak kabuk betiğinin URI'sini seçin. Github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	string
sha256Checksum	scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı	string

ImageTemplateRestartCustomizer

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştiricisi olabilir	'WindowsRestart' (gerekli)
restartCheckCommand	Yeniden başlatmanın başarılı olup olmadığını denetleme komutu [Varsayılan: '']	string
restartCommand	Yeniden başlatmayı yürütme komutu [Varsayılan: 'shutdown /r /f /t 0 /c "packer restart"']	string
restartTimeout	Yeniden başlatma zaman aşımı bir büyüklük ve birim dizesi olarak belirtildi, örneğin '5m' (5 dakika) veya '2h' (2 saat) [Varsayılan: '5m']	string

ImageTemplateDistributor

Ad	Açıklama	Değer
artifactTags	Dağıtımcı tarafından oluşturulduktan/güncelleştirildikten sonra yapıta uygulanacak etiketler.	object
runOutputName	İlişkili RunOutput için kullanılacak ad.	dize (gerekli)
tür	Nesne türünü ayarlama	ManagedImage SharedImage VHD (gerekli)

ImageTemplateManagedImageDistributor

Ad	Açıklama	Değer
tür	Dağıtım türü.	'ManagedImage' (gerekli)
imageId	Yönetilen Disk Görüntüsünün Kaynak Kimliği	dize (gerekli)
location	Görüntü için Azure konumu, görüntü zaten varsa eşleşmelidir	dize (gerekli)

ImageTemplateSharedImageDistributor

Ad	Açıklama	Değer
tür	Dağıtım türü.	'SharedImage' (gerekli)
galleryImageId	Paylaşılan Görüntü Galerisi görüntüsünün Kaynak Kimliği	dize (gerekli)
replicationRegions	Görüntünün çoğaltılacağı bölgelerin listesi	string[] (gerekli)

ImageTemplateVhdDistributor

Ad	Açıklama	Değer
tür	Dağıtım türü.	'VHD' (gerekli)

ImageTemplateSource

Ad	Açıklama	Değer
tür	Nesne türünü ayarlama	ISO ManagedImage PlatformImage SharedImageVersion (gerekli)

ImageTemplateIsoSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntünün türünü belirtir.	'ISO' (gerekli)
sha256Checksum	ISO görüntüsünün SHA256 Sağlama Toplamı.	dize (gerekli)
Sourceuri	ISO görüntüsünü almak için URI. Bu URI'nin görüntü şablonu oluşturulurken kaynak sağlayıcısı tarafından erişilebilir olması gerekir.	dize (gerekli)

ImageTemplateManagedImageSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntünün türünü belirtir.	'ManagedImage' (gerekli)
imageId	Müşteri aboneliğindeki yönetilen görüntünün ARM kaynak kimliği	dize (gerekli)

ImageTemplatePlatformImageSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntünün türünü belirtir.	'PlatformImage' (gerekli)
teklif	Azure Galeri Görüntüleri'nden görüntü teklifi.	string
yayımcı	Azure Galeri Görüntüleri'nde Image Publisher.	string
Sku	Azure Galeri Görüntüleri'nden görüntü sku'su.	string
sürüm	Azure Galeri Görüntüleri'nden görüntü sürümü.	string

ImageTemplateSharedImageVersionSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntünün türünü belirtir.	'SharedImageVersion' (gerekli)
imageVersionId	Paylaşılan görüntü galerisindeki görüntü sürümünün ARM kaynak kimliği	dize (gerekli)

ImageTemplateVmProfile

Ad	Açıklama	Değer
vmSize	Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu. Varsayılan (Standard_D1_v2) kullanmak için boş dizeyi atlar veya belirtin.	string

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon	Description
Azure Windows Temeli ile Azure Image Builder	Bir Azure Image Builder ortamı oluşturur ve en son Windows Güncelleştirmeler ve Azure Windows Temeli uygulanmış bir Windows Server görüntüsü oluşturur.
Dev Box hizmetini yapılandırma	Bu şablon, Geliştirme Kutusu hızlı başlangıç kılavuzuna göre tüm Dev Box yönetici kaynaklarını oluşturur. Oluşturulan tüm kaynakları görüntüleyebilir veya doğrudan DevPortal.microsoft.com giderek ilk Geliştirme Kutunuzu oluşturabilirsiniz.

Terraform (AzAPI sağlayıcısı) kaynak tanımı

imageTemplates kaynak türü şu şekilde dağıtılabilir:

Kaynak grupları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.VirtualMachineImages/imageTemplates kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.VirtualMachineImages/imageTemplates@2019-05-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "UserAssigned"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      buildTimeoutInMinutes = int
      customize = [
        {
          name = "string"
          type = "string"
          // For remaining properties, see ImageTemplateCustomizer objects
        }
      ]
      distribute = [
        {
          artifactTags = {}
          runOutputName = "string"
          type = "string"
          // For remaining properties, see ImageTemplateDistributor objects
        }
      ]
      source = {
        type = "string"
        // For remaining properties, see ImageTemplateSource objects
      }
      vmProfile = {
        vmSize = "string"
      }
    }
  })
}

ImageTemplateCustomizer nesneleri

nesnenin türünü belirtmek için type özelliğini ayarlayın.

Dosya için şunu kullanın:

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

PowerShell için şunu kullanın:

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

Shell için şunu kullanın:

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

WindowsRestart için şunu kullanın:

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

ImageTemplateDistributor nesneleri

nesnenin türünü belirtmek için type özelliğini ayarlayın.

ManagedImage için şunu kullanın:

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

SharedImage için şunu kullanın:

  type = "SharedImage"
  galleryImageId = "string"
  replicationRegions = [
    "string"
  ]

VHD için şunu kullanın:

  type = "VHD"

ImageTemplateSource nesneleri

nesnenin türünü belirtmek için type özelliğini ayarlayın.

ISO için şunu kullanın:

  type = "ISO"
  sha256Checksum = "string"
  sourceUri = "string"

ManagedImage için şunu kullanın:

  type = "ManagedImage"
  imageId = "string"

PlatformImage için şunu kullanın:

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

SharedImageVersion için şunu kullanın:

  type = "SharedImageVersion"
  imageVersionId = "string"

Özellik değerleri

imageTemplates

Ad	Açıklama	Değer
tür	Kaynak türü	"Microsoft.VirtualMachineImages/imageTemplates@2019-05-01-preview"
name	Kaynak adı	dize (gerekli)
location	Kaynak konumu	dize (gerekli)
parent_id	Bir kaynak grubuna dağıtmak için bu kaynak grubunun kimliğini kullanın.	dize (gerekli)
etiketler	Kaynak etiketleri	Etiket adlarının ve değerlerinin sözlüğü.
identity	Görüntü şablonunun kimliği (yapılandırıldıysa).	ImageTemplateIdentity
properties	Görüntü şablonunun özellikleri	ImageTemplateProperties

ImageTemplateIdentity

Ad	Açıklama	Değer
tür	Görüntü şablonu için kullanılan kimlik türü. 'Hiçbiri' türü, görüntü şablonundan tüm kimlikleri kaldırır.	"UserAssigned"
identity_ids	Görüntü şablonuyla ilişkili kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlüğü anahtarı başvuruları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	Kullanıcı kimliği kimlikleri dizisi.

ImageTemplateProperties

Ad	Açıklama	Değer
buildTimeoutInMinutes	Görüntü şablonunu oluştururken beklenme süresi üst sınırı. Varsayılan değeri (4 saat) kullanmak için 0 değerini atlar veya belirtin.	int
Özelleştir	Görüntü kaynağı vb. gibi görüntünün özelleştirme adımlarını açıklamak için kullanılan özellikleri belirtir	ImageTemplateCustomizer[]
Dağıtmak	Dağıtım, görüntü çıkışının gitmesi gereken yeri hedefler.	ImageTemplateDistributor[] (gerekli)
kaynak	Kaynak görüntüyü açıklamak için kullanılan özellikleri belirtir.	ImageTemplateSource (gerekli)
vmProfile	Sanal makinenin görüntü oluşturmak için nasıl ayarlandığını açıklar	ImageTemplateVmProfile

ImageTemplateCustomizer

Ad	Açıklama	Değer
name	Bu özelleştirme adımının yaptığı işlemle ilgili bağlam sağlamak için Kolay Ad	string
tür	Nesne türünü ayarlama	Dosya PowerShell Kabuk WindowsRestart (gerekli)

ImageTemplateFileCustomizer

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştiricisi olabilir	"Dosya" (gerekli)
hedef	Dosyanın (sourceUri'den) VM'ye yüklendiği dosyanın mutlak yolu (iç içe dizin yapıları önceden oluşturulmuş)	string
sha256Checksum	Yukarıdaki sourceUri alanında sağlanan dosyanın SHA256 sağlama toplamı	string
Sourceuri	VM'yi özelleştirmek için karşıya yüklenecek dosyanın URI'si. Github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	string

ImageTemplatePowerShellCustomizer

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştiricisi olabilir	"PowerShell" (gerekli)
inline	Yürütülecek PowerShell komutları dizisi	dize[]
runElevated	Belirtilirse PowerShell betiği yükseltilmiş ayrıcalıklarla çalıştırılır	bool
scriptUri	Özelleştirme için çalıştırılacak PowerShell betiğinin URI'sini seçin. Github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	string
sha256Checksum	Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı	string
validExitCodes	PowerShell betiği için geçerli çıkış kodları. [Varsayılan: 0]	int[]

ImageTemplateShellCustomizer

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştiricisi olabilir	"Kabuk" (gerekli)
inline	Yürütülecek kabuk komutları dizisi	dize[]
scriptUri	Özelleştirme için çalıştırılacak kabuk betiğinin URI'sini seçin. Github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	string
sha256Checksum	scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı	string

ImageTemplateRestartCustomizer

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz özelleştirme aracının türü. Örneğin, "Kabuk" kabuk özelleştiricisi olabilir	"WindowsRestart" (gerekli)
restartCheckCommand	Yeniden başlatmanın başarılı olup olmadığını denetleme komutu [Varsayılan: '']	string
restartCommand	Yeniden başlatmayı yürütme komutu [Varsayılan: 'shutdown /r /f /t 0 /c "packer restart"']	string
restartTimeout	Yeniden başlatma zaman aşımı bir büyüklük ve birim dizesi olarak belirtildi, örneğin '5m' (5 dakika) veya '2h' (2 saat) [Varsayılan: '5m']	string

ImageTemplateDistributor

Ad	Açıklama	Değer
artifactTags	Dağıtımcı tarafından oluşturulduktan/güncelleştirildikten sonra yapıta uygulanacak etiketler.	object
runOutputName	İlişkili RunOutput için kullanılacak ad.	dize (gerekli)
tür	Nesne türünü ayarlama	ManagedImage SharedImage VHD (gerekli)

ImageTemplateManagedImageDistributor

Ad	Açıklama	Değer
tür	Dağıtım türü.	"ManagedImage" (gerekli)
imageId	Yönetilen Disk Görüntüsünün Kaynak Kimliği	dize (gerekli)
location	Görüntü için Azure konumu, görüntü zaten varsa eşleşmelidir	dize (gerekli)

ImageTemplateSharedImageDistributor

Ad	Açıklama	Değer
tür	Dağıtım türü.	"SharedImage" (gerekli)
galleryImageId	Paylaşılan Görüntü Galerisi görüntüsünün Kaynak Kimliği	dize (gerekli)
replicationRegions	Görüntünün çoğaltılacağı bölgelerin listesi	string[] (gerekli)

ImageTemplateVhdDistributor

Ad	Açıklama	Değer
tür	Dağıtım türü.	"VHD" (gerekli)

ImageTemplateSource

Ad	Açıklama	Değer
tür	Nesne türünü ayarlama	ISO ManagedImage PlatformImage SharedImageVersion (gerekli)

ImageTemplateIsoSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntünün türünü belirtir.	"ISO" (gerekli)
sha256Checksum	ISO görüntüsünün SHA256 Sağlama Toplamı.	dize (gerekli)
Sourceuri	ISO görüntüsünü almak için URI. Bu URI'nin görüntü şablonu oluşturulurken kaynak sağlayıcısı tarafından erişilebilir olması gerekir.	dize (gerekli)

ImageTemplateManagedImageSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntünün türünü belirtir.	"ManagedImage" (gerekli)
imageId	Müşteri aboneliğindeki yönetilen görüntünün ARM kaynak kimliği	dize (gerekli)

ImageTemplatePlatformImageSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntünün türünü belirtir.	"PlatformImage" (gerekli)
teklif	Azure Galeri Görüntüleri'nden görüntü teklifi.	string
yayımcı	Azure Galeri Görüntüleri'nde Image Publisher.	string
Sku	Azure Galeri Görüntüleri'nden görüntü sku'su.	string
sürüm	Azure Galeri Görüntüleri'nden görüntü sürümü.	string

ImageTemplateSharedImageVersionSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntünün türünü belirtir.	"SharedImageVersion" (gerekli)
imageVersionId	Paylaşılan görüntü galerisindeki görüntü sürümünün ARM kaynak kimliği	dize (gerekli)

ImageTemplateVmProfile

Ad	Açıklama	Değer
vmSize	Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu. Varsayılan (Standard_D1_v2) kullanmak için boş dizeyi atla veya belirt.	string

Aracılığıyla paylaş

Microsoft.VirtualMachineImages imageTemplates 2019-05-01-preview

Bicep kaynak tanımı

Kaynak biçimi

ImageTemplateCustomizer nesneleri

ImageTemplateDistributor nesneleri

ImageTemplateSource nesneleri

Özellik değerleri

imageTemplates

ImageTemplateIdentity

ImageTemplateProperties

ImageTemplateCustomizer

ImageTemplateFileCustomizer

ImageTemplatePowerShellCustomizer

ImageTemplateShellCustomizer

ImageTemplateRestartCustomizer

ImageTemplateDistributor

ImageTemplateManagedImageDistributor

ImageTemplateSharedImageDistributor

ImageTemplateVhdDistributor

ImageTemplateSource

ImageTemplateIsoSource

ImageTemplateManagedImageSource

ImageTemplatePlatformImageSource

ImageTemplateSharedImageVersionSource

ImageTemplateVmProfile

Hızlı başlangıç şablonları

ARM şablonu kaynak tanımı

Kaynak biçimi

ImageTemplateCustomizer nesneleri

ImageTemplateDistributor nesneleri

ImageTemplateSource nesneleri

Özellik değerleri

imageTemplates

ImageTemplateIdentity

ImageTemplateProperties

ImageTemplateCustomizer

ImageTemplateFileCustomizer

ImageTemplatePowerShellCustomizer

ImageTemplateShellCustomizer

ImageTemplateRestartCustomizer

ImageTemplateDistributor

ImageTemplateManagedImageDistributor

ImageTemplateSharedImageDistributor

ImageTemplateVhdDistributor

ImageTemplateSource

ImageTemplateIsoSource

ImageTemplateManagedImageSource

ImageTemplatePlatformImageSource

ImageTemplateSharedImageVersionSource

ImageTemplateVmProfile

Hızlı başlangıç şablonları

Terraform (AzAPI sağlayıcısı) kaynak tanımı

Kaynak biçimi

ImageTemplateCustomizer nesneleri

ImageTemplateDistributor nesneleri

ImageTemplateSource nesneleri

Özellik değerleri

imageTemplates

ImageTemplateIdentity

ImageTemplateProperties

ImageTemplateCustomizer

ImageTemplateFileCustomizer

ImageTemplatePowerShellCustomizer

ImageTemplateShellCustomizer

ImageTemplateRestartCustomizer

ImageTemplateDistributor

ImageTemplateManagedImageDistributor

ImageTemplateSharedImageDistributor

ImageTemplateVhdDistributor

ImageTemplateSource

ImageTemplateIsoSource

ImageTemplateManagedImageSource

ImageTemplatePlatformImageSource

ImageTemplateSharedImageVersionSource

ImageTemplateVmProfile

Geri Bildirim

Geri Bildirim

Ek kaynaklar