Microsoft. VirtualMachineImages imageTemplates

Определение ресурса Bicep

Тип ресурса imageTemplates можно развернуть с помощью операций, целевых:

Для получения списка изменённых свойств в каждой версии API см. журнал изменений.

Примеры использования

Проверенные модули Azure

Следующие Azure Проверенные модули могут использоваться для развертывания этого типа ресурсов.

Module Description
шаблон изображения виртуальной машины Модуль ресурсов AVM для шаблона образа виртуальной машины

Примеры быстрого запуска Azure

Следующие шаблоны Azure Quickstart содержат Bicep образцов для развертывания этого типа ресурсов.

Bicep-файл Description
Azure Конструктор изображений с Azure Windows Baseline Создаёт среду Azure Image Builder и Windows Server образ с использованием последних Windows обновлений и Azure Windows базовой линии.
Конфигурация сервиса Dev Box Этот шаблон создаст все ресурсы администратора Dev Box согласно руководству быстрого запуска Dev Box (/azure/dev-box/quickstart-create-dev-box). Вы можете просмотреть все созданные ресурсы или напрямую перейти к DevPortal.microsoft.com для создания первого поля разработки.

Формат ресурса

Создать Microsoft. Ресурс VirtualMachineImages/imageTemplates добавьте следующий Bicep в ваш шаблон.

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2025-10-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    additionalDataDisks: [
      {
        sizeGB: int
      }
    ]
    autoRun: {
      state: 'string'
    }
    buildTimeoutInMinutes: int
    customize: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ]
    distribute: [
      {
        artifactTags: {
          {customized property}: 'string'
        }
        runOutputName: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ]
    errorHandling: {
      onCustomizerError: 'string'
      onValidationError: 'string'
    }
    managedResourceTags: {
      {customized property}: 'string'
    }
    optimize: {
      vmBoot: {
        state: 'string'
      }
      workload: {
        scriptUri: 'string'
        sha256Checksum: 'string'
        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'
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Объекты ImageTemplateSource

Задайте свойство type , чтобы указать тип объекта.

Для ManagedImage используйте:

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

Для PlatformImage используйте:

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

Для SharedImageVersion используйте:

{
  imageVersionId: 'string'
  type: 'SharedImageVersion'
}

Объекты ImageTemplateDistributor

Задайте свойство type , чтобы указать тип объекта.

Для ManagedImage используйте:

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

Для SharedImage используйте:

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

Для VHD используйте:

{
  type: 'VHD'
  uri: 'string'
}

Объекты ImageTemplateInVMValidator

Задайте свойство type , чтобы указать тип объекта.

Для файла используйте:

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

Для PowerShell используйте:

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

Для Shell используйте:

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

Объекты DistributeVersioner

Задайте свойство scheme , чтобы указать тип объекта.

В качестве последней версии используйте:

{
  major: int
  scheme: 'Latest'
}

Для Source используйте:

{
  scheme: 'Source'
}

Объекты ImageTemplateCustomizer

Задайте свойство type , чтобы указать тип объекта.

Для файла используйте:

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

Для PowerShell используйте:

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

Для Shell используйте:

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

Для WindowsRestart используйте:

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

Для WindowsUpdate используйте:

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

Значения свойств

Microsoft. VirtualMachineImages/imageTemplates

Name Description Value
identity Удостоверение шаблона изображения, если оно настроено. ImageTemplateIdentity (обязательно)
location Географическое расположение, в котором находится ресурс строка (обязательно)
name имя ресурса. string

Constraints:
Pattern = ^[A-Za-z0-9-_.]{1,64}$ (обязательно)
properties Свойства шаблона изображения ImageTemplateProperties
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах

DataDisk

Name Description Value
sizeGB Размер диска данных в ГБ. int

Constraints:
Минимальное значение = 0

DistributeVersioner

Name Description Value
scheme Установите значение "Последний" для типа DistributeVersionerLatest. Установите значение 'Source' для типа DistributeVersionerSource. 'Latest'
Source (обязательный)

DistributeVersionerLatest

Name Description Value
major Основная версия для созданного номера версии. Определите, что такое "последняя" на основе версий с этим значением в качестве основной версии. -1 эквивалентен выходу из него без набора. int

Constraints:
Минимальное значение = -1
scheme Используемая схема нумерирования версий. "Последнее" (обязательно)

DistributeVersionerSource

Name Description Value
scheme Используемая схема нумерирования версий. Source (обязательный)

ImageTemplateAutoRun

Name Description Value
state Включение этого поля приведет к активации автоматической сборки на основе создания шаблона образа или обновления. 'Disabled'
'Enabled'

ImageTemplateCustomizer

Name Description Value
name Понятное имя для предоставления контекста по этому шагу настройки string
type Установите значение "File" для типа ImageTemplateFileCustomizer. Установите значение 'PowerShell' для типа ImageTemplatePowerShellCustomizer. Установите значение 'Shell' для типа ImageTemplateShellCustomizer. Установите значение 'WindowsRestart' для типа ImageTemplateRestartCustomizer. Установите значение 'WindowsUpdate' для типа ImageTemplateWindowsUpdateCustomizer. 'File'
'PowerShell'
'Shell'
'WindowsRestart'
'WindowsUpdate' (обязательно)

ImageTemplateDistributor

Name Description Value
artifactTags Теги, которые будут применены к артефакту после его создания или обновления распространителем. ImageTemplateDistributorArtifactTags
runOutputName Имя, используемое для связанного runOutput. string

Constraints:
Pattern = ^[A-Za-z0-9-_.]{1,64}$ (обязательно)
type Установите значение "ManagedImage" для типа ImageTemplateManagedImageDistributor. Установите значение 'SharedImage' для типа ImageTemplateSharedImageDistributor. Установите значение "VHD" для типа ImageTemplateVhdDistributor. 'ManagedImage'
'SharedImage'
VHD (обязательно)

ImageTemplateDistributorArtifactTags

Name Description Value

ImageTemplateFileCustomizer

Name Description Value
destination Абсолютный путь к файлу (с уже созданными вложенными структурами каталогов), в котором файл (из sourceUri) будет отправлен в виртуальную машину. string
sha256Checksum Контрольная сумма SHA256 файла, предоставленного в поле sourceUri выше string
sourceUri URI файла, который необходимо отправить для настройки виртуальной машины. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки "Файл" (обязательный)

ImageTemplateFileValidator

Name Description Value
destination Абсолютный путь к файлу (с уже созданными вложенными структурами каталогов), в котором файл (из sourceUri) будет отправлен в виртуальную машину. string
sha256Checksum Контрольная сумма SHA256 файла, предоставленного в поле sourceUri выше string
sourceUri URI файла, который необходимо отправить на виртуальную машину для проверки. Это может быть ссылка на github, служба хранилища Azure URI (авторизованный или SAS) и так далее string
type Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки "Файл" (обязательный)

ImageTemplateIdentity

Name Description Value
type Тип удостоверения, используемого для шаблона изображения. Тип "Нет" приведет к удалению удостоверений из шаблона образа. 'None'
'UserAssigned'
userAssignedIdentities Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в виде: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. ImageTemplateIdentityUserAssignedIdentities

ImageTemplateIdentityUserAssignedIdentities

Name Description Value

ImageTemplateInVMValidator

Name Description Value
name Понятное имя для предоставления контекста по этому шагу проверки string
type Установите значение 'File' для типа ImageTemplateFileValidator. Установите значение 'PowerShell' для типа ImageTemplatePowerShellValidator. Установите значение 'Shell' для типа ImageTemplateShellValidator. 'File'
'PowerShell'
«Ракушка» (обязательно)

ImageTemplateManagedImageDistributor

Name Description Value
imageId Идентификатор ресурса образа управляемого диска строка (обязательно)
location Azure местоположение для изображения должно совпадать, если изображение уже существует строка (обязательно)
type Тип распределения. 'ManagedImage' (обязательно)

ImageTemplateManagedImageSource

Name Description Value
imageId Идентификатор ресурса ARM управляемого образа в подписке клиента строка (обязательно)
type Указывает тип исходного образа, с которого вы хотите начать. 'ManagedImage' (обязательно)

ImageTemplatePlatformImageSource

Name Description Value
offer Предложение изображения из галереи Azure Images. string
planInfo Необязательной конфигурации плана покупки для образа платформы. PlatformImagePurchasePlan
publisher Изображение Publisher в Azure Галерейные изображения. string
sku Изображение из галереи Azure Images. string
type Указывает тип исходного образа, с которого вы хотите начать. 'PlatformImage' (обязательно)
version Версия изображения из галереи Azure Images. Если здесь указана последняя версия, версия вычисляется при выполнении сборки образа, а не при отправке шаблона. string

ImageTemplatePowerShellCustomizer

Name Description Value
inline Массив команд PowerShell для выполнения string[]
runAsSystem Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями с помощью локального пользователя системы. Значение true может быть только в том случае, если указанное выше поле runElevated имеет значение true. bool
runElevated Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями bool
scriptUri URI скрипта PowerShell для настройки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта Power Shell, предоставленного в поле scriptUri выше string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки 'PowerShell' (обязательно)
validExitCodes Допустимые коды выхода для скрипта PowerShell. [По умолчанию: 0] int[]

ImageTemplatePowerShellValidator

Name Description Value
inline Массив команд PowerShell для выполнения string[]
runAsSystem Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями с помощью локального пользователя системы. Значение true может быть только в том случае, если указанное выше поле runElevated имеет значение true. bool
runElevated Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями bool
scriptUri URI скрипта PowerShell для проверки. Это может быть ссылка на github, служба хранилища Azure URI и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта Power Shell, предоставленного в поле scriptUri выше string
type Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки 'PowerShell' (обязательно)
validExitCodes Допустимые коды выхода для скрипта PowerShell. [По умолчанию: 0] int[]

ImageTemplateProperties

Name Description Value
дополнительные данныеDataDisks Опциональный массив дополнительных дисков данных, которые должны быть добавлены к образу. DataDisk[]
autoRun Указывает, следует ли автоматически запускать шаблон образа при создании или обновлении шаблона. ImageTemplateAutoRun
buildTimeoutInMinutes Максимальная длительность ожидания при создании шаблона образа (включает все настройки, оптимизацию, проверку и дистрибутивы). Опустить или указать значение 0, чтобы использовать значение по умолчанию (4 часа). int

Constraints:
Минимальное значение = 0
Максимальное значение = 960
customize Указывает свойства, используемые для описания шагов настройки изображения, таких как источник изображения и т. д. ImageTemplateCustomizer[]
distribute Целевые объекты распределения, в которых выходные данные изображения должны перейти. ImageTemplateDistributor[] (обязательно)
errorHandling Параметры обработки ошибок при сбое сборки ImageTemplatePropertiesErrorHandling
managedResourceTags Теги, которые будут применяться к группе ресурсов и /или ресурсам, созданным службой. ImageTemplatePropertiesManagedResourceTags
optimize Указывает оптимизацию, выполняемую на изображении. ImageTemplatePropertiesOptimize
source Указывает свойства, используемые для описания исходного образа. ImageTemplateSource (обязательно)
stagingResourceGroup Идентификатор промежуточной группы ресурсов в той же подписке, что и шаблон образа, который будет использоваться для сборки образа. Если это поле пусто, будет создана группа ресурсов со случайным именем. Если группа ресурсов, указанная в этом поле, не существует, она будет создана с тем же именем. Если указанная группа ресурсов существует, она должна быть пустой и в том же регионе, что и шаблон изображения. Созданная группа ресурсов будет удалена во время удаления шаблона, если это поле пусто или указанная группа ресурсов не существует, но если указанная группа ресурсов существует, ресурсы, созданные в группе ресурсов, будут удалены во время удаления шаблона, и сама группа ресурсов останется. string
validate Параметры конфигурации и список проверок, выполняемых на результирующем изображении. ImageTemplatePropertiesValidate
vmProfile Описание настройки виртуальной машины для создания образов ImageTemplateVmProfile

ImageTemplatePropertiesErrorHandling

Name Description Value
onCustomizerError Если имеется ошибка настройщика, и это поле имеет значение "очистка", виртуальная машина сборки и связанные сетевые ресурсы будут удалены. Это поведение по умолчанию. Если имеется ошибка настройщика, и это поле имеет значение "прерывание", виртуальная машина сборки будет сохранена. 'abort'
'cleanup'
onValidationError Если имеется ошибка проверки, и это поле имеет значение "очистка", виртуальная машина сборки и связанные сетевые ресурсы будут удалены. Это поведение по умолчанию. Если имеется ошибка проверки, и это поле имеет значение "прерывание", виртуальная машина сборки будет сохранена. 'abort'
'cleanup'

ImageTemplatePropertiesManagedResourceTags

Name Description Value

ImageTemplatePropertiesOptimize

Name Description Value
vmBoot Оптимизация применяется к образу для ускорения загрузки виртуальной машины. ImageTemplatePropertiesOptimizeVmBoot
Рабочая нагрузка Оптимизация применяется к изображению для конкретных рабочих нагрузок. ImageTemplatePropertiesOptimizeWorkload

ImageTemplatePropertiesOptimizeVmBoot

Name Description Value
state Включение этого поля улучшит время загрузки виртуальной машины, оптимизируя окончательные настраиваемые выходные данные образа. 'Disabled'
'Enabled'

ImageTemplatePropertiesOptimizeWorkload

Name Description Value
scriptUri URI скрипта для запуска для оптимизации рабочей нагрузки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта, предоставленная в поле scriptUri string
state Включение этого поля оптимизирует изображения виртуальных машин под конкретные рабочие нагрузки. 'Disabled'
'Enabled'

ImageTemplatePropertiesValidate

Name Description Value
continueDistributeOnFailure Если проверка завершается ошибкой, и это поле имеет значение false, выходные образы не будут распространяться. Это поведение по умолчанию. Если проверка завершается ошибкой, и это поле имеет значение true, выходные образы по-прежнему будут распределены. Используйте этот параметр с осторожностью, так как это может привести к распространению плохих образов для использования. В любом случае (true или false), выполнение конечного образа будет сообщаться о сбое при сбое проверки. [Примечание. Это поле не влияет на успешное выполнение проверки.] bool
inVMValidations Список выполняемых проверок. ImageTemplateInVMValidator[]
sourceValidationOnly Если для этого поля задано значение true, то изображение, указанное в разделе "источник", будет проверено напрямую. Отдельная сборка не будет выполняться для создания и проверки настраиваемого образа. bool

ImageTemplateRestartCustomizer

Name Description Value
restartCheckCommand Команда для проверки успешности перезапуска [по умолчанию: '' string
restartCommand Команда для выполнения перезапуска [по умолчанию: "завершение работы /r /f /t 0 /c"packer restart"] string
restartTimeout Время ожидания перезапуска, указанное в виде строки величины и единицы, например "5 м" (5 минут) или "2h" (2 часа) [по умолчанию: "5 млн" ] string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки 'WindowsRestart' (обязательно)

ImageTemplateSharedImageDistributor

Name Description Value
excludeFromLatest Флаг, указывающий, следует ли исключить созданную версию образа из последней версии. Не следует использовать значение по умолчанию (false). bool
galleryImageId Resource Id изображения Azure Compute Gallery строка (обязательно)
replicationMode Описывает режим репликации для распространения в Azure Compute Gallery. Опусти использование стандартного режима (Full). Full
"Неглубокий"
replicationRegions [Не рекомендуется] Список регионов, в которые будет реплицирован образ. Этот список можно указать только в том случае, если targetRegions не указан. Это поле устарело. Вместо этого используйте targetRegions. string[]
storageAccountType [Устарело] Тип аккаунта Storage для хранения общего изображения. Не следует использовать значение по умолчанию (Standard_LRS). Это поле можно указать только в том случае, если указан параметр replicationRegions. Это поле устарело. Вместо этого используйте targetRegions. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'
targetRegions Целевые регионы, в которых будет реплицироваться распределенная версия образа. Этот объект заменяет replicationRegions и может быть указан только в том случае, если репликацияRegions не указана. TargetRegion[]
type Тип распределения. 'SharedImage' (обязательно)
versioning Описывает создание нового номера версии x.y.z для распространения. DistributeVersioner

ImageTemplateSharedImageVersionSource

Name Description Value
imageVersionId Идентификатор ресурса ARM версии образа. Если имя версии образа является "последней", версия вычисляется при сборке образа. строка (обязательно)
type Указывает тип исходного образа, с которого вы хотите начать. 'SharedImageVersion' (обязательно)

ImageTemplateShellCustomizer

Name Description Value
inline Массив команд оболочки для выполнения string[]
scriptUri URI скрипта оболочки для настройки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта оболочки, указанная в поле scriptUri string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки «Ракушка» (обязательно)

ImageTemplateShellValidator

Name Description Value
inline Массив команд оболочки для выполнения string[]
scriptUri Универсальный код ресурса (URI) скрипта оболочки для проверки. Это может быть ссылка на github, служба хранилища Azure URI и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта оболочки, указанная в поле scriptUri string
type Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки «Ракушка» (обязательно)

ImageTemplateSource

Name Description Value
type Установите значение "ManagedImage" для типа ImageTemplateManagedImageSource. Установите значение 'PlatformImage' для типа ImageTemplatePlatformImageSource. Установите значение 'SharedImageVersion' для типа ImageTemplateSharedImageVersionSource. 'ManagedImage'
'PlatformImage'
'SharedImageVersion' (обязательно)

ImageTemplateVhdDistributor

Name Description Value
type Тип распределения. VHD (обязательно)
uri Опциональный служба хранилища Azure URI для распределённого VHD-blob. Опустите использование по умолчанию (пустой строки), в таком случае VHD будет опубликован в аккаунт storage в группе staging ресурсов. string

ImageTemplateVmProfile

Name Description Value
osDiskSizeGB Размер диска ОС в ГБ. Опустите или укажите 0, чтобы использовать стандартный размер диска Azure. int

Constraints:
Минимальное значение = 0
userAssignedIdentities Необязательный массив идентификаторов ресурсов назначенных пользователем управляемых удостоверений для настройки на виртуальной машине сборки и на виртуальной машине проверки. Это может включать удостоверение шаблона изображения. string[]
vmSize Размер виртуальной машины, используемой для создания, настройки и записи образов. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (Standard_D1_v2 для образов 1-го поколения и Standard_D2ds_v4 для образов 2-го поколения). string
vnetConfig Опциональная конфигурация virtual network для развертывания сборки и валидационной виртуальной машины. Опустите, если не требуется использовать конкретную virtual network. VirtualNetworkConfig

ImageTemplateWindowsUpdateCustomizer

Name Description Value
filters Массив фильтров для выбора обновлений для применения. Опустите или укажите пустой массив для использования по умолчанию (без фильтра). См. приведенную выше ссылку на примеры и подробное описание этого поля. string[]
searchCriteria Критерии поиска обновлений. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (выполните поиск всех). См. приведенную выше ссылку на примеры и подробное описание этого поля. string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки 'WindowsUpdate' (обязательно)
updateLimit Максимальное количество обновлений, применяемых за раз. Опустить или указать 0, чтобы использовать значение по умолчанию (1000) int

Constraints:
Минимальное значение = 0

PlatformImagePurchasePlan

Name Description Value
planName Имя плана покупки. строка (обязательно)
planProduct Продукт плана покупки. строка (обязательно)
planPublisher Издатель плана покупки. строка (обязательно)

TargetRegion

Name Description Value
name Имя региона. строка (обязательно)
replicaCount Количество реплик версии образа, создаваемых в этом регионе. Не следует использовать значение по умолчанию (1). int

Constraints:
Минимальное значение = 1
storageAccountType Указывает тип аккаунта storage, который используется для хранения изображения в этой области. Не следует использовать значение по умолчанию (Standard_LRS). 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

VirtualNetworkConfig

Name Description Value
containerInstanceSubnetId Идентификатор ресурса уже существующей подсети, на которой будет развернут экземпляр Azure Container для изолированных сборок. Это поле может быть указано только если также указана subnetId и должно находиться на той же виртуальная сеть, что и подсеть, указанная в subnetId. string
proxyVmSize Размер виртуальной машины прокси-сервера, используемой для передачи трафика на виртуальную машину сборки и проверку виртуальной машины. Это не должно быть указано, если containerInstanceSubnetId он указан, так как в этом случае виртуальная машина прокси-сервера не развертывается. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (Standard_A1_v2). string
subnetId Идентификатор ресурса предварительно существующей подсети, в которой будет развернута виртуальная машина сборки и проверка виртуальной машины. string

Определение ресурса шаблона ARM

Тип ресурса imageTemplates можно развернуть с помощью операций, целевых:

Примеры использования

Шаблоны быстрого запуска Azure

Следующие Azure шаблоны быстрого запуска развёртают этот тип ресурса.

Template Description
Azure Конструктор изображений с Azure Windows Baseline

Развернуться на Azure
Создаёт среду Azure Image Builder и Windows Server образ с использованием последних Windows обновлений и Azure Windows базовой линии.
Конфигурация сервиса Dev Box

Развернуться на Azure
Этот шаблон создаст все ресурсы администратора Dev Box согласно руководству быстрого запуска Dev Box (/azure/dev-box/quickstart-create-dev-box). Вы можете просмотреть все созданные ресурсы или напрямую перейти к DevPortal.microsoft.com для создания первого поля разработки.

Формат ресурса

Создать Microsoft. Ресурс VirtualMachineImages/imageTemplates, добавьте следующий JSON в ваш шаблон.

{
  "type": "Microsoft.VirtualMachineImages/imageTemplates",
  "apiVersion": "2025-10-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "additionalDataDisks": [
      {
        "sizeGB": "int"
      }
    ],
    "autoRun": {
      "state": "string"
    },
    "buildTimeoutInMinutes": "int",
    "customize": [ {
      "name": "string",
      "type": "string"
      // For remaining properties, see ImageTemplateCustomizer objects
    } ],
    "distribute": [ {
      "artifactTags": {
        "{customized property}": "string"
      },
      "runOutputName": "string",
      "type": "string"
      // For remaining properties, see ImageTemplateDistributor objects
    } ],
    "errorHandling": {
      "onCustomizerError": "string",
      "onValidationError": "string"
    },
    "managedResourceTags": {
      "{customized property}": "string"
    },
    "optimize": {
      "vmBoot": {
        "state": "string"
      },
      "workload": {
        "scriptUri": "string",
        "sha256Checksum": "string",
        "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"
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Объекты ImageTemplateSource

Задайте свойство type , чтобы указать тип объекта.

Для ManagedImage используйте:

{
  "imageId": "string",
  "type": "ManagedImage"
}

Для PlatformImage используйте:

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

Для SharedImageVersion используйте:

{
  "imageVersionId": "string",
  "type": "SharedImageVersion"
}

Объекты ImageTemplateDistributor

Задайте свойство type , чтобы указать тип объекта.

Для ManagedImage используйте:

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

Для SharedImage используйте:

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

Для VHD используйте:

{
  "type": "VHD",
  "uri": "string"
}

Объекты ImageTemplateInVMValidator

Задайте свойство type , чтобы указать тип объекта.

Для файла используйте:

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

Для PowerShell используйте:

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

Для Shell используйте:

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

Объекты DistributeVersioner

Задайте свойство scheme , чтобы указать тип объекта.

В качестве последней версии используйте:

{
  "major": "int",
  "scheme": "Latest"
}

Для Source используйте:

{
  "scheme": "Source"
}

Объекты ImageTemplateCustomizer

Задайте свойство type , чтобы указать тип объекта.

Для файла используйте:

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

Для PowerShell используйте:

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

Для Shell используйте:

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

Для WindowsRestart используйте:

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

Для WindowsUpdate используйте:

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

Значения свойств

Microsoft. VirtualMachineImages/imageTemplates

Name Description Value
apiVersion Версия API '2025-10-01'
identity Удостоверение шаблона изображения, если оно настроено. ImageTemplateIdentity (обязательно)
location Географическое расположение, в котором находится ресурс строка (обязательно)
name имя ресурса. string

Constraints:
Pattern = ^[A-Za-z0-9-_.]{1,64}$ (обязательно)
properties Свойства шаблона изображения ImageTemplateProperties
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
type Тип ресурса 'Microsoft. VirtualMachineImages/imageTemplates'

DataDisk

Name Description Value
sizeGB Размер диска данных в ГБ. int

Constraints:
Минимальное значение = 0

DistributeVersioner

Name Description Value
scheme Установите значение "Последний" для типа DistributeVersionerLatest. Установите значение 'Source' для типа DistributeVersionerSource. 'Latest'
Source (обязательный)

DistributeVersionerLatest

Name Description Value
major Основная версия для созданного номера версии. Определите, что такое "последняя" на основе версий с этим значением в качестве основной версии. -1 эквивалентен выходу из него без набора. int

Constraints:
Минимальное значение = -1
scheme Используемая схема нумерирования версий. "Последнее" (обязательно)

DistributeVersionerSource

Name Description Value
scheme Используемая схема нумерирования версий. Source (обязательный)

ImageTemplateAutoRun

Name Description Value
state Включение этого поля приведет к активации автоматической сборки на основе создания шаблона образа или обновления. 'Disabled'
'Enabled'

ImageTemplateCustomizer

Name Description Value
name Понятное имя для предоставления контекста по этому шагу настройки string
type Установите значение "File" для типа ImageTemplateFileCustomizer. Установите значение 'PowerShell' для типа ImageTemplatePowerShellCustomizer. Установите значение 'Shell' для типа ImageTemplateShellCustomizer. Установите значение 'WindowsRestart' для типа ImageTemplateRestartCustomizer. Установите значение 'WindowsUpdate' для типа ImageTemplateWindowsUpdateCustomizer. 'File'
'PowerShell'
'Shell'
'WindowsRestart'
'WindowsUpdate' (обязательно)

ImageTemplateDistributor

Name Description Value
artifactTags Теги, которые будут применены к артефакту после его создания или обновления распространителем. ImageTemplateDistributorArtifactTags
runOutputName Имя, используемое для связанного runOutput. string

Constraints:
Pattern = ^[A-Za-z0-9-_.]{1,64}$ (обязательно)
type Установите значение "ManagedImage" для типа ImageTemplateManagedImageDistributor. Установите значение 'SharedImage' для типа ImageTemplateSharedImageDistributor. Установите значение "VHD" для типа ImageTemplateVhdDistributor. 'ManagedImage'
'SharedImage'
VHD (обязательно)

ImageTemplateDistributorArtifactTags

Name Description Value

ImageTemplateFileCustomizer

Name Description Value
destination Абсолютный путь к файлу (с уже созданными вложенными структурами каталогов), в котором файл (из sourceUri) будет отправлен в виртуальную машину. string
sha256Checksum Контрольная сумма SHA256 файла, предоставленного в поле sourceUri выше string
sourceUri URI файла, который необходимо отправить для настройки виртуальной машины. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки "Файл" (обязательный)

ImageTemplateFileValidator

Name Description Value
destination Абсолютный путь к файлу (с уже созданными вложенными структурами каталогов), в котором файл (из sourceUri) будет отправлен в виртуальную машину. string
sha256Checksum Контрольная сумма SHA256 файла, предоставленного в поле sourceUri выше string
sourceUri URI файла, который необходимо отправить на виртуальную машину для проверки. Это может быть ссылка на github, служба хранилища Azure URI (авторизованный или SAS) и так далее string
type Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки "Файл" (обязательный)

ImageTemplateIdentity

Name Description Value
type Тип удостоверения, используемого для шаблона изображения. Тип "Нет" приведет к удалению удостоверений из шаблона образа. 'None'
'UserAssigned'
userAssignedIdentities Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в виде: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. ImageTemplateIdentityUserAssignedIdentities

ImageTemplateIdentityUserAssignedIdentities

Name Description Value

ImageTemplateInVMValidator

Name Description Value
name Понятное имя для предоставления контекста по этому шагу проверки string
type Установите значение 'File' для типа ImageTemplateFileValidator. Установите значение 'PowerShell' для типа ImageTemplatePowerShellValidator. Установите значение 'Shell' для типа ImageTemplateShellValidator. 'File'
'PowerShell'
«Ракушка» (обязательно)

ImageTemplateManagedImageDistributor

Name Description Value
imageId Идентификатор ресурса образа управляемого диска строка (обязательно)
location Azure местоположение для изображения должно совпадать, если изображение уже существует строка (обязательно)
type Тип распределения. 'ManagedImage' (обязательно)

ImageTemplateManagedImageSource

Name Description Value
imageId Идентификатор ресурса ARM управляемого образа в подписке клиента строка (обязательно)
type Указывает тип исходного образа, с которого вы хотите начать. 'ManagedImage' (обязательно)

ImageTemplatePlatformImageSource

Name Description Value
offer Предложение изображения из галереи Azure Images. string
planInfo Необязательной конфигурации плана покупки для образа платформы. PlatformImagePurchasePlan
publisher Изображение Publisher в Azure Галерейные изображения. string
sku Изображение из галереи Azure Images. string
type Указывает тип исходного образа, с которого вы хотите начать. 'PlatformImage' (обязательно)
version Версия изображения из галереи Azure Images. Если здесь указана последняя версия, версия вычисляется при выполнении сборки образа, а не при отправке шаблона. string

ImageTemplatePowerShellCustomizer

Name Description Value
inline Массив команд PowerShell для выполнения string[]
runAsSystem Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями с помощью локального пользователя системы. Значение true может быть только в том случае, если указанное выше поле runElevated имеет значение true. bool
runElevated Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями bool
scriptUri URI скрипта PowerShell для настройки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта Power Shell, предоставленного в поле scriptUri выше string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки 'PowerShell' (обязательно)
validExitCodes Допустимые коды выхода для скрипта PowerShell. [По умолчанию: 0] int[]

ImageTemplatePowerShellValidator

Name Description Value
inline Массив команд PowerShell для выполнения string[]
runAsSystem Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями с помощью локального пользователя системы. Значение true может быть только в том случае, если указанное выше поле runElevated имеет значение true. bool
runElevated Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями bool
scriptUri URI скрипта PowerShell для проверки. Это может быть ссылка на github, служба хранилища Azure URI и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта Power Shell, предоставленного в поле scriptUri выше string
type Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки 'PowerShell' (обязательно)
validExitCodes Допустимые коды выхода для скрипта PowerShell. [По умолчанию: 0] int[]

ImageTemplateProperties

Name Description Value
дополнительные данныеDataDisks Опциональный массив дополнительных дисков данных, которые должны быть добавлены к образу. DataDisk[]
autoRun Указывает, следует ли автоматически запускать шаблон образа при создании или обновлении шаблона. ImageTemplateAutoRun
buildTimeoutInMinutes Максимальная длительность ожидания при создании шаблона образа (включает все настройки, оптимизацию, проверку и дистрибутивы). Опустить или указать значение 0, чтобы использовать значение по умолчанию (4 часа). int

Constraints:
Минимальное значение = 0
Максимальное значение = 960
customize Указывает свойства, используемые для описания шагов настройки изображения, таких как источник изображения и т. д. ImageTemplateCustomizer[]
distribute Целевые объекты распределения, в которых выходные данные изображения должны перейти. ImageTemplateDistributor[] (обязательно)
errorHandling Параметры обработки ошибок при сбое сборки ImageTemplatePropertiesErrorHandling
managedResourceTags Теги, которые будут применяться к группе ресурсов и /или ресурсам, созданным службой. ImageTemplatePropertiesManagedResourceTags
optimize Указывает оптимизацию, выполняемую на изображении. ImageTemplatePropertiesOptimize
source Указывает свойства, используемые для описания исходного образа. ImageTemplateSource (обязательно)
stagingResourceGroup Идентификатор промежуточной группы ресурсов в той же подписке, что и шаблон образа, который будет использоваться для сборки образа. Если это поле пусто, будет создана группа ресурсов со случайным именем. Если группа ресурсов, указанная в этом поле, не существует, она будет создана с тем же именем. Если указанная группа ресурсов существует, она должна быть пустой и в том же регионе, что и шаблон изображения. Созданная группа ресурсов будет удалена во время удаления шаблона, если это поле пусто или указанная группа ресурсов не существует, но если указанная группа ресурсов существует, ресурсы, созданные в группе ресурсов, будут удалены во время удаления шаблона, и сама группа ресурсов останется. string
validate Параметры конфигурации и список проверок, выполняемых на результирующем изображении. ImageTemplatePropertiesValidate
vmProfile Описание настройки виртуальной машины для создания образов ImageTemplateVmProfile

ImageTemplatePropertiesErrorHandling

Name Description Value
onCustomizerError Если имеется ошибка настройщика, и это поле имеет значение "очистка", виртуальная машина сборки и связанные сетевые ресурсы будут удалены. Это поведение по умолчанию. Если имеется ошибка настройщика, и это поле имеет значение "прерывание", виртуальная машина сборки будет сохранена. 'abort'
'cleanup'
onValidationError Если имеется ошибка проверки, и это поле имеет значение "очистка", виртуальная машина сборки и связанные сетевые ресурсы будут удалены. Это поведение по умолчанию. Если имеется ошибка проверки, и это поле имеет значение "прерывание", виртуальная машина сборки будет сохранена. 'abort'
'cleanup'

ImageTemplatePropertiesManagedResourceTags

Name Description Value

ImageTemplatePropertiesOptimize

Name Description Value
vmBoot Оптимизация применяется к образу для ускорения загрузки виртуальной машины. ImageTemplatePropertiesOptimizeVmBoot
Рабочая нагрузка Оптимизация применяется к изображению для конкретных рабочих нагрузок. ImageTemplatePropertiesOptimizeWorkload

ImageTemplatePropertiesOptimizeVmBoot

Name Description Value
state Включение этого поля улучшит время загрузки виртуальной машины, оптимизируя окончательные настраиваемые выходные данные образа. 'Disabled'
'Enabled'

ImageTemplatePropertiesOptimizeWorkload

Name Description Value
scriptUri URI скрипта для запуска для оптимизации рабочей нагрузки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта, предоставленная в поле scriptUri string
state Включение этого поля оптимизирует изображения виртуальных машин под конкретные рабочие нагрузки. 'Disabled'
'Enabled'

ImageTemplatePropertiesValidate

Name Description Value
continueDistributeOnFailure Если проверка завершается ошибкой, и это поле имеет значение false, выходные образы не будут распространяться. Это поведение по умолчанию. Если проверка завершается ошибкой, и это поле имеет значение true, выходные образы по-прежнему будут распределены. Используйте этот параметр с осторожностью, так как это может привести к распространению плохих образов для использования. В любом случае (true или false), выполнение конечного образа будет сообщаться о сбое при сбое проверки. [Примечание. Это поле не влияет на успешное выполнение проверки.] bool
inVMValidations Список выполняемых проверок. ImageTemplateInVMValidator[]
sourceValidationOnly Если для этого поля задано значение true, то изображение, указанное в разделе "источник", будет проверено напрямую. Отдельная сборка не будет выполняться для создания и проверки настраиваемого образа. bool

ImageTemplateRestartCustomizer

Name Description Value
restartCheckCommand Команда для проверки успешности перезапуска [по умолчанию: '' string
restartCommand Команда для выполнения перезапуска [по умолчанию: "завершение работы /r /f /t 0 /c"packer restart"] string
restartTimeout Время ожидания перезапуска, указанное в виде строки величины и единицы, например "5 м" (5 минут) или "2h" (2 часа) [по умолчанию: "5 млн" ] string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки 'WindowsRestart' (обязательно)

ImageTemplateSharedImageDistributor

Name Description Value
excludeFromLatest Флаг, указывающий, следует ли исключить созданную версию образа из последней версии. Не следует использовать значение по умолчанию (false). bool
galleryImageId Resource Id изображения Azure Compute Gallery строка (обязательно)
replicationMode Описывает режим репликации для распространения в Azure Compute Gallery. Опусти использование стандартного режима (Full). Full
"Неглубокий"
replicationRegions [Не рекомендуется] Список регионов, в которые будет реплицирован образ. Этот список можно указать только в том случае, если targetRegions не указан. Это поле устарело. Вместо этого используйте targetRegions. string[]
storageAccountType [Устарело] Тип аккаунта Storage для хранения общего изображения. Не следует использовать значение по умолчанию (Standard_LRS). Это поле можно указать только в том случае, если указан параметр replicationRegions. Это поле устарело. Вместо этого используйте targetRegions. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'
targetRegions Целевые регионы, в которых будет реплицироваться распределенная версия образа. Этот объект заменяет replicationRegions и может быть указан только в том случае, если репликацияRegions не указана. TargetRegion[]
type Тип распределения. 'SharedImage' (обязательно)
versioning Описывает создание нового номера версии x.y.z для распространения. DistributeVersioner

ImageTemplateSharedImageVersionSource

Name Description Value
imageVersionId Идентификатор ресурса ARM версии образа. Если имя версии образа является "последней", версия вычисляется при сборке образа. строка (обязательно)
type Указывает тип исходного образа, с которого вы хотите начать. 'SharedImageVersion' (обязательно)

ImageTemplateShellCustomizer

Name Description Value
inline Массив команд оболочки для выполнения string[]
scriptUri URI скрипта оболочки для настройки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта оболочки, указанная в поле scriptUri string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки «Ракушка» (обязательно)

ImageTemplateShellValidator

Name Description Value
inline Массив команд оболочки для выполнения string[]
scriptUri Универсальный код ресурса (URI) скрипта оболочки для проверки. Это может быть ссылка на github, служба хранилища Azure URI и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта оболочки, указанная в поле scriptUri string
type Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки «Ракушка» (обязательно)

ImageTemplateSource

Name Description Value
type Установите значение "ManagedImage" для типа ImageTemplateManagedImageSource. Установите значение 'PlatformImage' для типа ImageTemplatePlatformImageSource. Установите значение 'SharedImageVersion' для типа ImageTemplateSharedImageVersionSource. 'ManagedImage'
'PlatformImage'
'SharedImageVersion' (обязательно)

ImageTemplateVhdDistributor

Name Description Value
type Тип распределения. VHD (обязательно)
uri Опциональный служба хранилища Azure URI для распределённого VHD-blob. Опустите использование по умолчанию (пустой строки), в таком случае VHD будет опубликован в аккаунт storage в группе staging ресурсов. string

ImageTemplateVmProfile

Name Description Value
osDiskSizeGB Размер диска ОС в ГБ. Опустите или укажите 0, чтобы использовать стандартный размер диска Azure. int

Constraints:
Минимальное значение = 0
userAssignedIdentities Необязательный массив идентификаторов ресурсов назначенных пользователем управляемых удостоверений для настройки на виртуальной машине сборки и на виртуальной машине проверки. Это может включать удостоверение шаблона изображения. string[]
vmSize Размер виртуальной машины, используемой для создания, настройки и записи образов. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (Standard_D1_v2 для образов 1-го поколения и Standard_D2ds_v4 для образов 2-го поколения). string
vnetConfig Опциональная конфигурация virtual network для развертывания сборки и валидационной виртуальной машины. Опустите, если не требуется использовать конкретную virtual network. VirtualNetworkConfig

ImageTemplateWindowsUpdateCustomizer

Name Description Value
filters Массив фильтров для выбора обновлений для применения. Опустите или укажите пустой массив для использования по умолчанию (без фильтра). См. приведенную выше ссылку на примеры и подробное описание этого поля. string[]
searchCriteria Критерии поиска обновлений. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (выполните поиск всех). См. приведенную выше ссылку на примеры и подробное описание этого поля. string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки 'WindowsUpdate' (обязательно)
updateLimit Максимальное количество обновлений, применяемых за раз. Опустить или указать 0, чтобы использовать значение по умолчанию (1000) int

Constraints:
Минимальное значение = 0

PlatformImagePurchasePlan

Name Description Value
planName Имя плана покупки. строка (обязательно)
planProduct Продукт плана покупки. строка (обязательно)
planPublisher Издатель плана покупки. строка (обязательно)

TargetRegion

Name Description Value
name Имя региона. строка (обязательно)
replicaCount Количество реплик версии образа, создаваемых в этом регионе. Не следует использовать значение по умолчанию (1). int

Constraints:
Минимальное значение = 1
storageAccountType Указывает тип аккаунта storage, который используется для хранения изображения в этой области. Не следует использовать значение по умолчанию (Standard_LRS). 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

VirtualNetworkConfig

Name Description Value
containerInstanceSubnetId Идентификатор ресурса уже существующей подсети, на которой будет развернут экземпляр Azure Container для изолированных сборок. Это поле может быть указано только если также указана subnetId и должно находиться на той же виртуальная сеть, что и подсеть, указанная в subnetId. string
proxyVmSize Размер виртуальной машины прокси-сервера, используемой для передачи трафика на виртуальную машину сборки и проверку виртуальной машины. Это не должно быть указано, если containerInstanceSubnetId он указан, так как в этом случае виртуальная машина прокси-сервера не развертывается. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (Standard_A1_v2). string
subnetId Идентификатор ресурса предварительно существующей подсети, в которой будет развернута виртуальная машина сборки и проверка виртуальной машины. string

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса imageTemplates можно развернуть с помощью операций, целевых:

Формат ресурса

Создать Microsoft. Ресурс VirtualMachineImages/imageTemplates, добавьте следующий Terraform в ваш шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.VirtualMachineImages/imageTemplates@2025-10-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      additionalDataDisks = [
        {
          sizeGB = int
        }
      ]
      autoRun = {
        state = "string"
      }
      buildTimeoutInMinutes = int
      customize = [
        {
          name = "string"
          type = "string"
          // For remaining properties, see ImageTemplateCustomizer objects
        }
      ]
      distribute = [
        {
          artifactTags = {
            {customized property} = "string"
          }
          runOutputName = "string"
          type = "string"
          // For remaining properties, see ImageTemplateDistributor objects
        }
      ]
      errorHandling = {
        onCustomizerError = "string"
        onValidationError = "string"
      }
      managedResourceTags = {
        {customized property} = "string"
      }
      optimize = {
        vmBoot = {
          state = "string"
        }
        workload = {
          scriptUri = "string"
          sha256Checksum = "string"
          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"
        }
      }
    }
  }
}

Объекты ImageTemplateSource

Задайте свойство type , чтобы указать тип объекта.

Для ManagedImage используйте:

{
  imageId = "string"
  type = "ManagedImage"
}

Для PlatformImage используйте:

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

Для SharedImageVersion используйте:

{
  imageVersionId = "string"
  type = "SharedImageVersion"
}

Объекты ImageTemplateDistributor

Задайте свойство type , чтобы указать тип объекта.

Для ManagedImage используйте:

{
  imageId = "string"
  location = "string"
  type = "ManagedImage"
}

Для SharedImage используйте:

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

Для VHD используйте:

{
  type = "VHD"
  uri = "string"
}

Объекты ImageTemplateInVMValidator

Задайте свойство type , чтобы указать тип объекта.

Для файла используйте:

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

Для PowerShell используйте:

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

Для Shell используйте:

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

Объекты DistributeVersioner

Задайте свойство scheme , чтобы указать тип объекта.

В качестве последней версии используйте:

{
  major = int
  scheme = "Latest"
}

Для Source используйте:

{
  scheme = "Source"
}

Объекты ImageTemplateCustomizer

Задайте свойство type , чтобы указать тип объекта.

Для файла используйте:

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

Для PowerShell используйте:

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

Для Shell используйте:

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

Для WindowsRestart используйте:

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

Для WindowsUpdate используйте:

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

Значения свойств

Microsoft. VirtualMachineImages/imageTemplates

Name Description Value
identity Удостоверение шаблона изображения, если оно настроено. ImageTemplateIdentity (обязательно)
location Географическое расположение, в котором находится ресурс строка (обязательно)
name имя ресурса. string

Constraints:
Pattern = ^[A-Za-z0-9-_.]{1,64}$ (обязательно)
properties Свойства шаблона изображения ImageTemplateProperties
tags Теги ресурсов Словарь имен и значений тегов.
type Тип ресурса "Microsoft.VirtualMachineImages/imageTemplates@2025-10-01"

DataDisk

Name Description Value
sizeGB Размер диска данных в ГБ. int

Constraints:
Минимальное значение = 0

DistributeVersioner

Name Description Value
scheme Установите значение "Последний" для типа DistributeVersionerLatest. Установите значение 'Source' для типа DistributeVersionerSource. 'Latest'
Source (обязательный)

DistributeVersionerLatest

Name Description Value
major Основная версия для созданного номера версии. Определите, что такое "последняя" на основе версий с этим значением в качестве основной версии. -1 эквивалентен выходу из него без набора. int

Constraints:
Минимальное значение = -1
scheme Используемая схема нумерирования версий. "Последнее" (обязательно)

DistributeVersionerSource

Name Description Value
scheme Используемая схема нумерирования версий. Source (обязательный)

ImageTemplateAutoRun

Name Description Value
state Включение этого поля приведет к активации автоматической сборки на основе создания шаблона образа или обновления. 'Disabled'
'Enabled'

ImageTemplateCustomizer

Name Description Value
name Понятное имя для предоставления контекста по этому шагу настройки string
type Установите значение "File" для типа ImageTemplateFileCustomizer. Установите значение 'PowerShell' для типа ImageTemplatePowerShellCustomizer. Установите значение 'Shell' для типа ImageTemplateShellCustomizer. Установите значение 'WindowsRestart' для типа ImageTemplateRestartCustomizer. Установите значение 'WindowsUpdate' для типа ImageTemplateWindowsUpdateCustomizer. 'File'
'PowerShell'
'Shell'
'WindowsRestart'
'WindowsUpdate' (обязательно)

ImageTemplateDistributor

Name Description Value
artifactTags Теги, которые будут применены к артефакту после его создания или обновления распространителем. ImageTemplateDistributorArtifactTags
runOutputName Имя, используемое для связанного runOutput. string

Constraints:
Pattern = ^[A-Za-z0-9-_.]{1,64}$ (обязательно)
type Установите значение "ManagedImage" для типа ImageTemplateManagedImageDistributor. Установите значение 'SharedImage' для типа ImageTemplateSharedImageDistributor. Установите значение "VHD" для типа ImageTemplateVhdDistributor. 'ManagedImage'
'SharedImage'
VHD (обязательно)

ImageTemplateDistributorArtifactTags

Name Description Value

ImageTemplateFileCustomizer

Name Description Value
destination Абсолютный путь к файлу (с уже созданными вложенными структурами каталогов), в котором файл (из sourceUri) будет отправлен в виртуальную машину. string
sha256Checksum Контрольная сумма SHA256 файла, предоставленного в поле sourceUri выше string
sourceUri URI файла, который необходимо отправить для настройки виртуальной машины. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки "Файл" (обязательный)

ImageTemplateFileValidator

Name Description Value
destination Абсолютный путь к файлу (с уже созданными вложенными структурами каталогов), в котором файл (из sourceUri) будет отправлен в виртуальную машину. string
sha256Checksum Контрольная сумма SHA256 файла, предоставленного в поле sourceUri выше string
sourceUri URI файла, который необходимо отправить на виртуальную машину для проверки. Это может быть ссылка на github, служба хранилища Azure URI (авторизованный или SAS) и так далее string
type Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки "Файл" (обязательный)

ImageTemplateIdentity

Name Description Value
type Тип удостоверения, используемого для шаблона изображения. Тип "Нет" приведет к удалению удостоверений из шаблона образа. 'None'
'UserAssigned'
userAssignedIdentities Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в виде: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах. ImageTemplateIdentityUserAssignedIdentities

ImageTemplateIdentityUserAssignedIdentities

Name Description Value

ImageTemplateInVMValidator

Name Description Value
name Понятное имя для предоставления контекста по этому шагу проверки string
type Установите значение 'File' для типа ImageTemplateFileValidator. Установите значение 'PowerShell' для типа ImageTemplatePowerShellValidator. Установите значение 'Shell' для типа ImageTemplateShellValidator. 'File'
'PowerShell'
«Ракушка» (обязательно)

ImageTemplateManagedImageDistributor

Name Description Value
imageId Идентификатор ресурса образа управляемого диска строка (обязательно)
location Azure местоположение для изображения должно совпадать, если изображение уже существует строка (обязательно)
type Тип распределения. 'ManagedImage' (обязательно)

ImageTemplateManagedImageSource

Name Description Value
imageId Идентификатор ресурса ARM управляемого образа в подписке клиента строка (обязательно)
type Указывает тип исходного образа, с которого вы хотите начать. 'ManagedImage' (обязательно)

ImageTemplatePlatformImageSource

Name Description Value
offer Предложение изображения из галереи Azure Images. string
planInfo Необязательной конфигурации плана покупки для образа платформы. PlatformImagePurchasePlan
publisher Изображение Publisher в Azure Галерейные изображения. string
sku Изображение из галереи Azure Images. string
type Указывает тип исходного образа, с которого вы хотите начать. 'PlatformImage' (обязательно)
version Версия изображения из галереи Azure Images. Если здесь указана последняя версия, версия вычисляется при выполнении сборки образа, а не при отправке шаблона. string

ImageTemplatePowerShellCustomizer

Name Description Value
inline Массив команд PowerShell для выполнения string[]
runAsSystem Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями с помощью локального пользователя системы. Значение true может быть только в том случае, если указанное выше поле runElevated имеет значение true. bool
runElevated Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями bool
scriptUri URI скрипта PowerShell для настройки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта Power Shell, предоставленного в поле scriptUri выше string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки 'PowerShell' (обязательно)
validExitCodes Допустимые коды выхода для скрипта PowerShell. [По умолчанию: 0] int[]

ImageTemplatePowerShellValidator

Name Description Value
inline Массив команд PowerShell для выполнения string[]
runAsSystem Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями с помощью локального пользователя системы. Значение true может быть только в том случае, если указанное выше поле runElevated имеет значение true. bool
runElevated Если задано, скрипт PowerShell будет выполняться с повышенными привилегиями bool
scriptUri URI скрипта PowerShell для проверки. Это может быть ссылка на github, служба хранилища Azure URI и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта Power Shell, предоставленного в поле scriptUri выше string
type Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки 'PowerShell' (обязательно)
validExitCodes Допустимые коды выхода для скрипта PowerShell. [По умолчанию: 0] int[]

ImageTemplateProperties

Name Description Value
дополнительные данныеDataDisks Опциональный массив дополнительных дисков данных, которые должны быть добавлены к образу. DataDisk[]
autoRun Указывает, следует ли автоматически запускать шаблон образа при создании или обновлении шаблона. ImageTemplateAutoRun
buildTimeoutInMinutes Максимальная длительность ожидания при создании шаблона образа (включает все настройки, оптимизацию, проверку и дистрибутивы). Опустить или указать значение 0, чтобы использовать значение по умолчанию (4 часа). int

Constraints:
Минимальное значение = 0
Максимальное значение = 960
customize Указывает свойства, используемые для описания шагов настройки изображения, таких как источник изображения и т. д. ImageTemplateCustomizer[]
distribute Целевые объекты распределения, в которых выходные данные изображения должны перейти. ImageTemplateDistributor[] (обязательно)
errorHandling Параметры обработки ошибок при сбое сборки ImageTemplatePropertiesErrorHandling
managedResourceTags Теги, которые будут применяться к группе ресурсов и /или ресурсам, созданным службой. ImageTemplatePropertiesManagedResourceTags
optimize Указывает оптимизацию, выполняемую на изображении. ImageTemplatePropertiesOptimize
source Указывает свойства, используемые для описания исходного образа. ImageTemplateSource (обязательно)
stagingResourceGroup Идентификатор промежуточной группы ресурсов в той же подписке, что и шаблон образа, который будет использоваться для сборки образа. Если это поле пусто, будет создана группа ресурсов со случайным именем. Если группа ресурсов, указанная в этом поле, не существует, она будет создана с тем же именем. Если указанная группа ресурсов существует, она должна быть пустой и в том же регионе, что и шаблон изображения. Созданная группа ресурсов будет удалена во время удаления шаблона, если это поле пусто или указанная группа ресурсов не существует, но если указанная группа ресурсов существует, ресурсы, созданные в группе ресурсов, будут удалены во время удаления шаблона, и сама группа ресурсов останется. string
validate Параметры конфигурации и список проверок, выполняемых на результирующем изображении. ImageTemplatePropertiesValidate
vmProfile Описание настройки виртуальной машины для создания образов ImageTemplateVmProfile

ImageTemplatePropertiesErrorHandling

Name Description Value
onCustomizerError Если имеется ошибка настройщика, и это поле имеет значение "очистка", виртуальная машина сборки и связанные сетевые ресурсы будут удалены. Это поведение по умолчанию. Если имеется ошибка настройщика, и это поле имеет значение "прерывание", виртуальная машина сборки будет сохранена. 'abort'
'cleanup'
onValidationError Если имеется ошибка проверки, и это поле имеет значение "очистка", виртуальная машина сборки и связанные сетевые ресурсы будут удалены. Это поведение по умолчанию. Если имеется ошибка проверки, и это поле имеет значение "прерывание", виртуальная машина сборки будет сохранена. 'abort'
'cleanup'

ImageTemplatePropertiesManagedResourceTags

Name Description Value

ImageTemplatePropertiesOptimize

Name Description Value
vmBoot Оптимизация применяется к образу для ускорения загрузки виртуальной машины. ImageTemplatePropertiesOptimizeVmBoot
Рабочая нагрузка Оптимизация применяется к изображению для конкретных рабочих нагрузок. ImageTemplatePropertiesOptimizeWorkload

ImageTemplatePropertiesOptimizeVmBoot

Name Description Value
state Включение этого поля улучшит время загрузки виртуальной машины, оптимизируя окончательные настраиваемые выходные данные образа. 'Disabled'
'Enabled'

ImageTemplatePropertiesOptimizeWorkload

Name Description Value
scriptUri URI скрипта для запуска для оптимизации рабочей нагрузки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта, предоставленная в поле scriptUri string
state Включение этого поля оптимизирует изображения виртуальных машин под конкретные рабочие нагрузки. 'Disabled'
'Enabled'

ImageTemplatePropertiesValidate

Name Description Value
continueDistributeOnFailure Если проверка завершается ошибкой, и это поле имеет значение false, выходные образы не будут распространяться. Это поведение по умолчанию. Если проверка завершается ошибкой, и это поле имеет значение true, выходные образы по-прежнему будут распределены. Используйте этот параметр с осторожностью, так как это может привести к распространению плохих образов для использования. В любом случае (true или false), выполнение конечного образа будет сообщаться о сбое при сбое проверки. [Примечание. Это поле не влияет на успешное выполнение проверки.] bool
inVMValidations Список выполняемых проверок. ImageTemplateInVMValidator[]
sourceValidationOnly Если для этого поля задано значение true, то изображение, указанное в разделе "источник", будет проверено напрямую. Отдельная сборка не будет выполняться для создания и проверки настраиваемого образа. bool

ImageTemplateRestartCustomizer

Name Description Value
restartCheckCommand Команда для проверки успешности перезапуска [по умолчанию: '' string
restartCommand Команда для выполнения перезапуска [по умолчанию: "завершение работы /r /f /t 0 /c"packer restart"] string
restartTimeout Время ожидания перезапуска, указанное в виде строки величины и единицы, например "5 м" (5 минут) или "2h" (2 часа) [по умолчанию: "5 млн" ] string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки 'WindowsRestart' (обязательно)

ImageTemplateSharedImageDistributor

Name Description Value
excludeFromLatest Флаг, указывающий, следует ли исключить созданную версию образа из последней версии. Не следует использовать значение по умолчанию (false). bool
galleryImageId Resource Id изображения Azure Compute Gallery строка (обязательно)
replicationMode Описывает режим репликации для распространения в Azure Compute Gallery. Опусти использование стандартного режима (Full). Full
"Неглубокий"
replicationRegions [Не рекомендуется] Список регионов, в которые будет реплицирован образ. Этот список можно указать только в том случае, если targetRegions не указан. Это поле устарело. Вместо этого используйте targetRegions. string[]
storageAccountType [Устарело] Тип аккаунта Storage для хранения общего изображения. Не следует использовать значение по умолчанию (Standard_LRS). Это поле можно указать только в том случае, если указан параметр replicationRegions. Это поле устарело. Вместо этого используйте targetRegions. 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'
targetRegions Целевые регионы, в которых будет реплицироваться распределенная версия образа. Этот объект заменяет replicationRegions и может быть указан только в том случае, если репликацияRegions не указана. TargetRegion[]
type Тип распределения. 'SharedImage' (обязательно)
versioning Описывает создание нового номера версии x.y.z для распространения. DistributeVersioner

ImageTemplateSharedImageVersionSource

Name Description Value
imageVersionId Идентификатор ресурса ARM версии образа. Если имя версии образа является "последней", версия вычисляется при сборке образа. строка (обязательно)
type Указывает тип исходного образа, с которого вы хотите начать. 'SharedImageVersion' (обязательно)

ImageTemplateShellCustomizer

Name Description Value
inline Массив команд оболочки для выполнения string[]
scriptUri URI скрипта оболочки для настройки. Это может быть ссылка на github, SAS URI для служба хранилища Azure и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта оболочки, указанная в поле scriptUri string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки «Ракушка» (обязательно)

ImageTemplateShellValidator

Name Description Value
inline Массив команд оболочки для выполнения string[]
scriptUri Универсальный код ресурса (URI) скрипта оболочки для проверки. Это может быть ссылка на github, служба хранилища Azure URI и так далее string
sha256Checksum Контрольная сумма SHA256 скрипта оболочки, указанная в поле scriptUri string
type Тип проверки, которую вы хотите использовать на изображении. Например, "Shell" может быть проверкой оболочки «Ракушка» (обязательно)

ImageTemplateSource

Name Description Value
type Установите значение "ManagedImage" для типа ImageTemplateManagedImageSource. Установите значение 'PlatformImage' для типа ImageTemplatePlatformImageSource. Установите значение 'SharedImageVersion' для типа ImageTemplateSharedImageVersionSource. 'ManagedImage'
'PlatformImage'
'SharedImageVersion' (обязательно)

ImageTemplateVhdDistributor

Name Description Value
type Тип распределения. VHD (обязательно)
uri Опциональный служба хранилища Azure URI для распределённого VHD-blob. Опустите использование по умолчанию (пустой строки), в таком случае VHD будет опубликован в аккаунт storage в группе staging ресурсов. string

ImageTemplateVmProfile

Name Description Value
osDiskSizeGB Размер диска ОС в ГБ. Опустите или укажите 0, чтобы использовать стандартный размер диска Azure. int

Constraints:
Минимальное значение = 0
userAssignedIdentities Необязательный массив идентификаторов ресурсов назначенных пользователем управляемых удостоверений для настройки на виртуальной машине сборки и на виртуальной машине проверки. Это может включать удостоверение шаблона изображения. string[]
vmSize Размер виртуальной машины, используемой для создания, настройки и записи образов. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (Standard_D1_v2 для образов 1-го поколения и Standard_D2ds_v4 для образов 2-го поколения). string
vnetConfig Опциональная конфигурация virtual network для развертывания сборки и валидационной виртуальной машины. Опустите, если не требуется использовать конкретную virtual network. VirtualNetworkConfig

ImageTemplateWindowsUpdateCustomizer

Name Description Value
filters Массив фильтров для выбора обновлений для применения. Опустите или укажите пустой массив для использования по умолчанию (без фильтра). См. приведенную выше ссылку на примеры и подробное описание этого поля. string[]
searchCriteria Критерии поиска обновлений. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (выполните поиск всех). См. приведенную выше ссылку на примеры и подробное описание этого поля. string
type Тип средства настройки, которое вы хотите использовать на изображении. Например, "Оболочка" может быть настройщиком оболочки 'WindowsUpdate' (обязательно)
updateLimit Максимальное количество обновлений, применяемых за раз. Опустить или указать 0, чтобы использовать значение по умолчанию (1000) int

Constraints:
Минимальное значение = 0

PlatformImagePurchasePlan

Name Description Value
planName Имя плана покупки. строка (обязательно)
planProduct Продукт плана покупки. строка (обязательно)
planPublisher Издатель плана покупки. строка (обязательно)

TargetRegion

Name Description Value
name Имя региона. строка (обязательно)
replicaCount Количество реплик версии образа, создаваемых в этом регионе. Не следует использовать значение по умолчанию (1). int

Constraints:
Минимальное значение = 1
storageAccountType Указывает тип аккаунта storage, который используется для хранения изображения в этой области. Не следует использовать значение по умолчанию (Standard_LRS). 'Premium_LRS'
'Standard_LRS'
'Standard_ZRS'

TrackedResourceTags

Name Description Value

UserAssignedIdentity

Name Description Value

VirtualNetworkConfig

Name Description Value
containerInstanceSubnetId Идентификатор ресурса уже существующей подсети, на которой будет развернут экземпляр Azure Container для изолированных сборок. Это поле может быть указано только если также указана subnetId и должно находиться на той же виртуальная сеть, что и подсеть, указанная в subnetId. string
proxyVmSize Размер виртуальной машины прокси-сервера, используемой для передачи трафика на виртуальную машину сборки и проверку виртуальной машины. Это не должно быть указано, если containerInstanceSubnetId он указан, так как в этом случае виртуальная машина прокси-сервера не развертывается. Опустить или указать пустую строку, чтобы использовать значение по умолчанию (Standard_A1_v2). string
subnetId Идентификатор ресурса предварительно существующей подсети, в которой будет развернута виртуальная машина сборки и проверка виртуальной машины. string