Microsoft.VirtualMachineImages imageTemplates

  • Makale

Bicep kaynak tanımı

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

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@2022-02-14' = {
  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
    }
    stagingResourceGroup: 'string'
    validate: {
      continueDistributeOnFailure: bool
      inVMValidations: [
        {
          name: 'string'
          type: 'string'
          // For remaining properties, see ImageTemplateInVMValidator objects
        }
      ]
      sourceValidationOnly: bool
    }
    vmProfile: {
      osDiskSizeGB: int
      userAssignedIdentities: [
        'string'
      ]
      vmSize: 'string'
      vnetConfig: {
        proxyVmSize: 'string'
        subnetId: 'string'
      }
    }
  }
}

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'
  ]
  runAsSystem: bool
  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'

WindowsUpdate için şunu kullanın:

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

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'
  excludeFromLatest: bool
  galleryImageId: 'string'
  replicationRegions: [
    'string'
  ]
  storageAccountType: 'string'

VHD için şunu kullanın:

  type: 'VHD'

ImageTemplateSource nesneleri

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

ManagedImage için şunu kullanın:

  type: 'ManagedImage'
  imageId: 'string'

PlatformImage için şunu kullanın:

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

SharedImageVersion için şunu kullanın:

  type: 'SharedImageVersion'
  imageVersionId: 'string'

ImageTemplateInVMValidator nesneleri

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

PowerShell için şunu kullanın:

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

Shell için şunu kullanın:

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

Özellik değerleri

imageTemplates

Ad Açıklama Değer
name Kaynak adı dize (gerekli)
location Kaynağın bulunduğu coğrafi konum 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 (gerekli)
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ı (tüm özelleş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
Ö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)
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, şablon silme işlemi sırasında oluşturulan kaynak grubu silinir, ancak belirtilen kaynak grubu varsa, kaynak grubunda oluşturulan kaynaklar şablon silme işlemi sırasında silinir ve kaynak grubunun kendisi kalır. string
doğrulama 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

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
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ş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[]
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. 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

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ştirici olabilir 'WindowsUpdate' (gerekli)
filtreler Uygulanacak güncelleştirmeleri seçecek filtre dizisi. Varsayılanı kullanmak için boş dizi 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. string
updateLimit Bir kerede uygulanacak en fazla güncelleştirme sayısı. Varsayılan değeri kullanmak için 0 atla veya belirt (1000) int

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)
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) değerini kullanmak için atla. bool
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)
storageAccountType Paylaşılan görüntüyü depolamak için kullanılacak depolama hesabı türü. Varsayılan (Standard_LRS) kullanmak için atla. 'Standard_LRS'
'Standard_ZRS'

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 ManagedImage
PlatformImage
SharedImageVersion (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
planInfo Platform görüntüsü için satın alma planının isteğe bağlı yapılandırması. PlatformImagePurchasePlan
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ü. Burada 'en son' belirtilirse, şablon gönderildiğinde değil görüntü derlemesi gerçekleştiğinde sürüm değerlendirilir. string

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ü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)

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 dağıtılır. Hatalı görüntülerin kullanım için dağıtılmasıyla sonuçlandığı için 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ının 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
name Bu doğrulama adımının ne yaptığıyla ilgili bağlam sağlamak için Kolay Ad string
tür Nesne türünü ayarlama PowerShell
Kabuk (gerekli)

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)
inline 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. Bu bir github bağlantısı, Azure Depolama 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[]

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)
inline Yürütülecek kabuk komutları dizisi string[]
scriptUri Doğrulama için çalıştırılacak kabuk betiğinin URI'si. Bu bir github bağlantısı, Azure Depolama URI'si vb. olabilir string
sha256Checksum scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı string

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
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). string
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
proxyVmSize Derleme VM'sine ve doğrulama VM'sine trafik geçirmek için kullanılan ara sunucu sanal makinesinin boyutu. Varsayılan (Standard_A1_v2) kullanmak için boş dizeyi atla veya belirt. string
subnetId Önceden var olan bir alt ağın kaynak kimliği. 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

Azure’a dağıtın		 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

Azure’a dağıtın		 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.

ARM şablonu kaynak tanımı

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

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": "2022-02-14",
  "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
    },
    "stagingResourceGroup": "string",
    "validate": {
      "continueDistributeOnFailure": "bool",
      "inVMValidations": [
        {
          "name": "string",
          "type": "string"
          // For remaining properties, see ImageTemplateInVMValidator objects
        }
      ],
      "sourceValidationOnly": "bool"
    },
    "vmProfile": {
      "osDiskSizeGB": "int",
      "userAssignedIdentities": [ "string" ],
      "vmSize": "string",
      "vnetConfig": {
        "proxyVmSize": "string",
        "subnetId": "string"
      }
    }
  }
}

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" ],
  "runAsSystem": "bool",
  "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"

WindowsUpdate için şunu kullanın:

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

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",
  "excludeFromLatest": "bool",
  "galleryImageId": "string",
  "replicationRegions": [ "string" ],
  "storageAccountType": "string"

VHD için şunu kullanın:

  "type": "VHD"

ImageTemplateSource nesneleri

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

ManagedImage için şunu kullanın:

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

PlatformImage için şunu kullanın:

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

SharedImageVersion için şunu kullanın:

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

ImageTemplateInVMValidator nesneleri

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

PowerShell için şunu kullanın:

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

Shell iç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ü '2022-02-14'
name Kaynak adı dize (gerekli)
location Kaynağın bulunduğu coğrafi konum 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 (gerekli)
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ı (tüm özelleş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
Ö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)
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, şablon silme işlemi sırasında oluşturulan kaynak grubu silinir, ancak belirtilen kaynak grubu varsa, kaynak grubunda oluşturulan kaynaklar şablon silme sırasında silinir ve kaynak grubunun kendisi kalır. string
doğrulama 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

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
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ı ö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 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. 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

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ştirici olabilir 'WindowsUpdate' (gerekli)
filtreler Uygulanacak güncelleştirmeleri seçecek filtre dizisi. Varsayılanı kullanmak için boş dizi 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. string
updateLimit Bir kerede uygulanacak en fazla güncelleştirme sayısı. Varsayılan değeri kullanmak için 0 atla veya belirt (1000) int

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)
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 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)
storageAccountType Paylaşılan görüntüyü depolamak için kullanılacak depolama hesabı türü. Varsayılan (Standard_LRS) kullanmak için atla. 'Standard_LRS'
'Standard_ZRS'

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 ManagedImage
PlatformImage
SharedImageVersion (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
planInfo Platform görüntüsü için satın alma planının isteğe bağlı yapılandırması. PlatformImagePurchasePlan
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ü. Burada 'en son' belirtilirse, şablon gönderildiğinde değil görüntü derlemesi gerçekleştiğinde sürüm değerlendirilir. string

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ü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)

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 dağıtılır. Hatalı görüntülerin kullanım için dağıtılmasıyla sonuçlandığı için 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ının 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
name Bu doğrulama adımının ne yaptığıyla ilgili bağlam sağlamak için Kolay Ad string
tür Nesne türünü ayarlama PowerShell
Kabuk (gerekli)

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)
inline 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. Bu bir github bağlantısı, Azure Depolama 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[]

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)
inline Yürütülecek kabuk komutları dizisi string[]
scriptUri Doğrulama için çalıştırılacak kabuk betiğinin URI'si. Bu bir github bağlantısı, Azure Depolama URI'si vb. olabilir string
sha256Checksum scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı string

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
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). string
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
proxyVmSize Derleme VM'sine ve doğrulama VM'sine trafik geçirmek için kullanılan ara sunucu sanal makinesinin boyutu. Varsayılan (Standard_A1_v2) kullanmak için boş dizeyi atla veya belirt. string
subnetId Önceden var olan bir alt ağın kaynak kimliği. 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

Azure’a dağıtın		 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

Azure’a dağıtın		 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@2022-02-14"
  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
      }
      stagingResourceGroup = "string"
      validate = {
        continueDistributeOnFailure = bool
        inVMValidations = [
          {
            name = "string"
            type = "string"
            // For remaining properties, see ImageTemplateInVMValidator objects
          }
        ]
        sourceValidationOnly = bool
      }
      vmProfile = {
        osDiskSizeGB = int
        userAssignedIdentities = [
          "string"
        ]
        vmSize = "string"
        vnetConfig = {
          proxyVmSize = "string"
          subnetId = "string"
        }
      }
    }
  })
}

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"
  ]
  runAsSystem = bool
  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"

WindowsUpdate için şunu kullanın:

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

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"
  excludeFromLatest = bool
  galleryImageId = "string"
  replicationRegions = [
    "string"
  ]
  storageAccountType = "string"

VHD için şunu kullanın:

  type = "VHD"

ImageTemplateSource nesneleri

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

ManagedImage için şunu kullanın:

  type = "ManagedImage"
  imageId = "string"

PlatformImage için şunu kullanın:

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

SharedImageVersion için şunu kullanın:

  type = "SharedImageVersion"
  imageVersionId = "string"

ImageTemplateInVMValidator nesneleri

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

PowerShell için şunu kullanın:

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

Shell iç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@2022-02-14"
name Kaynak adı dize (gerekli)
location 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ının ve değerlerinin sözlüğü.
identity Görüntü şablonunun kimliği (yapılandırıldıysa). ImageTemplateIdentity (gerekli)
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ı (tüm özelleş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
Ö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)
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, şablon silme işlemi sırasında oluşturulan kaynak grubu silinir, ancak belirtilen kaynak grubu varsa, kaynak grubunda oluşturulan kaynaklar şablon silme işlemi sırasında silinir ve kaynak grubunun kendisi kalır. string
doğrulama 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

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
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ştirici 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) 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[]
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. 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 "Kabuk" (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

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ştirici olabilir "WindowsUpdate" (gerekli)
filtreler Uygulanacak güncelleştirmeleri seçecek filtre dizisi. Varsayılanı kullanmak için boş dizi 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. string
updateLimit Bir kerede uygulanacak en fazla güncelleştirme sayısı. Varsayılan değeri kullanmak için 0 atla veya belirt (1000) int

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)
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) değerini kullanmak için atla. bool
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)
storageAccountType Paylaşılan görüntüyü depolamak için kullanılacak depolama hesabı türü. Varsayılan (Standard_LRS) kullanmak için atla. "Standard_LRS"
"Standard_ZRS"

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 ManagedImage
PlatformImage
SharedImageVersion (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
planInfo Platform görüntüsü için satın alma planının isteğe bağlı yapılandırması. PlatformImagePurchasePlan
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ü. Burada 'en son' belirtilirse, şablon gönderildiğinde değil görüntü derlemesi gerçekleştiğinde sürüm değerlendirilir. string

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ü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)

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 dağıtılır. Hatalı görüntülerin kullanım için dağıtılmasıyla sonuçlandığı için 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ının 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
name Bu doğrulama adımının ne yaptığıyla ilgili bağlam sağlamak için Kolay Ad string
tür Nesne türünü ayarlama PowerShell
Kabuk (gerekli)

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)
inline 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. Bu bir github bağlantısı, Azure Depolama 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[]

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)
inline Yürütülecek kabuk komutları dizisi string[]
scriptUri Doğrulama için çalıştırılacak kabuk betiğinin URI'si. Bu bir github bağlantısı, Azure Depolama URI'si vb. olabilir string
sha256Checksum scriptUri alanında sağlanan kabuk betiğinin SHA256 sağlama toplamı string

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
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). string
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
proxyVmSize Derleme VM'sine ve doğrulama VM'sine trafik geçirmek için kullanılan ara sunucu sanal makinesinin boyutu. Varsayılan (Standard_A1_v2) kullanmak için boş dizeyi atla veya belirt. string
subnetId Önceden var olan bir alt ağın kaynak kimliği. string