Microsoft.VirtualMachineImages imageTemplates 2024-02-01

Makale
10/19/2024

Bicep kaynak tanımı

imageTemplates kaynak türü, aşağıdakileri hedefleyen işlemlerle 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@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'
      }
    }
  }
}

ImageTemplateCustomizer nesneleri

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

Dosyaiçin şunu kullanın:

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

powershelliçin şunu kullanın:

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

Shelliçin şunu kullanın:

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

WindowsRestartiçin şunu kullanın:

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

WindowsUpdateiçin şunu kullanın:

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

ImageTemplateDistributor nesneleri

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

ManagedImageiçin şunu kullanın:

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

SharedImageiçin şunu kullanın:

  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
  }

VHDiçin şunu kullanın:

  type: 'VHD'
  uri: 'string'

DistributeVersioner nesneleri

Nesne türünü belirtmek için düzeni özelliğini ayarlayın.

En son için şunu kullanın:

  scheme: 'Latest'
  major: int

Kaynakiçin şunu kullanın:

  scheme: 'Source'

ImageTemplateSource nesneleri

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

ManagedImageiçin şunu kullanın:

  type: 'ManagedImage'
  imageId: 'string'

PlatformImageiçin şunu kullanın:

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

SharedImageVersioniçin şunu kullanın:

  type: 'SharedImageVersion'
  imageVersionId: 'string'

ImageTemplateInVMValidator nesneleri

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

Dosyaiçin şunu kullanın:

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

powershelliçin şunu kullanın:

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

Shelliçin şunu kullanın:

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

Özellik değerleri

imageTemplates

Ad	Açıklama	Değer
ad	Kaynak adı	dize (gerekli)
yer	Kaynağın bulunduğu coğrafi konum	dize (gerekli)
Etiketler	Kaynak etiketleri.	Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
kimlik	Yapılandırıldıysa, görüntü şablonunun kimliği.	ImageTemplateIdentity (gerekli)
Özellikler	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ü şablonundaki tüm kimlikleri kaldırır.	'Hiçbiri' 'UserAssigned'
userAssignedIdentities	Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir.	UserAssignedIdentities

UserAssignedIdentities

Ad	Açıklama	Değer
{özelleştirilmiş özellik}		UserAssignedIdentity

UserAssignedIdentity

Bu nesne dağıtım sırasında ayarlanacağı herhangi bir özellik içermiyor. Tüm özellikler ReadOnly'dir.

ImageTemplateProperties

Ad	Açıklama	Değer
autoRun	Görüntü şablonu derlemesinin şablon oluşturma veya güncelleştirme işleminde otomatik olarak çalıştırılıp çalıştırılmayacağını gösterir.	ImageTemplateAutoRun
buildTimeoutInMinutes	Görüntü şablonunu oluştururken beklenme süresi üst sınırı (tüm özelleştirmeleri, iyileştirmeleri, doğrulamaları ve dağıtımları içerir). Varsayılan değeri (4 saat) kullanmak için 0 değerini atlar veya belirtin.	Int Kısıtlama -ları: En düşük değer = 0 Maksimum değer = 960
Ö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)
errorHandling	Derleme hatasında hata işleme seçenekleri	ImageTemplatePropertiesErrorHandling
managedResourceTags	Hizmet tarafından oluşturulan kaynak grubuna ve/veya kaynaklara uygulanacak etiketler.	nesne
Optimize	Görüntüde gerçekleştirilecek iyileştirmeyi belirtir.	ImageTemplatePropertiesOptimize
kaynak	Kaynak görüntüyü açıklamak için kullanılan özellikleri belirtir.	ImageTemplateSource (gerekli)
stagingResourceGroup	Görüntüyü oluşturmak için kullanılacak görüntü şablonuyla aynı abonelikteki hazırlama kaynak grubu kimliği. Bu alan boşsa, rastgele ada sahip bir kaynak grubu oluşturulur. Bu alanda belirtilen kaynak grubu yoksa, aynı adla oluşturulur. Belirtilen kaynak grubu varsa, boş ve görüntü şablonuyla aynı bölgede olmalıdır. Bu alan boşsa veya belirtilen kaynak grubu yoksa, oluşturulan kaynak grubu şablon silme sırasında silinir, ancak belirtilen kaynak grubu varsa, kaynak grubunda oluşturulan kaynaklar şablon silme sırasında silinir ve kaynak grubunun kendisi kalır.	dizgi
Doğrulamak	Sonuçta elde edilen görüntüde gerçekleştirilecek yapılandırma seçenekleri ve doğrulama listesi.	ImageTemplatePropertiesValidate
vmProfile	Sanal makinenin görüntü oluşturmak için nasıl ayarlandığını açıklar	ImageTemplateVmProfile

ImageTemplateAutoRun

Ad	Açıklama	Değer
devlet	Bu alanın etkinleştirilmesi, görüntü şablonu oluşturma veya güncelleştirme üzerinde otomatik bir derleme tetikler.	'Devre Dışı' 'Etkin'

ImageTemplateCustomizer

Ad	Açıklama	Değer
ad	Bu özelleştirme adımının ne yaptığı hakkında bağlam sağlamak için Kolay Ad	dizgi
tür	Nesne türünü ayarlama	dosya PowerShell Kabuğu WindowsRestart WindowsUpdate (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ı zaten oluşturulmuştur)	dizgi
sha256Checksum	Yukarıdaki sourceUri alanında sağlanan dosyanın SHA256 sağlama toplamı	dizgi
sourceUri	VM'yi özelleştirmek için karşıya yüklenecek dosyanın URI'si. Bu bir github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	dizgi

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)
Satır içi	Yürütülecek PowerShell komutları dizisi	string[]
runAsSystem	Belirtilirse, PowerShell betiği Yerel Sistem kullanıcısı kullanılarak yükseltilmiş ayrıcalıklarla çalıştırılır. Yalnızca yukarıdaki runElevated alanı true olarak ayarlandığında true olabilir.	Bool
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. Bu bir github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	dizgi
sha256Checksum	Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı	dizgi
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)
Satır içi	Yürütülecek kabuk komutları dizisi	string[]
scriptUri	Özelleştirme için çalıştırılacak kabuk betiğinin URI'sini seçin. Bu bir github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	dizgi
sha256Checksum	scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı	dizgi

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: '']	dizgi
restartCommand	Yeniden başlatmayı yürütmek için komut [Varsayılan: 'shutdown /r /f /t 0 /c "packer restart"']	dizgi
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']	dizgi

ImageTemplateWindowsUpdateCustomizer

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	'WindowsUpdate' (gerekli)
Filtre	Uygulanacak güncelleştirmeleri seçecek filtre dizisi. Varsayılanı kullanmak için boş diziyi atla veya belirt (filtre yok). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın.	string[]
searchCriteria	Güncelleştirmeleri aramak için ölçütler. Varsayılanı kullanmak için boş dizeyi atla veya belirt (tümünü ara). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın.	dizgi
updateLimit	Bir kerede uygulanacak en fazla güncelleştirme sayısı. Varsayılan değeri kullanmak için 0 değerini atla veya belirt (1000)	Int Kısıtlama -ları: En düşük değer = 0

ImageTemplateDistributor

Ad	Açıklama	Değer
artifactTags	Dağıtımcı tarafından oluşturulduktan/güncelleştirildikten sonra yapıta uygulanacak etiketler.	nesne
runOutputName	İlişkili RunOutput için kullanılacak ad.	dize (gerekli) Kısıtlama -ları: Desen = `^[A-Za-z0-9-_.]{1,64}$`
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)
yer	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)
excludeFromLatest	Oluşturulan görüntü sürümünün en son sürümden dışlanıp dışlanmayacağını gösteren bayrak. Varsayılanı (false) kullanmak için atla.	Bool
galleryImageId	Azure İşlem Galerisi görüntüsünün Kaynak Kimliği	dize (gerekli)
replicationRegions	[Kullanım dışı] Görüntünün çoğaltılacağı bölgelerin listesi. Bu liste yalnızca targetRegions belirtilmemişse belirtilebilir. Bu alan kullanım dışı bırakıldı; bunun yerine targetRegions kullanın.	string[]
storageAccountType	[Kullanım dışı] Paylaşılan görüntüyü depolamak için kullanılacak depolama hesabı türü. Varsayılanı kullanmak için atla (Standard_LRS). Bu alan yalnızca replicationRegions belirtilirse belirtilebilir. Bu alan kullanım dışı bırakıldı; bunun yerine targetRegions kullanın.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'
targetRegions	Dağıtılmış Görüntü Sürümünün çoğaltılacağı hedef bölgeler. Bu nesne replicationRegions değerinin yerini alır ve yalnızca replicationRegions belirtilmezse belirtilebilir.	TargetRegion[]
sürüm oluşturma	Dağıtım için yeni x.y.z sürüm numarasının nasıl oluşturulacağı açıklanır.	DistributeVersioner

TargetRegion

Ad	Açıklama	Değer
ad	Bölgenin adı.	dize (gerekli)
replicaCount	Bu bölgede oluşturulacak Görüntü Sürümünün çoğaltma sayısı. Varsayılanı (1) kullanmak için atla.	Int Kısıtlama -ları: Min değer = 1
storageAccountType	Görüntüyü bu bölgede depolamak için kullanılacak depolama hesabı türünü belirtir. Varsayılanı kullanmak için atla (Standard_LRS).	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

DistributeVersioner

Ad	Açıklama	Değer
tertip etmek	Nesne türünü ayarlama	en son Kaynak (gerekli)

DistributeVersionerLatest

Ad	Açıklama	Değer
tertip etmek	Kullanılacak sürüm numaralandırma düzeni.	'En Son' (gerekli)
binbaşı	Oluşturulan sürüm numarası için ana sürüm. Ana sürüm olarak bu değere sahip sürümlere göre "en son" değerini belirleyin. -1, kümeyi kümelenmemiş olarak bırakmakla eşdeğerdir.	Int

DistributeVersionerSource

Ad	Açıklama	Değer
tertip etmek	Kullanılacak sürüm numaralandırma düzeni.	'Source' (gerekli)

ImageTemplateVhdDistributor

Ad	Açıklama	Değer
tür	Dağıtım türü.	'VHD' (gerekli)
Urı	Dağıtılmış VHD blobu için isteğe bağlı Azure Depolama URI'si. VHD'nin hazırlama kaynak grubundaki depolama hesabında yayımlandığı varsayılan dizeyi (boş dize) kullanmayı atla.	dizgi

ImageTemplatePropertiesErrorHandling

Ad	Açıklama	Değer
onCustomizerError	Özelleştirici hatası varsa ve bu alan 'temizleme' olarak ayarlandıysa, derleme VM'si ve ilişkili ağ kaynakları temizlenir. Bu, varsayılan davranıştır. Özelleştirici hatası varsa ve bu alan 'iptal' olarak ayarlandıysa, derleme VM'si korunur.	'abort' 'cleanup'
onValidationError	Doğrulama hatası varsa ve bu alan 'temizleme' olarak ayarlandıysa, derleme VM'si ve ilişkili ağ kaynakları temizlenir. Bu, varsayılan davranıştır. Doğrulama hatası varsa ve bu alan 'iptal' olarak ayarlandıysa, derleme VM'si korunur.	'abort' 'cleanup'

ImageTemplatePropertiesOptimize

Ad	Açıklama	Değer
vmBoot	Daha hızlı bir VM önyüklemesi için görüntüye iyileştirme uygulanır.	ImageTemplatePropertiesOptimizeVmBoot

ImageTemplatePropertiesOptimizeVmBoot

Ad	Açıklama	Değer
devlet	Bu alanın etkinleştirilmesi, son özelleştirilmiş görüntü çıkışını iyileştirerek VM önyükleme süresini iyileştirir.	'Devre Dışı' 'Etkin'

ImageTemplateSource

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

ImageTemplateManagedImageSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntü 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ü türünü belirtir.	'PlatformImage' (gerekli)
teklif	Azure Galeri Görüntüleriresim teklifi.	dizgi
planInfo	Platform görüntüsü için satın alma planının isteğe bağlı yapılandırması.	PlatformImagePurchasePlan
yayınevi	Azure Galeri Görüntülerigörüntü yayımcısı.	dizgi
Sku	Azure Galeri Görüntülerigörüntü sku'su.	dizgi
Sürüm	Azure Galeri Görüntülerigörüntü sürümü. Burada 'en son' belirtilirse, şablon gönderildiğinde değil görüntü derlemesi gerçekleştiğinde sürüm değerlendirilir.	dizgi

PlatformImagePurchasePlan

Ad	Açıklama	Değer
planName	Satın alma planının adı.	dize (gerekli)
planProduct	Satın alma planının ürünü.	dize (gerekli)
planPublisher	Satın alma planının yayımcısı.	dize (gerekli)

ImageTemplateSharedImageVersionSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntü türünü belirtir.	'SharedImageVersion' (gerekli)
imageVersionId	Görüntü sürümünün ARM kaynak kimliği. Görüntü sürümü adı 'en son' olduğunda, görüntü derlemesi gerçekleştiğinde sürüm değerlendirilir.	dize (gerekli)

ImageTemplatePropertiesValidate

Ad	Açıklama	Değer
continueDistributeOnFailure	Doğrulama başarısız olursa ve bu alan false olarak ayarlanırsa, çıkış görüntüleri dağıtılmaz. Bu, varsayılan davranıştır. Doğrulama başarısız olursa ve bu alan true olarak ayarlanırsa, çıkış görüntüleri yine de dağıtılır. Hatalı görüntülerin kullanım için dağıtılmasıyla sonuçlanma ihtimaline karşı lütfen bu seçeneği dikkatli kullanın. Her iki durumda da (true veya false) uçtan uca görüntü çalıştırması, doğrulama hatası durumunda başarısız olduğu bildirilir. [Not: Doğrulama başarılı olursa bu alanın hiçbir etkisi olmaz.]	Bool
inVMValidations	Gerçekleştirilecek doğrulamaların listesi.	ImageTemplateInVMValidator[]
sourceValidationOnly	Bu alan true olarak ayarlanırsa, 'kaynak' bölümünde belirtilen görüntü doğrudan doğrulanır. Özelleştirilmiş bir görüntü oluşturmak ve doğrulamak için ayrı bir derleme çalıştırılamaz.	Bool

ImageTemplateInVMValidator

Ad	Açıklama	Değer
ad	Bu doğrulama adımının ne yaptığı hakkında bağlam sağlamak için Kolay Ad	dizgi
tür	Nesne türünü ayarlama	dosya PowerShell Kabuk (gerekli)

ImageTemplateFileValidator

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir	'Dosya' (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)	dizgi
sha256Checksum	Yukarıdaki sourceUri alanında sağlanan dosyanın SHA256 sağlama toplamı	dizgi
sourceUri	Doğrulama için VM'ye yüklenecek dosyanın URI'si. Github bağlantısı, Azure Depolama URI'si (yetkili veya SAS) vb. olabilir	dizgi

ImageTemplatePowerShellValidator

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir	'PowerShell' (gerekli)
Satır içi	Yürütülecek PowerShell komutları dizisi	string[]
runAsSystem	Belirtilirse, PowerShell betiği Yerel Sistem kullanıcısı kullanılarak yükseltilmiş ayrıcalıklarla çalıştırılır. Yalnızca yukarıdaki runElevated alanı true olarak ayarlandığında true olabilir.	Bool
runElevated	Belirtilirse PowerShell betiği yükseltilmiş ayrıcalıklarla çalıştırılır	Bool
scriptUri	Doğrulama için çalıştırılacak PowerShell betiğinin URI'sini seçin. Github bağlantısı, Azure Depolama URI'si vb. olabilir	dizgi
sha256Checksum	Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı	dizgi
validExitCodes	PowerShell betiği için geçerli çıkış kodları. [Varsayılan: 0]	int[]

ImageTemplateShellValidator

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

ImageTemplateVmProfile

Ad	Açıklama	Değer
osDiskSizeGB	İşletim sistemi diskinin GB cinsinden boyutu. Azure'ın varsayılan işletim sistemi disk boyutunu kullanmak için 0 değerini atlar veya belirtin.	Int Kısıtlama -ları: En düşük değer = 0
userAssignedIdentities	Derleme VM'sinde ve doğrulama VM'sinde yapılandırılacak, kullanıcı tarafından atanan yönetilen kimliklerin isteğe bağlı kaynak kimlikleri dizisi. Bu, görüntü şablonunun kimliğini içerebilir.	string[]
vmSize	Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu. Varsayılanı kullanmak için boş dizeyi atla veya belirt (1. Nesil görüntüleri için Standard_D1_v2 ve 2. Nesil görüntüleri için Standard_D2ds_v4).	dizgi
vnetConfig	derleme VM'sini ve doğrulama VM'sini dağıtmak için kullanılacak sanal ağın isteğe bağlı yapılandırması. Belirli bir sanal ağın kullanılması gerekmiyorsa atla.	VirtualNetworkConfig

VirtualNetworkConfig

Ad	Açıklama	Değer
containerInstanceSubnetId	Yalıtılmış Derlemeler için Azure Container Instance'ın dağıtılacağı önceden var olan bir alt ağın kaynak kimliği. Bu alan yalnızca `subnetId` da belirtilmişse belirtilebilir ve `subnetId`'de belirtilen alt ağ ile aynı Sanal Ağ üzerinde olmalıdır.	dizgi
proxyVmSize	Derleme VM'sine ve doğrulama VM'sine trafik geçirmek için kullanılan ara sunucu sanal makinesinin boyutu. Bu durumda hiçbir ara sunucu sanal makinesi dağıtılmadığından, `containerInstanceSubnetId` belirtildiyse bu belirtilmemelidir. Varsayılanı kullanmak için boş dizeyi atla veya belirt (Standard_A1_v2).	dizgi
subnetId	Derleme VM'sinin ve doğrulama VM'sinin dağıtılacağı önceden var olan bir alt ağın kaynak kimliği	dizgi

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

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

Şablon	Açıklama
Azure Windows Baseline ile Azure Image Builder'ı 'a dağıtma	Azure Image Builder ortamı oluşturur ve en son Windows Güncelleştirmeleri ve Azure Windows Temeli uygulanmış bir Windows Server görüntüsü oluşturur.
Dev Box hizmetini yapılandırma 'a dağıtma	Bu şablon, Geliştirme Kutusu hızlı başlangıç kılavuzuna (https://video2.skills-academy.com/azure/dev-box/quickstart-create-dev-box) 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ü, aşağıdakileri hedefleyen işlemlerle 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": "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"
      }
    }
  }
}

ImageTemplateCustomizer nesneleri

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

Dosyaiçin şunu kullanın:

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

powershelliçin şunu kullanın:

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

Shelliçin şunu kullanın:

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

WindowsRestartiçin şunu kullanın:

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

WindowsUpdateiçin şunu kullanın:

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

ImageTemplateDistributor nesneleri

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

ManagedImageiçin şunu kullanın:

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

SharedImageiçin şunu kullanın:

  "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
  }

VHDiçin şunu kullanın:

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

DistributeVersioner nesneleri

Nesne türünü belirtmek için düzeni özelliğini ayarlayın.

En son için şunu kullanın:

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

Kaynakiçin şunu kullanın:

  "scheme": "Source"

ImageTemplateSource nesneleri

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

ManagedImageiçin şunu kullanın:

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

PlatformImageiçin şunu kullanın:

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

SharedImageVersioniçin şunu kullanın:

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

ImageTemplateInVMValidator nesneleri

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

Dosyaiçin şunu kullanın:

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

powershelliçin şunu kullanın:

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

Shelliçin şunu kullanın:

  "type": "Shell",
  "inline": [ "string" ],
  "scriptUri": "string",
  "sha256Checksum": "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ü	'2024-02-01'
ad	Kaynak adı	dize (gerekli)
yer	Kaynağın bulunduğu coğrafi konum	dize (gerekli)
Etiketler	Kaynak etiketleri.	Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
kimlik	Yapılandırıldıysa, görüntü şablonunun kimliği.	ImageTemplateIdentity (gerekli)
Özellikler	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ü şablonundaki tüm kimlikleri kaldırır.	'Hiçbiri' 'UserAssigned'
userAssignedIdentities	Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir.	UserAssignedIdentities

UserAssignedIdentities

Ad	Açıklama	Değer
{özelleştirilmiş özellik}		UserAssignedIdentity

UserAssignedIdentity

Bu nesne dağıtım sırasında ayarlanacağı herhangi bir özellik içermiyor. Tüm özellikler ReadOnly'dir.

ImageTemplateProperties

Ad	Açıklama	Değer
autoRun	Görüntü şablonu derlemesinin şablon oluşturma veya güncelleştirme işleminde otomatik olarak çalıştırılıp çalıştırılmayacağını gösterir.	ImageTemplateAutoRun
buildTimeoutInMinutes	Görüntü şablonunu oluştururken beklenme süresi üst sınırı (tüm özelleştirmeleri, iyileştirmeleri, doğrulamaları ve dağıtımları içerir). Varsayılan değeri (4 saat) kullanmak için 0 değerini atlar veya belirtin.	Int Kısıtlama -ları: En düşük değer = 0 Maksimum değer = 960
Ö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)
errorHandling	Derleme hatasında hata işleme seçenekleri	ImageTemplatePropertiesErrorHandling
managedResourceTags	Hizmet tarafından oluşturulan kaynak grubuna ve/veya kaynaklara uygulanacak etiketler.	nesne
Optimize	Görüntüde gerçekleştirilecek iyileştirmeyi belirtir.	ImageTemplatePropertiesOptimize
kaynak	Kaynak görüntüyü açıklamak için kullanılan özellikleri belirtir.	ImageTemplateSource (gerekli)
stagingResourceGroup	Görüntüyü oluşturmak için kullanılacak görüntü şablonuyla aynı abonelikteki hazırlama kaynak grubu kimliği. Bu alan boşsa, rastgele ada sahip bir kaynak grubu oluşturulur. Bu alanda belirtilen kaynak grubu yoksa, aynı adla oluşturulur. Belirtilen kaynak grubu varsa, boş ve görüntü şablonuyla aynı bölgede olmalıdır. Bu alan boşsa veya belirtilen kaynak grubu yoksa, oluşturulan kaynak grubu şablon silme sırasında silinir, ancak belirtilen kaynak grubu varsa, kaynak grubunda oluşturulan kaynaklar şablon silme sırasında silinir ve kaynak grubunun kendisi kalır.	dizgi
Doğrulamak	Sonuçta elde edilen görüntüde gerçekleştirilecek yapılandırma seçenekleri ve doğrulama listesi.	ImageTemplatePropertiesValidate
vmProfile	Sanal makinenin görüntü oluşturmak için nasıl ayarlandığını açıklar	ImageTemplateVmProfile

ImageTemplateAutoRun

Ad	Açıklama	Değer
devlet	Bu alanın etkinleştirilmesi, görüntü şablonu oluşturma veya güncelleştirme üzerinde otomatik bir derleme tetikler.	'Devre Dışı' 'Etkin'

ImageTemplateCustomizer

Ad	Açıklama	Değer
ad	Bu özelleştirme adımının ne yaptığı hakkında bağlam sağlamak için Kolay Ad	dizgi
tür	Nesne türünü ayarlama	dosya PowerShell Kabuğu WindowsRestart WindowsUpdate (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ı zaten oluşturulmuştur)	dizgi
sha256Checksum	Yukarıdaki sourceUri alanında sağlanan dosyanın SHA256 sağlama toplamı	dizgi
sourceUri	VM'yi özelleştirmek için karşıya yüklenecek dosyanın URI'si. Bu bir github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	dizgi

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)
Satır içi	Yürütülecek PowerShell komutları dizisi	string[]
runAsSystem	Belirtilirse, PowerShell betiği Yerel Sistem kullanıcısı kullanılarak yükseltilmiş ayrıcalıklarla çalıştırılır. Yalnızca yukarıdaki runElevated alanı true olarak ayarlandığında true olabilir.	Bool
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. Bu bir github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	dizgi
sha256Checksum	Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı	dizgi
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)
Satır içi	Yürütülecek kabuk komutları dizisi	string[]
scriptUri	Özelleştirme için çalıştırılacak kabuk betiğinin URI'sini seçin. Bu bir github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	dizgi
sha256Checksum	scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı	dizgi

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: '']	dizgi
restartCommand	Yeniden başlatmayı yürütmek için komut [Varsayılan: 'shutdown /r /f /t 0 /c "packer restart"']	dizgi
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']	dizgi

ImageTemplateWindowsUpdateCustomizer

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	'WindowsUpdate' (gerekli)
Filtre	Uygulanacak güncelleştirmeleri seçecek filtre dizisi. Varsayılanı kullanmak için boş diziyi atla veya belirt (filtre yok). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın.	string[]
searchCriteria	Güncelleştirmeleri aramak için ölçütler. Varsayılanı kullanmak için boş dizeyi atla veya belirt (tümünü ara). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın.	dizgi
updateLimit	Bir kerede uygulanacak en fazla güncelleştirme sayısı. Varsayılan değeri kullanmak için 0 değerini atla veya belirt (1000)	Int Kısıtlama -ları: En düşük değer = 0

ImageTemplateDistributor

Ad	Açıklama	Değer
artifactTags	Dağıtımcı tarafından oluşturulduktan/güncelleştirildikten sonra yapıta uygulanacak etiketler.	nesne
runOutputName	İlişkili RunOutput için kullanılacak ad.	dize (gerekli) Kısıtlama -ları: Desen = `^[A-Za-z0-9-_.]{1,64}$`
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)
yer	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)
excludeFromLatest	Oluşturulan görüntü sürümünün en son sürümden dışlanıp dışlanmayacağını gösteren bayrak. Varsayılanı (false) kullanmak için atla.	Bool
galleryImageId	Azure İşlem Galerisi görüntüsünün Kaynak Kimliği	dize (gerekli)
replicationRegions	[Kullanım dışı] Görüntünün çoğaltılacağı bölgelerin listesi. Bu liste yalnızca targetRegions belirtilmemişse belirtilebilir. Bu alan kullanım dışı bırakıldı; bunun yerine targetRegions kullanın.	string[]
storageAccountType	[Kullanım dışı] Paylaşılan görüntüyü depolamak için kullanılacak depolama hesabı türü. Varsayılanı kullanmak için atla (Standard_LRS). Bu alan yalnızca replicationRegions belirtilirse belirtilebilir. Bu alan kullanım dışı bırakıldı; bunun yerine targetRegions kullanın.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'
targetRegions	Dağıtılmış Görüntü Sürümünün çoğaltılacağı hedef bölgeler. Bu nesne replicationRegions değerinin yerini alır ve yalnızca replicationRegions belirtilmezse belirtilebilir.	TargetRegion[]
sürüm oluşturma	Dağıtım için yeni x.y.z sürüm numarasının nasıl oluşturulacağı açıklanır.	DistributeVersioner

TargetRegion

Ad	Açıklama	Değer
ad	Bölgenin adı.	dize (gerekli)
replicaCount	Bu bölgede oluşturulacak Görüntü Sürümünün çoğaltma sayısı. Varsayılanı (1) kullanmak için atla.	Int Kısıtlama -ları: Min değer = 1
storageAccountType	Görüntüyü bu bölgede depolamak için kullanılacak depolama hesabı türünü belirtir. Varsayılanı kullanmak için atla (Standard_LRS).	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

DistributeVersioner

Ad	Açıklama	Değer
tertip etmek	Nesne türünü ayarlama	en son Kaynak (gerekli)

DistributeVersionerLatest

Ad	Açıklama	Değer
tertip etmek	Kullanılacak sürüm numaralandırma düzeni.	'En Son' (gerekli)
binbaşı	Oluşturulan sürüm numarası için ana sürüm. Ana sürüm olarak bu değere sahip sürümlere göre "en son" değerini belirleyin. -1, kümeyi kümelenmemiş olarak bırakmakla eşdeğerdir.	Int

DistributeVersionerSource

Ad	Açıklama	Değer
tertip etmek	Kullanılacak sürüm numaralandırma düzeni.	'Source' (gerekli)

ImageTemplateVhdDistributor

Ad	Açıklama	Değer
tür	Dağıtım türü.	'VHD' (gerekli)
Urı	Dağıtılmış VHD blobu için isteğe bağlı Azure Depolama URI'si. VHD'nin hazırlama kaynak grubundaki depolama hesabında yayımlandığı varsayılan dizeyi (boş dize) kullanmayı atla.	dizgi

ImageTemplatePropertiesErrorHandling

Ad	Açıklama	Değer
onCustomizerError	Özelleştirici hatası varsa ve bu alan 'temizleme' olarak ayarlandıysa, derleme VM'si ve ilişkili ağ kaynakları temizlenir. Bu, varsayılan davranıştır. Özelleştirici hatası varsa ve bu alan 'iptal' olarak ayarlandıysa, derleme VM'si korunur.	'abort' 'cleanup'
onValidationError	Doğrulama hatası varsa ve bu alan 'temizleme' olarak ayarlandıysa, derleme VM'si ve ilişkili ağ kaynakları temizlenir. Bu, varsayılan davranıştır. Doğrulama hatası varsa ve bu alan 'iptal' olarak ayarlandıysa, derleme VM'si korunur.	'abort' 'cleanup'

ImageTemplatePropertiesOptimize

Ad	Açıklama	Değer
vmBoot	Daha hızlı bir VM önyüklemesi için görüntüye iyileştirme uygulanır.	ImageTemplatePropertiesOptimizeVmBoot

ImageTemplatePropertiesOptimizeVmBoot

Ad	Açıklama	Değer
devlet	Bu alanın etkinleştirilmesi, son özelleştirilmiş görüntü çıkışını iyileştirerek VM önyükleme süresini iyileştirir.	'Devre Dışı' 'Etkin'

ImageTemplateSource

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

ImageTemplateManagedImageSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntü 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ü türünü belirtir.	'PlatformImage' (gerekli)
teklif	Azure Galeri Görüntüleriresim teklifi.	dizgi
planInfo	Platform görüntüsü için satın alma planının isteğe bağlı yapılandırması.	PlatformImagePurchasePlan
yayınevi	Azure Galeri Görüntülerigörüntü yayımcısı.	dizgi
Sku	Azure Galeri Görüntülerigörüntü sku'su.	dizgi
Sürüm	Azure Galeri Görüntülerigörüntü sürümü. Burada 'en son' belirtilirse, şablon gönderildiğinde değil görüntü derlemesi gerçekleştiğinde sürüm değerlendirilir.	dizgi

PlatformImagePurchasePlan

Ad	Açıklama	Değer
planName	Satın alma planının adı.	dize (gerekli)
planProduct	Satın alma planının ürünü.	dize (gerekli)
planPublisher	Satın alma planının yayımcısı.	dize (gerekli)

ImageTemplateSharedImageVersionSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntü türünü belirtir.	'SharedImageVersion' (gerekli)
imageVersionId	Görüntü sürümünün ARM kaynak kimliği. Görüntü sürümü adı 'en son' olduğunda, görüntü derlemesi gerçekleştiğinde sürüm değerlendirilir.	dize (gerekli)

ImageTemplatePropertiesValidate

Ad	Açıklama	Değer
continueDistributeOnFailure	Doğrulama başarısız olursa ve bu alan false olarak ayarlanırsa, çıkış görüntüleri dağıtılmaz. Bu, varsayılan davranıştır. Doğrulama başarısız olursa ve bu alan true olarak ayarlanırsa, çıkış görüntüleri yine de dağıtılır. Hatalı görüntülerin kullanım için dağıtılmasıyla sonuçlanma ihtimaline karşı lütfen bu seçeneği dikkatli kullanın. Her iki durumda da (true veya false) uçtan uca görüntü çalıştırması, doğrulama hatası durumunda başarısız olduğu bildirilir. [Not: Doğrulama başarılı olursa bu alanın hiçbir etkisi olmaz.]	Bool
inVMValidations	Gerçekleştirilecek doğrulamaların listesi.	ImageTemplateInVMValidator[]
sourceValidationOnly	Bu alan true olarak ayarlanırsa, 'kaynak' bölümünde belirtilen görüntü doğrudan doğrulanır. Özelleştirilmiş bir görüntü oluşturmak ve doğrulamak için ayrı bir derleme çalıştırılamaz.	Bool

ImageTemplateInVMValidator

Ad	Açıklama	Değer
ad	Bu doğrulama adımının ne yaptığı hakkında bağlam sağlamak için Kolay Ad	dizgi
tür	Nesne türünü ayarlama	dosya PowerShell Kabuk (gerekli)

ImageTemplateFileValidator

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir	'Dosya' (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)	dizgi
sha256Checksum	Yukarıdaki sourceUri alanında sağlanan dosyanın SHA256 sağlama toplamı	dizgi
sourceUri	Doğrulama için VM'ye yüklenecek dosyanın URI'si. Github bağlantısı, Azure Depolama URI'si (yetkili veya SAS) vb. olabilir	dizgi

ImageTemplatePowerShellValidator

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir	'PowerShell' (gerekli)
Satır içi	Yürütülecek PowerShell komutları dizisi	string[]
runAsSystem	Belirtilirse, PowerShell betiği Yerel Sistem kullanıcısı kullanılarak yükseltilmiş ayrıcalıklarla çalıştırılır. Yalnızca yukarıdaki runElevated alanı true olarak ayarlandığında true olabilir.	Bool
runElevated	Belirtilirse PowerShell betiği yükseltilmiş ayrıcalıklarla çalıştırılır	Bool
scriptUri	Doğrulama için çalıştırılacak PowerShell betiğinin URI'sini seçin. Github bağlantısı, Azure Depolama URI'si vb. olabilir	dizgi
sha256Checksum	Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı	dizgi
validExitCodes	PowerShell betiği için geçerli çıkış kodları. [Varsayılan: 0]	int[]

ImageTemplateShellValidator

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

ImageTemplateVmProfile

Ad	Açıklama	Değer
osDiskSizeGB	İşletim sistemi diskinin GB cinsinden boyutu. Azure'ın varsayılan işletim sistemi disk boyutunu kullanmak için 0 değerini atlar veya belirtin.	Int Kısıtlama -ları: En düşük değer = 0
userAssignedIdentities	Derleme VM'sinde ve doğrulama VM'sinde yapılandırılacak, kullanıcı tarafından atanan yönetilen kimliklerin isteğe bağlı kaynak kimlikleri dizisi. Bu, görüntü şablonunun kimliğini içerebilir.	string[]
vmSize	Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu. Varsayılanı kullanmak için boş dizeyi atla veya belirt (1. Nesil görüntüleri için Standard_D1_v2 ve 2. Nesil görüntüleri için Standard_D2ds_v4).	dizgi
vnetConfig	derleme VM'sini ve doğrulama VM'sini dağıtmak için kullanılacak sanal ağın isteğe bağlı yapılandırması. Belirli bir sanal ağın kullanılması gerekmiyorsa atla.	VirtualNetworkConfig

VirtualNetworkConfig

Ad	Açıklama	Değer
containerInstanceSubnetId	Yalıtılmış Derlemeler için Azure Container Instance'ın dağıtılacağı önceden var olan bir alt ağın kaynak kimliği. Bu alan yalnızca `subnetId` da belirtilmişse belirtilebilir ve `subnetId`'de belirtilen alt ağ ile aynı Sanal Ağ üzerinde olmalıdır.	dizgi
proxyVmSize	Derleme VM'sine ve doğrulama VM'sine trafik geçirmek için kullanılan ara sunucu sanal makinesinin boyutu. Bu durumda hiçbir ara sunucu sanal makinesi dağıtılmadığından, `containerInstanceSubnetId` belirtildiyse bu belirtilmemelidir. Varsayılanı kullanmak için boş dizeyi atla veya belirt (Standard_A1_v2).	dizgi
subnetId	Derleme VM'sinin ve doğrulama VM'sinin dağıtılacağı önceden var olan bir alt ağın kaynak kimliği	dizgi

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

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

Şablon	Açıklama
Azure Windows Baseline ile Azure Image Builder'ı 'a dağıtma	Azure Image Builder ortamı oluşturur ve en son Windows Güncelleştirmeleri ve Azure Windows Temeli uygulanmış bir Windows Server görüntüsü oluşturur.
Dev Box hizmetini yapılandırma 'a dağıtma	Bu şablon, Geliştirme Kutusu hızlı başlangıç kılavuzuna (https://video2.skills-academy.com/azure/dev-box/quickstart-create-dev-box) 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ü, aşağıdakileri hedefleyen işlemlerle 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@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"
        }
      }
    }
  })
}

ImageTemplateCustomizer nesneleri

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

Dosyaiçin şunu kullanın:

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

powershelliçin şunu kullanın:

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

Shelliçin şunu kullanın:

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

WindowsRestartiçin şunu kullanın:

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

WindowsUpdateiçin şunu kullanın:

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

ImageTemplateDistributor nesneleri

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

ManagedImageiçin şunu kullanın:

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

SharedImageiçin şunu kullanın:

  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
  }

VHDiçin şunu kullanın:

  type = "VHD"
  uri = "string"

DistributeVersioner nesneleri

Nesne türünü belirtmek için düzeni özelliğini ayarlayın.

En son için şunu kullanın:

  scheme = "Latest"
  major = int

Kaynakiçin şunu kullanın:

  scheme = "Source"

ImageTemplateSource nesneleri

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

ManagedImageiçin şunu kullanın:

  type = "ManagedImage"
  imageId = "string"

PlatformImageiçin şunu kullanın:

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

SharedImageVersioniçin şunu kullanın:

  type = "SharedImageVersion"
  imageVersionId = "string"

ImageTemplateInVMValidator nesneleri

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

Dosyaiçin şunu kullanın:

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

powershelliçin şunu kullanın:

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

Shelliçin şunu kullanın:

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

Özellik değerleri

imageTemplates

Ad	Açıklama	Değer
tür	Kaynak türü	"Microsoft.VirtualMachineImages/imageTemplates@2024-02-01"
ad	Kaynak adı	dize (gerekli)
yer	Kaynağın bulunduğu coğrafi konum	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ı ve değerleri sözlüğü.
kimlik	Yapılandırıldıysa, görüntü şablonunun kimliği.	ImageTemplateIdentity (gerekli)
Özellikler	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ü şablonundaki tüm kimlikleri kaldırır.	"UserAssigned"
identity_ids	Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir.	Kullanıcı kimliği kimlikleri dizisi.

UserAssignedIdentities

Ad	Açıklama	Değer
{özelleştirilmiş özellik}		UserAssignedIdentity

UserAssignedIdentity

Bu nesne dağıtım sırasında ayarlanacağı herhangi bir özellik içermiyor. Tüm özellikler ReadOnly'dir.

ImageTemplateProperties

Ad	Açıklama	Değer
autoRun	Görüntü şablonu derlemesinin şablon oluşturma veya güncelleştirme işleminde otomatik olarak çalıştırılıp çalıştırılmayacağını gösterir.	ImageTemplateAutoRun
buildTimeoutInMinutes	Görüntü şablonunu oluştururken beklenme süresi üst sınırı (tüm özelleştirmeleri, iyileştirmeleri, doğrulamaları ve dağıtımları içerir). Varsayılan değeri (4 saat) kullanmak için 0 değerini atlar veya belirtin.	Int Kısıtlama -ları: En düşük değer = 0 Maksimum değer = 960
Ö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)
errorHandling	Derleme hatasında hata işleme seçenekleri	ImageTemplatePropertiesErrorHandling
managedResourceTags	Hizmet tarafından oluşturulan kaynak grubuna ve/veya kaynaklara uygulanacak etiketler.	nesne
Optimize	Görüntüde gerçekleştirilecek iyileştirmeyi belirtir.	ImageTemplatePropertiesOptimize
kaynak	Kaynak görüntüyü açıklamak için kullanılan özellikleri belirtir.	ImageTemplateSource (gerekli)
stagingResourceGroup	Görüntüyü oluşturmak için kullanılacak görüntü şablonuyla aynı abonelikteki hazırlama kaynak grubu kimliği. Bu alan boşsa, rastgele ada sahip bir kaynak grubu oluşturulur. Bu alanda belirtilen kaynak grubu yoksa, aynı adla oluşturulur. Belirtilen kaynak grubu varsa, boş ve görüntü şablonuyla aynı bölgede olmalıdır. Bu alan boşsa veya belirtilen kaynak grubu yoksa, oluşturulan kaynak grubu şablon silme sırasında silinir, ancak belirtilen kaynak grubu varsa, kaynak grubunda oluşturulan kaynaklar şablon silme sırasında silinir ve kaynak grubunun kendisi kalır.	dizgi
Doğrulamak	Sonuçta elde edilen görüntüde gerçekleştirilecek yapılandırma seçenekleri ve doğrulama listesi.	ImageTemplatePropertiesValidate
vmProfile	Sanal makinenin görüntü oluşturmak için nasıl ayarlandığını açıklar	ImageTemplateVmProfile

ImageTemplateAutoRun

Ad	Açıklama	Değer
devlet	Bu alanın etkinleştirilmesi, görüntü şablonu oluşturma veya güncelleştirme üzerinde otomatik bir derleme tetikler.	"Devre dışı" "Etkin"

ImageTemplateCustomizer

Ad	Açıklama	Değer
ad	Bu özelleştirme adımının ne yaptığı hakkında bağlam sağlamak için Kolay Ad	dizgi
tür	Nesne türünü ayarlama	dosya PowerShell Kabuğu WindowsRestart WindowsUpdate (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ı zaten oluşturulmuştur)	dizgi
sha256Checksum	Yukarıdaki sourceUri alanında sağlanan dosyanın SHA256 sağlama toplamı	dizgi
sourceUri	VM'yi özelleştirmek için karşıya yüklenecek dosyanın URI'si. Bu bir github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	dizgi

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)
Satır içi	Yürütülecek PowerShell komutları dizisi	string[]
runAsSystem	Belirtilirse, PowerShell betiği Yerel Sistem kullanıcısı kullanılarak yükseltilmiş ayrıcalıklarla çalıştırılır. Yalnızca yukarıdaki runElevated alanı true olarak ayarlandığında true olabilir.	Bool
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. Bu bir github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	dizgi
sha256Checksum	Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı	dizgi
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)
Satır içi	Yürütülecek kabuk komutları dizisi	string[]
scriptUri	Özelleştirme için çalıştırılacak kabuk betiğinin URI'sini seçin. Bu bir github bağlantısı, Azure Depolama için SAS URI'si vb. olabilir	dizgi
sha256Checksum	scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı	dizgi

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: '']	dizgi
restartCommand	Yeniden başlatmayı yürütmek için komut [Varsayılan: 'shutdown /r /f /t 0 /c "packer restart"']	dizgi
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']	dizgi

ImageTemplateWindowsUpdateCustomizer

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	"WindowsUpdate" (gerekli)
Filtre	Uygulanacak güncelleştirmeleri seçecek filtre dizisi. Varsayılanı kullanmak için boş diziyi atla veya belirt (filtre yok). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın.	string[]
searchCriteria	Güncelleştirmeleri aramak için ölçütler. Varsayılanı kullanmak için boş dizeyi atla veya belirt (tümünü ara). Bu alanın örnekleri ve ayrıntılı açıklaması için yukarıdaki bağlantıya bakın.	dizgi
updateLimit	Bir kerede uygulanacak en fazla güncelleştirme sayısı. Varsayılan değeri kullanmak için 0 değerini atla veya belirt (1000)	Int Kısıtlama -ları: En düşük değer = 0

ImageTemplateDistributor

Ad	Açıklama	Değer
artifactTags	Dağıtımcı tarafından oluşturulduktan/güncelleştirildikten sonra yapıta uygulanacak etiketler.	nesne
runOutputName	İlişkili RunOutput için kullanılacak ad.	dize (gerekli) Kısıtlama -ları: Desen = `^[A-Za-z0-9-_.]{1,64}$`
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)
yer	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)
excludeFromLatest	Oluşturulan görüntü sürümünün en son sürümden dışlanıp dışlanmayacağını gösteren bayrak. Varsayılanı (false) kullanmak için atla.	Bool
galleryImageId	Azure İşlem Galerisi görüntüsünün Kaynak Kimliği	dize (gerekli)
replicationRegions	[Kullanım dışı] Görüntünün çoğaltılacağı bölgelerin listesi. Bu liste yalnızca targetRegions belirtilmemişse belirtilebilir. Bu alan kullanım dışı bırakıldı; bunun yerine targetRegions kullanın.	string[]
storageAccountType	[Kullanım dışı] Paylaşılan görüntüyü depolamak için kullanılacak depolama hesabı türü. Varsayılanı kullanmak için atla (Standard_LRS). Bu alan yalnızca replicationRegions belirtilirse belirtilebilir. Bu alan kullanım dışı bırakıldı; bunun yerine targetRegions kullanın.	"Premium_LRS" "Standard_LRS" "Standard_ZRS"
targetRegions	Dağıtılmış Görüntü Sürümünün çoğaltılacağı hedef bölgeler. Bu nesne replicationRegions değerinin yerini alır ve yalnızca replicationRegions belirtilmezse belirtilebilir.	TargetRegion[]
sürüm oluşturma	Dağıtım için yeni x.y.z sürüm numarasının nasıl oluşturulacağı açıklanır.	DistributeVersioner

TargetRegion

Ad	Açıklama	Değer
ad	Bölgenin adı.	dize (gerekli)
replicaCount	Bu bölgede oluşturulacak Görüntü Sürümünün çoğaltma sayısı. Varsayılanı (1) kullanmak için atla.	Int Kısıtlama -ları: Min değer = 1
storageAccountType	Görüntüyü bu bölgede depolamak için kullanılacak depolama hesabı türünü belirtir. Varsayılanı kullanmak için atla (Standard_LRS).	"Premium_LRS" "Standard_LRS" "Standard_ZRS"

DistributeVersioner

Ad	Açıklama	Değer
tertip etmek	Nesne türünü ayarlama	en son Kaynak (gerekli)

DistributeVersionerLatest

Ad	Açıklama	Değer
tertip etmek	Kullanılacak sürüm numaralandırma düzeni.	"En son" (gerekli)
binbaşı	Oluşturulan sürüm numarası için ana sürüm. Ana sürüm olarak bu değere sahip sürümlere göre "en son" değerini belirleyin. -1, kümeyi kümelenmemiş olarak bırakmakla eşdeğerdir.	Int

DistributeVersionerSource

Ad	Açıklama	Değer
tertip etmek	Kullanılacak sürüm numaralandırma düzeni.	"Kaynak" (gerekli)

ImageTemplateVhdDistributor

Ad	Açıklama	Değer
tür	Dağıtım türü.	"VHD" (gerekli)
Urı	Dağıtılmış VHD blobu için isteğe bağlı Azure Depolama URI'si. VHD'nin hazırlama kaynak grubundaki depolama hesabında yayımlandığı varsayılan dizeyi (boş dize) kullanmayı atla.	dizgi

ImageTemplatePropertiesErrorHandling

Ad	Açıklama	Değer
onCustomizerError	Özelleştirici hatası varsa ve bu alan 'temizleme' olarak ayarlandıysa, derleme VM'si ve ilişkili ağ kaynakları temizlenir. Bu, varsayılan davranıştır. Özelleştirici hatası varsa ve bu alan 'iptal' olarak ayarlandıysa, derleme VM'si korunur.	"abort" "temizleme"
onValidationError	Doğrulama hatası varsa ve bu alan 'temizleme' olarak ayarlandıysa, derleme VM'si ve ilişkili ağ kaynakları temizlenir. Bu, varsayılan davranıştır. Doğrulama hatası varsa ve bu alan 'iptal' olarak ayarlandıysa, derleme VM'si korunur.	"abort" "temizleme"

ImageTemplatePropertiesOptimize

Ad	Açıklama	Değer
vmBoot	Daha hızlı bir VM önyüklemesi için görüntüye iyileştirme uygulanır.	ImageTemplatePropertiesOptimizeVmBoot

ImageTemplatePropertiesOptimizeVmBoot

Ad	Açıklama	Değer
devlet	Bu alanın etkinleştirilmesi, son özelleştirilmiş görüntü çıkışını iyileştirerek VM önyükleme süresini iyileştirir.	"Devre dışı" "Etkin"

ImageTemplateSource

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

ImageTemplateManagedImageSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntü 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ü türünü belirtir.	"PlatformImage" (gerekli)
teklif	Azure Galeri Görüntüleriresim teklifi.	dizgi
planInfo	Platform görüntüsü için satın alma planının isteğe bağlı yapılandırması.	PlatformImagePurchasePlan
yayınevi	Azure Galeri Görüntülerigörüntü yayımcısı.	dizgi
Sku	Azure Galeri Görüntülerigörüntü sku'su.	dizgi
Sürüm	Azure Galeri Görüntülerigörüntü sürümü. Burada 'en son' belirtilirse, şablon gönderildiğinde değil görüntü derlemesi gerçekleştiğinde sürüm değerlendirilir.	dizgi

PlatformImagePurchasePlan

Ad	Açıklama	Değer
planName	Satın alma planının adı.	dize (gerekli)
planProduct	Satın alma planının ürünü.	dize (gerekli)
planPublisher	Satın alma planının yayımcısı.	dize (gerekli)

ImageTemplateSharedImageVersionSource

Ad	Açıklama	Değer
tür	Başlamak istediğiniz kaynak görüntü türünü belirtir.	"SharedImageVersion" (gerekli)
imageVersionId	Görüntü sürümünün ARM kaynak kimliği. Görüntü sürümü adı 'en son' olduğunda, görüntü derlemesi gerçekleştiğinde sürüm değerlendirilir.	dize (gerekli)

ImageTemplatePropertiesValidate

Ad	Açıklama	Değer
continueDistributeOnFailure	Doğrulama başarısız olursa ve bu alan false olarak ayarlanırsa, çıkış görüntüleri dağıtılmaz. Bu, varsayılan davranıştır. Doğrulama başarısız olursa ve bu alan true olarak ayarlanırsa, çıkış görüntüleri yine de dağıtılır. Hatalı görüntülerin kullanım için dağıtılmasıyla sonuçlanma ihtimaline karşı lütfen bu seçeneği dikkatli kullanın. Her iki durumda da (true veya false) uçtan uca görüntü çalıştırması, doğrulama hatası durumunda başarısız olduğu bildirilir. [Not: Doğrulama başarılı olursa bu alanın hiçbir etkisi olmaz.]	Bool
inVMValidations	Gerçekleştirilecek doğrulamaların listesi.	ImageTemplateInVMValidator[]
sourceValidationOnly	Bu alan true olarak ayarlanırsa, 'kaynak' bölümünde belirtilen görüntü doğrudan doğrulanır. Özelleştirilmiş bir görüntü oluşturmak ve doğrulamak için ayrı bir derleme çalıştırılamaz.	Bool

ImageTemplateInVMValidator

Ad	Açıklama	Değer
ad	Bu doğrulama adımının ne yaptığı hakkında bağlam sağlamak için Kolay Ad	dizgi
tür	Nesne türünü ayarlama	dosya PowerShell Kabuk (gerekli)

ImageTemplateFileValidator

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir	"Dosya" (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)	dizgi
sha256Checksum	Yukarıdaki sourceUri alanında sağlanan dosyanın SHA256 sağlama toplamı	dizgi
sourceUri	Doğrulama için VM'ye yüklenecek dosyanın URI'si. Github bağlantısı, Azure Depolama URI'si (yetkili veya SAS) vb. olabilir	dizgi

ImageTemplatePowerShellValidator

Ad	Açıklama	Değer
tür	Görüntüde kullanmak istediğiniz doğrulama türü. Örneğin, "Kabuk" kabuk doğrulaması olabilir	"PowerShell" (gerekli)
Satır içi	Yürütülecek PowerShell komutları dizisi	string[]
runAsSystem	Belirtilirse, PowerShell betiği Yerel Sistem kullanıcısı kullanılarak yükseltilmiş ayrıcalıklarla çalıştırılır. Yalnızca yukarıdaki runElevated alanı true olarak ayarlandığında true olabilir.	Bool
runElevated	Belirtilirse PowerShell betiği yükseltilmiş ayrıcalıklarla çalıştırılır	Bool
scriptUri	Doğrulama için çalıştırılacak PowerShell betiğinin URI'sini seçin. Github bağlantısı, Azure Depolama URI'si vb. olabilir	dizgi
sha256Checksum	Yukarıdaki scriptUri alanında sağlanan Power Shell betiğinin SHA256 sağlama toplamı	dizgi
validExitCodes	PowerShell betiği için geçerli çıkış kodları. [Varsayılan: 0]	int[]

ImageTemplateShellValidator

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

ImageTemplateVmProfile

Ad	Açıklama	Değer
osDiskSizeGB	İşletim sistemi diskinin GB cinsinden boyutu. Azure'ın varsayılan işletim sistemi disk boyutunu kullanmak için 0 değerini atlar veya belirtin.	Int Kısıtlama -ları: En düşük değer = 0
userAssignedIdentities	Derleme VM'sinde ve doğrulama VM'sinde yapılandırılacak, kullanıcı tarafından atanan yönetilen kimliklerin isteğe bağlı kaynak kimlikleri dizisi. Bu, görüntü şablonunun kimliğini içerebilir.	string[]
vmSize	Görüntüleri oluşturmak, özelleştirmek ve yakalamak için kullanılan sanal makinenin boyutu. Varsayılanı kullanmak için boş dizeyi atla veya belirt (1. Nesil görüntüleri için Standard_D1_v2 ve 2. Nesil görüntüleri için Standard_D2ds_v4).	dizgi
vnetConfig	derleme VM'sini ve doğrulama VM'sini dağıtmak için kullanılacak sanal ağın isteğe bağlı yapılandırması. Belirli bir sanal ağın kullanılması gerekmiyorsa atla.	VirtualNetworkConfig

VirtualNetworkConfig

Ad	Açıklama	Değer
containerInstanceSubnetId	Yalıtılmış Derlemeler için Azure Container Instance'ın dağıtılacağı önceden var olan bir alt ağın kaynak kimliği. Bu alan yalnızca `subnetId` da belirtilmişse belirtilebilir ve `subnetId`'de belirtilen alt ağ ile aynı Sanal Ağ üzerinde olmalıdır.	dizgi
proxyVmSize	Derleme VM'sine ve doğrulama VM'sine trafik geçirmek için kullanılan ara sunucu sanal makinesinin boyutu. Bu durumda hiçbir ara sunucu sanal makinesi dağıtılmadığından, `containerInstanceSubnetId` belirtildiyse bu belirtilmemelidir. Varsayılanı kullanmak için boş dizeyi atla veya belirt (Standard_A1_v2).	dizgi
subnetId	Derleme VM'sinin ve doğrulama VM'sinin dağıtılacağı önceden var olan bir alt ağın kaynak kimliği	dizgi

Aracılığıyla paylaş

Microsoft.VirtualMachineImages imageTemplates 2024-02-01

Bicep kaynak tanımı

Kaynak biçimi

ImageTemplateCustomizer nesneleri

ImageTemplateDistributor nesneleri

DistributeVersioner nesneleri

ImageTemplateSource nesneleri

ImageTemplateInVMValidator nesneleri

Özellik değerleri

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

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

ARM şablonu kaynak tanımı

Kaynak biçimi

ImageTemplateCustomizer nesneleri

ImageTemplateDistributor nesneleri

DistributeVersioner nesneleri

ImageTemplateSource nesneleri

ImageTemplateInVMValidator nesneleri

Özellik değerleri

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