Microsoft.VirtualMachineImages imageTemplates 2024-02-01

아티클
10/19/2024

Bicep 리소스 정의

imageTemplates 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.VirtualMachineImages/imageTemplates 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2024-02-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    autoRun: {
      state: 'string'
    }
    buildTimeoutInMinutes: int
    customize: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ]
    distribute: [
      {
        artifactTags: {}
        runOutputName: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ]
    errorHandling: {
      onCustomizerError: 'string'
      onValidationError: 'string'
    }
    managedResourceTags: {}
    optimize: {
      vmBoot: {
        state: 'string'
      }
    }
    source: {
      type: 'string'
      // For remaining properties, see ImageTemplateSource objects
    }
    stagingResourceGroup: 'string'
    validate: {
      continueDistributeOnFailure: bool
      inVMValidations: [
        {
          name: 'string'
          type: 'string'
          // For remaining properties, see ImageTemplateInVMValidator objects
        }
      ]
      sourceValidationOnly: bool
    }
    vmProfile: {
      osDiskSizeGB: int
      userAssignedIdentities: [
        'string'
      ]
      vmSize: 'string'
      vnetConfig: {
        containerInstanceSubnetId: 'string'
        proxyVmSize: 'string'
        subnetId: 'string'
      }
    }
  }
}

ImageTemplateCustomizer 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

파일경우 다음을 사용합니다.

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

PowerShell경우 다음을 사용합니다.

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

Shell경우 다음을 사용합니다.

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

windowsRestart경우 다음을 사용합니다.

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

windowsUpdate경우 다음을 사용합니다.

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

ImageTemplateDistributor 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

ManagedImage경우 다음을 사용합니다.

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

sharedImage경우 다음을 사용합니다.

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

VHD경우 다음을 사용합니다.

  type: 'VHD'
  uri: 'string'

DistributeVersioner 개체

개체의 형식을 지정하려면 체계 속성을 설정합니다.

최신경우 다음을 사용합니다.

  scheme: 'Latest'
  major: int

원본경우 다음을 사용합니다.

  scheme: 'Source'

ImageTemplateSource 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

ManagedImage경우 다음을 사용합니다.

  type: 'ManagedImage'
  imageId: 'string'

PlatformImage경우 다음을 사용합니다.

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

sharedImageVersion경우 다음을 사용합니다.

  type: 'SharedImageVersion'
  imageVersionId: 'string'

ImageTemplateInVMValidator 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

파일경우 다음을 사용합니다.

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

PowerShell경우 다음을 사용합니다.

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

Shell경우 다음을 사용합니다.

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

속성 값

imageTemplates

이름	묘사	값
이름	리소스 이름	string(필수)
위치	리소스가 있는 지리적 위치	string(필수)
태그	리소스 태그.	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
신원	구성된 경우 이미지 템플릿의 ID입니다.	imageTemplateIdentity (필수)
속성	이미지 템플릿의 속성	imageTemplateProperties

ImageTemplateIdentity

이름	묘사	값
형	이미지 템플릿에 사용되는 ID의 형식입니다. 'None' 형식은 이미지 템플릿에서 모든 ID를 제거합니다.	'None' 'UserAssigned'
userAssignedIdentities	리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.	UserAssignedIdentities

UserAssignedIdentities

이름	묘사	값
{customized property}		UserAssignedIdentity

UserAssignedIdentity

이 개체에는 배포 중에 설정할 속성이 없습니다. 모든 속성은 ReadOnly입니다.

ImageTemplateProperties

이름	묘사	값
autoRun	템플릿 만들기 또는 업데이트에서 이미지 템플릿 빌드를 자동으로 실행할지 여부를 나타냅니다.	ImageTemplateAutoRun
buildTimeoutInMinutes	이미지 템플릿을 빌드하는 동안 대기할 최대 기간(모든 사용자 지정, 최적화, 유효성 검사 및 배포 포함). 기본값(4시간)을 사용하려면 0을 생략하거나 지정합니다.	int 제약 조건: 최소값 = 0 최대값 = 960
사용자 지정	이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다.	imageTemplateCustomizer[]
배포	이미지 출력을 이동해야 하는 배포 대상입니다.	imageTemplateDistributor[] (필수)
errorHandling	빌드 실패 시 오류 처리 옵션	imageTemplatePropertiesErrorHandling
managedResourceTags	서비스에서 만든 리소스 그룹 및/또는 리소스에 적용할 태그입니다.	객체
최적화	이미지에서 수행할 최적화를 지정합니다.	imageTemplatePropertiesOptimize
근원	원본 이미지를 설명하는 데 사용되는 속성을 지정합니다.	imageTemplateSource (필수)
stagingResourceGroup	이미지를 빌드하는 데 사용할 이미지 템플릿과 동일한 구독의 준비 리소스 그룹 ID입니다. 이 필드가 비어 있으면 임의 이름을 가진 리소스 그룹이 만들어집니다. 이 필드에 지정된 리소스 그룹이 없으면 동일한 이름으로 생성됩니다. 지정된 리소스 그룹이 있는 경우 비어 있어야 하며 이미지 템플릿과 동일한 지역에 있어야 합니다. 이 필드가 비어 있거나 지정된 리소스 그룹이 없는 경우 템플릿 삭제 중에 만든 리소스 그룹이 삭제되지만 지정된 리소스 그룹이 있는 경우 템플릿을 삭제하는 동안 리소스 그룹에서 만든 리소스가 삭제되고 리소스 그룹 자체는 유지됩니다.	문자열
확인	결과 이미지에서 수행할 구성 옵션 및 유효성 검사 목록입니다.	imageTemplatePropertiesValidate
vmProfile	가상 머신을 설정하여 이미지를 빌드하는 방법을 설명합니다.	ImageTemplateVmProfile

ImageTemplateAutoRun

이름	묘사	값
상태	이 필드를 사용하도록 설정하면 이미지 템플릿 만들기 또는 업데이트에 대한 자동 빌드가 트리거됩니다.	'사용 안 함' 'Enabled'

ImageTemplateCustomizer

이름	묘사	값
이름	이 사용자 지정 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름	문자열
형	개체 유형 설정	파일 PowerShell 셸 windowsRestart windowsUpdate (필수)

ImageTemplateFileCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	'File'(필수)
목적지	sourceUri에서 파일을 VM에 업로드할 파일의 절대 경로(이미 만들어진 중첩된 디렉터리 구조 포함)	문자열
sha256Checksum	위의 sourceUri 필드에 제공된 파일의 SHA256 체크섬	문자열
sourceUri	VM을 사용자 지정하기 위해 업로드할 파일의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.	문자열

ImageTemplatePowerShellCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	'PowerShell'(필수)
인라인	실행할 PowerShell 명령 배열	string[]
runAsSystem	지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다.	bool
runElevated	지정된 경우 PowerShell 스크립트는 상승된 권한으로 실행됩니다.	bool
scriptUri	사용자 지정을 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.	문자열
sha256Checksum	위의 scriptUri 필드에 제공된 Power Shell 스크립트의 SHA256 체크섬	문자열
validExitCodes	PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0]	int[]

ImageTemplateShellCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	'Shell'(필수)
인라인	실행할 셸 명령 배열	string[]
scriptUri	사용자 지정을 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.	문자열
sha256Checksum	scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬	문자열

ImageTemplateRestartCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	'WindowsRestart'(필수)
restartCheckCommand	다시 시작이 성공했는지 확인하는 명령 [기본값: '']	문자열
restartCommand	다시 시작을 실행하는 명령 [기본값: 'shutdown /r /f /t 0 /c "packer restart"']	문자열
restartTimeout	크기 및 단위의 문자열로 지정된 다시 시작 시간 제한(예: '5m'(5분) 또는 '2h'(2시간) [기본값: '5m']	문자열

ImageTemplateWindowsUpdateCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	'WindowsUpdate'(필수)
필터	적용할 업데이트를 선택할 필터 배열입니다. 기본값을 사용하도록 빈 배열을 생략하거나 지정합니다(필터 없음). 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요.	string[]
searchCriteria	업데이트를 검색할 조건입니다. 기본값을 사용하도록 빈 문자열을 생략하거나 지정합니다(모두 검색). 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요.	문자열
updateLimit	한 번에 적용할 최대 업데이트 수입니다. 기본값을 사용하려면 0을 생략하거나 지정합니다(1000).	int 제약 조건: 최소값 = 0

ImageTemplateDistributor

이름	묘사	값
artifactTags	배포자에 의해 아티팩트가 생성/업데이트되면 아티팩트에 적용될 태그입니다.	객체
runOutputName	연결된 RunOutput에 사용할 이름입니다.	string(필수) 제약 조건: 패턴 = `^[A-Za-z0-9-_.]{1,64}$`
형	개체 유형 설정	ManagedImage sharedImage VHD (필수)

ImageTemplateManagedImageDistributor

이름	묘사	값
형	배포 유형입니다.	'ManagedImage'(필수)
imageId	Managed Disk 이미지의 리소스 ID	string(필수)
위치	이미지의 Azure 위치는 이미지가 이미 있는 경우 일치해야 합니다.	string(필수)

ImageTemplateSharedImageDistributor

이름	묘사	값
형	배포 유형입니다.	'SharedImage'(필수)
excludeFromLatest	만든 이미지 버전을 최신 버전에서 제외해야 하는지 여부를 나타내는 플래그입니다. 기본값(false)을 사용하지 않습니다.	bool
galleryImageId	Azure Compute 갤러리 이미지의 리소스 ID	string(필수)
replicationRegions	[사용되지 않음] 이미지가 복제될 지역 목록입니다. targetRegions를 지정하지 않은 경우에만 이 목록을 지정할 수 있습니다. 이 필드는 더 이상 사용되지 않습니다. 대신 targetRegions를 사용합니다.	string[]
storageAccountType	[사용되지 않음] 공유 이미지를 저장하는 데 사용할 스토리지 계정 유형입니다. 기본값(Standard_LRS)을 사용하지 않습니다. 이 필드는 replicationRegions가 지정된 경우에만 지정할 수 있습니다. 이 필드는 더 이상 사용되지 않습니다. 대신 targetRegions를 사용합니다.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'
targetRegions	분산 이미지 버전이 복제될 대상 지역입니다. 이 개체는 replicationRegions를 대체하며 replicationRegions를 지정하지 않은 경우에만 지정할 수 있습니다.	TargetRegion[]
버전 관리	배포를 위해 새 x.y.z 버전 번호를 생성하는 방법을 설명합니다.	DistributeVersioner

TargetRegion

이름	묘사	값
이름	지역 이름입니다.	string(필수)
replicaCount	이 지역에서 만들 이미지 버전의 복제본 수입니다. 기본값(1)을 사용하지 않습니다.	int 제약 조건: 최소값 = 1
storageAccountType	이 지역에 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 기본값(Standard_LRS)을 사용하지 않습니다.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

DistributeVersioner

이름	묘사	값
음모	개체 유형 설정	최신 원본(필수)

DistributeVersionerLatest

이름	묘사	값
음모	사용할 버전 번호 매기기 체계입니다.	'Latest'(필수)
전공	생성된 버전 번호의 주 버전입니다. 이 값을 주 버전으로 사용하는 버전에 따라 "최신"이 무엇인지 확인합니다. -1은 설정되지 않은 상태로 두는 것과 같습니다.	int

DistributeVersionerSource

이름	묘사	값
음모	사용할 버전 번호 매기기 체계입니다.	'Source'(필수)

ImageTemplateVhdDistributor

이름	묘사	값
형	배포 유형입니다.	'VHD'(필수)
uri	분산 VHD Blob에 대한 선택적 Azure Storage URI입니다. 기본값(빈 문자열)을 사용하지 않습니다. 이 경우 VHD는 준비 리소스 그룹의 스토리지 계정에 게시됩니다.	문자열

ImageTemplatePropertiesErrorHandling

이름	묘사	값
onCustomizerError	사용자 지정자 오류가 있고 이 필드가 '정리'로 설정된 경우 빌드 VM 및 연결된 네트워크 리소스가 정리됩니다. 이것이 기본 동작입니다. 사용자 지정자 오류가 있고 이 필드가 '중단'으로 설정된 경우 빌드 VM이 유지됩니다.	'abort' 'cleanup'
onValidationError	유효성 검사 오류가 있고 이 필드가 '정리'로 설정된 경우 빌드 VM 및 연결된 네트워크 리소스가 정리됩니다. 이것이 기본 동작입니다. 유효성 검사 오류가 있고 이 필드가 '중단'으로 설정된 경우 빌드 VM이 유지됩니다.	'abort' 'cleanup'

ImageTemplatePropertiesOptimize

이름	묘사	값
vmBoot	더 빠른 VM 부팅을 위해 이미지에 최적화가 적용됩니다.	imageTemplatePropertiesOptimizeVmBoot

ImageTemplatePropertiesOptimizeVmBoot

이름	묘사	값
상태	이 필드를 사용하도록 설정하면 최종 사용자 지정된 이미지 출력을 최적화하여 VM 부팅 시간이 향상됩니다.	'사용 안 함' 'Enabled'

ImageTemplateSource

이름	묘사	값
형	개체 유형 설정	ManagedImage platformImage sharedImageVersion (필수)

ImageTemplateManagedImageSource

이름	묘사	값
형	시작하려는 원본 이미지의 형식을 지정합니다.	'ManagedImage'(필수)
imageId	고객 구독에서 관리되는 이미지의 ARM 리소스 ID	string(필수)

ImageTemplatePlatformImageSource

이름	묘사	값
형	시작하려는 원본 이미지의 형식을 지정합니다.	'PlatformImage'(필수)
제공	Azure Gallery 이미지이미지 제품.	문자열
planInfo	플랫폼 이미지에 대한 구매 계획의 선택적 구성입니다.	platformImagePurchasePlan
게시자	Azure Gallery 이미지이미지 게시자.	문자열
sku	Azure Gallery 이미지이미지 sku.	문자열
버전	Azure Gallery 이미지이미지 버전입니다. 여기서 'latest'를 지정하면 템플릿을 제출할 때가 아니라 이미지 빌드가 발생할 때 버전이 평가됩니다.	문자열

PlatformImagePurchasePlan

이름	묘사	값
planName	구매 플랜의 이름입니다.	string(필수)
planProduct	구매 플랜의 제품입니다.	string(필수)
planPublisher	구매 플랜의 게시자입니다.	string(필수)

ImageTemplateSharedImageVersionSource

이름	묘사	값
형	시작하려는 원본 이미지의 형식을 지정합니다.	'SharedImageVersion'(필수)
imageVersionId	이미지 버전의 ARM 리소스 ID입니다. 이미지 버전 이름이 '최신'인 경우 이미지 빌드가 발생할 때 버전이 평가됩니다.	string(필수)

ImageTemplatePropertiesValidate

이름	묘사	값
continueDistributeOnFailure	유효성 검사가 실패하고 이 필드가 false로 설정되면 출력 이미지가 배포되지 않습니다. 이것이 기본 동작입니다. 유효성 검사가 실패하고 이 필드가 true로 설정된 경우 출력 이미지는 계속 배포됩니다. 잘못된 이미지가 배포될 수 있으므로 이 옵션을 주의해서 사용하세요. 두 경우 모두(true 또는 false) 엔드 투 엔드 이미지 실행은 유효성 검사 실패 시 실패한 것으로 보고됩니다. [참고: 유효성 검사에 성공하면 이 필드는 효과가 없습니다.]	bool
inVMValidations	수행할 유효성 검사 목록입니다.	imageTemplateInVMValidator[]
sourceValidationOnly	이 필드를 true로 설정하면 'source' 섹션에 지정된 이미지의 유효성이 직접 검사됩니다. 사용자 지정된 이미지를 생성하고 유효성을 검사하기 위해 별도의 빌드가 실행되지 않습니다.	bool

ImageTemplateInVMValidator

이름	묘사	값
이름	이 유효성 검사 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름	문자열
형	개체 유형 설정	파일 PowerShell Shell(필수)

ImageTemplateFileValidator

이름	묘사	값
형	이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.	'File'(필수)
목적지	sourceUri에서 파일을 VM에 업로드할 파일의 절대 경로(이미 만들어진 중첩된 디렉터리 구조 포함)	문자열
sha256Checksum	위의 sourceUri 필드에 제공된 파일의 SHA256 체크섬	문자열
sourceUri	유효성 검사를 위해 VM에 업로드할 파일의 URI입니다. Github 링크, Azure Storage URI(권한 있는 또는 SAS) 등일 수 있습니다.	문자열

ImageTemplatePowerShellValidator

이름	묘사	값
형	이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.	'PowerShell'(필수)
인라인	실행할 PowerShell 명령 배열	string[]
runAsSystem	지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다.	bool
runElevated	지정된 경우 PowerShell 스크립트는 상승된 권한으로 실행됩니다.	bool
scriptUri	유효성 검사를 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage URI 등일 수 있습니다.	문자열
sha256Checksum	위의 scriptUri 필드에 제공된 Power Shell 스크립트의 SHA256 체크섬	문자열
validExitCodes	PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0]	int[]

ImageTemplateShellValidator

이름	묘사	값
형	이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.	'Shell'(필수)
인라인	실행할 셸 명령 배열	string[]
scriptUri	유효성 검사를 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage URI 등일 수 있습니다.	문자열
sha256Checksum	scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬	문자열

ImageTemplateVmProfile

이름	묘사	값
osDiskSizeGB	OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다.	int 제약 조건: 최소값 = 0
userAssignedIdentities	빌드 VM 및 유효성 검사 VM에서 구성할 사용자 할당 관리 ID의 리소스 ID의 선택적 배열입니다. 여기에는 이미지 템플릿의 ID가 포함될 수 있습니다.	string[]
vmSize	이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4).	문자열
vnetConfig	빌드 VM 및 유효성 검사 VM을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다.	VirtualNetworkConfig

VirtualNetworkConfig

이름	묘사	값
containerInstanceSubnetId	격리된 빌드에 대해 Azure Container Instance를 배포할 기존 서브넷의 리소스 ID입니다. 이 필드는 `subnetId` 지정되고 `subnetId`지정된 서브넷과 동일한 Virtual Network에 있어야 하는 경우에만 지정할 수 있습니다.	문자열
proxyVmSize	빌드 VM 및 유효성 검사 VM에 트래픽을 전달하는 데 사용되는 프록시 가상 머신의 크기입니다. 이 경우 프록시 가상 머신이 배포되지 않으므로 `containerInstanceSubnetId` 지정한 경우에는 지정해서는 안 됩니다. 기본값(Standard_A1_v2)을 사용하도록 빈 문자열을 생략하거나 지정합니다.	문자열
subnetId	빌드 VM 및 유효성 검사 VM이 배포될 기존 서브넷의 리소스 ID	문자열

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플렛	묘사
Azure Windows 기준 사용하여 Azure Image Builder Azure 배포	Azure Image Builder 환경을 만들고 최신 Windows 업데이트 및 Azure Windows 기준이 적용된 Windows Server 이미지를 빌드합니다.
Dev Box 서비스 구성 Azure 배포	이 템플릿은 Dev Box 빠른 시작 가이드(https://learn.microsoft.com/azure/dev-box/quickstart-create-dev-box)에 따라 모든 Dev Box 관리 리소스를 만듭니다. 만든 모든 리소스를 보거나 DevPortal.microsoft.com 직접 이동하여 첫 번째 Dev Box를 만들 수 있습니다.

ARM 템플릿 리소스 정의

imageTemplates 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.VirtualMachineImages/imageTemplates 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.VirtualMachineImages/imageTemplates",
  "apiVersion": "2024-02-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "autoRun": {
      "state": "string"
    },
    "buildTimeoutInMinutes": "int",
    "customize": [
      {
        "name": "string",
        "type": "string"
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ],
    "distribute": [
      {
        "artifactTags": {},
        "runOutputName": "string",
        "type": "string"
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ],
    "errorHandling": {
      "onCustomizerError": "string",
      "onValidationError": "string"
    },
    "managedResourceTags": {},
    "optimize": {
      "vmBoot": {
        "state": "string"
      }
    },
    "source": {
      "type": "string"
      // For remaining properties, see ImageTemplateSource objects
    },
    "stagingResourceGroup": "string",
    "validate": {
      "continueDistributeOnFailure": "bool",
      "inVMValidations": [
        {
          "name": "string",
          "type": "string"
          // For remaining properties, see ImageTemplateInVMValidator objects
        }
      ],
      "sourceValidationOnly": "bool"
    },
    "vmProfile": {
      "osDiskSizeGB": "int",
      "userAssignedIdentities": [ "string" ],
      "vmSize": "string",
      "vnetConfig": {
        "containerInstanceSubnetId": "string",
        "proxyVmSize": "string",
        "subnetId": "string"
      }
    }
  }
}

ImageTemplateCustomizer 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

파일경우 다음을 사용합니다.

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

PowerShell경우 다음을 사용합니다.

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

Shell경우 다음을 사용합니다.

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

windowsRestart경우 다음을 사용합니다.

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

windowsUpdate경우 다음을 사용합니다.

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

ImageTemplateDistributor 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

ManagedImage경우 다음을 사용합니다.

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

sharedImage경우 다음을 사용합니다.

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

VHD경우 다음을 사용합니다.

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

DistributeVersioner 개체

개체의 형식을 지정하려면 체계 속성을 설정합니다.

최신경우 다음을 사용합니다.

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

원본경우 다음을 사용합니다.

  "scheme": "Source"

ImageTemplateSource 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

ManagedImage경우 다음을 사용합니다.

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

PlatformImage경우 다음을 사용합니다.

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

sharedImageVersion경우 다음을 사용합니다.

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

ImageTemplateInVMValidator 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

파일경우 다음을 사용합니다.

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

PowerShell경우 다음을 사용합니다.

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

Shell경우 다음을 사용합니다.

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

속성 값

imageTemplates

이름	묘사	값
형	리소스 종류	'Microsoft.VirtualMachineImages/imageTemplates'
apiVersion	리소스 api 버전	'2024-02-01'
이름	리소스 이름	string(필수)
위치	리소스가 있는 지리적 위치	string(필수)
태그	리소스 태그.	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
신원	구성된 경우 이미지 템플릿의 ID입니다.	imageTemplateIdentity (필수)
속성	이미지 템플릿의 속성	imageTemplateProperties

ImageTemplateIdentity

이름	묘사	값
형	이미지 템플릿에 사용되는 ID의 형식입니다. 'None' 형식은 이미지 템플릿에서 모든 ID를 제거합니다.	'None' 'UserAssigned'
userAssignedIdentities	리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.	UserAssignedIdentities

UserAssignedIdentities

이름	묘사	값
{customized property}		UserAssignedIdentity

UserAssignedIdentity

이 개체에는 배포 중에 설정할 속성이 없습니다. 모든 속성은 ReadOnly입니다.

ImageTemplateProperties

이름	묘사	값
autoRun	템플릿 만들기 또는 업데이트에서 이미지 템플릿 빌드를 자동으로 실행할지 여부를 나타냅니다.	ImageTemplateAutoRun
buildTimeoutInMinutes	이미지 템플릿을 빌드하는 동안 대기할 최대 기간(모든 사용자 지정, 최적화, 유효성 검사 및 배포 포함). 기본값(4시간)을 사용하려면 0을 생략하거나 지정합니다.	int 제약 조건: 최소값 = 0 최대값 = 960
사용자 지정	이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다.	imageTemplateCustomizer[]
배포	이미지 출력을 이동해야 하는 배포 대상입니다.	imageTemplateDistributor[] (필수)
errorHandling	빌드 실패 시 오류 처리 옵션	imageTemplatePropertiesErrorHandling
managedResourceTags	서비스에서 만든 리소스 그룹 및/또는 리소스에 적용할 태그입니다.	객체
최적화	이미지에서 수행할 최적화를 지정합니다.	imageTemplatePropertiesOptimize
근원	원본 이미지를 설명하는 데 사용되는 속성을 지정합니다.	imageTemplateSource (필수)
stagingResourceGroup	이미지를 빌드하는 데 사용할 이미지 템플릿과 동일한 구독의 준비 리소스 그룹 ID입니다. 이 필드가 비어 있으면 임의 이름을 가진 리소스 그룹이 만들어집니다. 이 필드에 지정된 리소스 그룹이 없으면 동일한 이름으로 생성됩니다. 지정된 리소스 그룹이 있는 경우 비어 있어야 하며 이미지 템플릿과 동일한 지역에 있어야 합니다. 이 필드가 비어 있거나 지정된 리소스 그룹이 없는 경우 템플릿 삭제 중에 만든 리소스 그룹이 삭제되지만 지정된 리소스 그룹이 있는 경우 템플릿을 삭제하는 동안 리소스 그룹에서 만든 리소스가 삭제되고 리소스 그룹 자체는 유지됩니다.	문자열
확인	결과 이미지에서 수행할 구성 옵션 및 유효성 검사 목록입니다.	imageTemplatePropertiesValidate
vmProfile	가상 머신을 설정하여 이미지를 빌드하는 방법을 설명합니다.	ImageTemplateVmProfile

ImageTemplateAutoRun

이름	묘사	값
상태	이 필드를 사용하도록 설정하면 이미지 템플릿 만들기 또는 업데이트에 대한 자동 빌드가 트리거됩니다.	'사용 안 함' 'Enabled'

ImageTemplateCustomizer

이름	묘사	값
이름	이 사용자 지정 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름	문자열
형	개체 유형 설정	파일 PowerShell 셸 windowsRestart windowsUpdate (필수)

ImageTemplateFileCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	'File'(필수)
목적지	sourceUri에서 파일을 VM에 업로드할 파일의 절대 경로(이미 만들어진 중첩된 디렉터리 구조 포함)	문자열
sha256Checksum	위의 sourceUri 필드에 제공된 파일의 SHA256 체크섬	문자열
sourceUri	VM을 사용자 지정하기 위해 업로드할 파일의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.	문자열

ImageTemplatePowerShellCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	'PowerShell'(필수)
인라인	실행할 PowerShell 명령 배열	string[]
runAsSystem	지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다.	bool
runElevated	지정된 경우 PowerShell 스크립트는 상승된 권한으로 실행됩니다.	bool
scriptUri	사용자 지정을 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.	문자열
sha256Checksum	위의 scriptUri 필드에 제공된 Power Shell 스크립트의 SHA256 체크섬	문자열
validExitCodes	PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0]	int[]

ImageTemplateShellCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	'Shell'(필수)
인라인	실행할 셸 명령 배열	string[]
scriptUri	사용자 지정을 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.	문자열
sha256Checksum	scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬	문자열

ImageTemplateRestartCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	'WindowsRestart'(필수)
restartCheckCommand	다시 시작이 성공했는지 확인하는 명령 [기본값: '']	문자열
restartCommand	다시 시작을 실행하는 명령 [기본값: 'shutdown /r /f /t 0 /c "packer restart"']	문자열
restartTimeout	크기 및 단위의 문자열로 지정된 다시 시작 시간 제한(예: '5m'(5분) 또는 '2h'(2시간) [기본값: '5m']	문자열

ImageTemplateWindowsUpdateCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	'WindowsUpdate'(필수)
필터	적용할 업데이트를 선택할 필터 배열입니다. 기본값을 사용하도록 빈 배열을 생략하거나 지정합니다(필터 없음). 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요.	string[]
searchCriteria	업데이트를 검색할 조건입니다. 기본값을 사용하도록 빈 문자열을 생략하거나 지정합니다(모두 검색). 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요.	문자열
updateLimit	한 번에 적용할 최대 업데이트 수입니다. 기본값을 사용하려면 0을 생략하거나 지정합니다(1000).	int 제약 조건: 최소값 = 0

ImageTemplateDistributor

이름	묘사	값
artifactTags	배포자에 의해 아티팩트가 생성/업데이트되면 아티팩트에 적용될 태그입니다.	객체
runOutputName	연결된 RunOutput에 사용할 이름입니다.	string(필수) 제약 조건: 패턴 = `^[A-Za-z0-9-_.]{1,64}$`
형	개체 유형 설정	ManagedImage sharedImage VHD (필수)

ImageTemplateManagedImageDistributor

이름	묘사	값
형	배포 유형입니다.	'ManagedImage'(필수)
imageId	Managed Disk 이미지의 리소스 ID	string(필수)
위치	이미지의 Azure 위치는 이미지가 이미 있는 경우 일치해야 합니다.	string(필수)

ImageTemplateSharedImageDistributor

이름	묘사	값
형	배포 유형입니다.	'SharedImage'(필수)
excludeFromLatest	만든 이미지 버전을 최신 버전에서 제외해야 하는지 여부를 나타내는 플래그입니다. 기본값(false)을 사용하지 않습니다.	bool
galleryImageId	Azure Compute 갤러리 이미지의 리소스 ID	string(필수)
replicationRegions	[사용되지 않음] 이미지가 복제될 지역 목록입니다. targetRegions를 지정하지 않은 경우에만 이 목록을 지정할 수 있습니다. 이 필드는 더 이상 사용되지 않습니다. 대신 targetRegions를 사용합니다.	string[]
storageAccountType	[사용되지 않음] 공유 이미지를 저장하는 데 사용할 스토리지 계정 유형입니다. 기본값(Standard_LRS)을 사용하지 않습니다. 이 필드는 replicationRegions가 지정된 경우에만 지정할 수 있습니다. 이 필드는 더 이상 사용되지 않습니다. 대신 targetRegions를 사용합니다.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'
targetRegions	분산 이미지 버전이 복제될 대상 지역입니다. 이 개체는 replicationRegions를 대체하며 replicationRegions를 지정하지 않은 경우에만 지정할 수 있습니다.	TargetRegion[]
버전 관리	배포를 위해 새 x.y.z 버전 번호를 생성하는 방법을 설명합니다.	DistributeVersioner

TargetRegion

이름	묘사	값
이름	지역 이름입니다.	string(필수)
replicaCount	이 지역에서 만들 이미지 버전의 복제본 수입니다. 기본값(1)을 사용하지 않습니다.	int 제약 조건: 최소값 = 1
storageAccountType	이 지역에 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 기본값(Standard_LRS)을 사용하지 않습니다.	'Premium_LRS' 'Standard_LRS' 'Standard_ZRS'

DistributeVersioner

이름	묘사	값
음모	개체 유형 설정	최신 원본(필수)

DistributeVersionerLatest

이름	묘사	값
음모	사용할 버전 번호 매기기 체계입니다.	'Latest'(필수)
전공	생성된 버전 번호의 주 버전입니다. 이 값을 주 버전으로 사용하는 버전에 따라 "최신"이 무엇인지 확인합니다. -1은 설정되지 않은 상태로 두는 것과 같습니다.	int

DistributeVersionerSource

이름	묘사	값
음모	사용할 버전 번호 매기기 체계입니다.	'Source'(필수)

ImageTemplateVhdDistributor

이름	묘사	값
형	배포 유형입니다.	'VHD'(필수)
uri	분산 VHD Blob에 대한 선택적 Azure Storage URI입니다. 기본값(빈 문자열)을 사용하지 않습니다. 이 경우 VHD는 준비 리소스 그룹의 스토리지 계정에 게시됩니다.	문자열

ImageTemplatePropertiesErrorHandling

이름	묘사	값
onCustomizerError	사용자 지정자 오류가 있고 이 필드가 '정리'로 설정된 경우 빌드 VM 및 연결된 네트워크 리소스가 정리됩니다. 이것이 기본 동작입니다. 사용자 지정자 오류가 있고 이 필드가 '중단'으로 설정된 경우 빌드 VM이 유지됩니다.	'abort' 'cleanup'
onValidationError	유효성 검사 오류가 있고 이 필드가 '정리'로 설정된 경우 빌드 VM 및 연결된 네트워크 리소스가 정리됩니다. 이것이 기본 동작입니다. 유효성 검사 오류가 있고 이 필드가 '중단'으로 설정된 경우 빌드 VM이 유지됩니다.	'abort' 'cleanup'

ImageTemplatePropertiesOptimize

이름	묘사	값
vmBoot	더 빠른 VM 부팅을 위해 이미지에 최적화가 적용됩니다.	imageTemplatePropertiesOptimizeVmBoot

ImageTemplatePropertiesOptimizeVmBoot

이름	묘사	값
상태	이 필드를 사용하도록 설정하면 최종 사용자 지정된 이미지 출력을 최적화하여 VM 부팅 시간이 향상됩니다.	'사용 안 함' 'Enabled'

ImageTemplateSource

이름	묘사	값
형	개체 유형 설정	ManagedImage platformImage sharedImageVersion (필수)

ImageTemplateManagedImageSource

이름	묘사	값
형	시작하려는 원본 이미지의 형식을 지정합니다.	'ManagedImage'(필수)
imageId	고객 구독에서 관리되는 이미지의 ARM 리소스 ID	string(필수)

ImageTemplatePlatformImageSource

이름	묘사	값
형	시작하려는 원본 이미지의 형식을 지정합니다.	'PlatformImage'(필수)
제공	Azure Gallery 이미지이미지 제품.	문자열
planInfo	플랫폼 이미지에 대한 구매 계획의 선택적 구성입니다.	platformImagePurchasePlan
게시자	Azure Gallery 이미지이미지 게시자.	문자열
sku	Azure Gallery 이미지이미지 sku.	문자열
버전	Azure Gallery 이미지이미지 버전입니다. 여기서 'latest'를 지정하면 템플릿을 제출할 때가 아니라 이미지 빌드가 발생할 때 버전이 평가됩니다.	문자열

PlatformImagePurchasePlan

이름	묘사	값
planName	구매 플랜의 이름입니다.	string(필수)
planProduct	구매 플랜의 제품입니다.	string(필수)
planPublisher	구매 플랜의 게시자입니다.	string(필수)

ImageTemplateSharedImageVersionSource

이름	묘사	값
형	시작하려는 원본 이미지의 형식을 지정합니다.	'SharedImageVersion'(필수)
imageVersionId	이미지 버전의 ARM 리소스 ID입니다. 이미지 버전 이름이 '최신'인 경우 이미지 빌드가 발생할 때 버전이 평가됩니다.	string(필수)

ImageTemplatePropertiesValidate

이름	묘사	값
continueDistributeOnFailure	유효성 검사가 실패하고 이 필드가 false로 설정되면 출력 이미지가 배포되지 않습니다. 이것이 기본 동작입니다. 유효성 검사가 실패하고 이 필드가 true로 설정된 경우 출력 이미지는 계속 배포됩니다. 잘못된 이미지가 배포될 수 있으므로 이 옵션을 주의해서 사용하세요. 두 경우 모두(true 또는 false) 엔드 투 엔드 이미지 실행은 유효성 검사 실패 시 실패한 것으로 보고됩니다. [참고: 유효성 검사에 성공하면 이 필드는 효과가 없습니다.]	bool
inVMValidations	수행할 유효성 검사 목록입니다.	imageTemplateInVMValidator[]
sourceValidationOnly	이 필드를 true로 설정하면 'source' 섹션에 지정된 이미지의 유효성이 직접 검사됩니다. 사용자 지정된 이미지를 생성하고 유효성을 검사하기 위해 별도의 빌드가 실행되지 않습니다.	bool

ImageTemplateInVMValidator

이름	묘사	값
이름	이 유효성 검사 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름	문자열
형	개체 유형 설정	파일 PowerShell Shell(필수)

ImageTemplateFileValidator

이름	묘사	값
형	이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.	'File'(필수)
목적지	sourceUri에서 파일을 VM에 업로드할 파일의 절대 경로(이미 만들어진 중첩된 디렉터리 구조 포함)	문자열
sha256Checksum	위의 sourceUri 필드에 제공된 파일의 SHA256 체크섬	문자열
sourceUri	유효성 검사를 위해 VM에 업로드할 파일의 URI입니다. Github 링크, Azure Storage URI(권한 있는 또는 SAS) 등일 수 있습니다.	문자열

ImageTemplatePowerShellValidator

이름	묘사	값
형	이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.	'PowerShell'(필수)
인라인	실행할 PowerShell 명령 배열	string[]
runAsSystem	지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다.	bool
runElevated	지정된 경우 PowerShell 스크립트는 상승된 권한으로 실행됩니다.	bool
scriptUri	유효성 검사를 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage URI 등일 수 있습니다.	문자열
sha256Checksum	위의 scriptUri 필드에 제공된 Power Shell 스크립트의 SHA256 체크섬	문자열
validExitCodes	PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0]	int[]

ImageTemplateShellValidator

이름	묘사	값
형	이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.	'Shell'(필수)
인라인	실행할 셸 명령 배열	string[]
scriptUri	유효성 검사를 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage URI 등일 수 있습니다.	문자열
sha256Checksum	scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬	문자열

ImageTemplateVmProfile

이름	묘사	값
osDiskSizeGB	OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다.	int 제약 조건: 최소값 = 0
userAssignedIdentities	빌드 VM 및 유효성 검사 VM에서 구성할 사용자 할당 관리 ID의 리소스 ID의 선택적 배열입니다. 여기에는 이미지 템플릿의 ID가 포함될 수 있습니다.	string[]
vmSize	이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4).	문자열
vnetConfig	빌드 VM 및 유효성 검사 VM을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다.	VirtualNetworkConfig

VirtualNetworkConfig

이름	묘사	값
containerInstanceSubnetId	격리된 빌드에 대해 Azure Container Instance를 배포할 기존 서브넷의 리소스 ID입니다. 이 필드는 `subnetId` 지정되고 `subnetId`지정된 서브넷과 동일한 Virtual Network에 있어야 하는 경우에만 지정할 수 있습니다.	문자열
proxyVmSize	빌드 VM 및 유효성 검사 VM에 트래픽을 전달하는 데 사용되는 프록시 가상 머신의 크기입니다. 이 경우 프록시 가상 머신이 배포되지 않으므로 `containerInstanceSubnetId` 지정한 경우에는 지정해서는 안 됩니다. 기본값(Standard_A1_v2)을 사용하도록 빈 문자열을 생략하거나 지정합니다.	문자열
subnetId	빌드 VM 및 유효성 검사 VM이 배포될 기존 서브넷의 리소스 ID	문자열

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플렛	묘사
Azure Windows 기준 사용하여 Azure Image Builder Azure 배포	Azure Image Builder 환경을 만들고 최신 Windows 업데이트 및 Azure Windows 기준이 적용된 Windows Server 이미지를 빌드합니다.
Dev Box 서비스 구성 Azure 배포	이 템플릿은 Dev Box 빠른 시작 가이드(https://learn.microsoft.com/azure/dev-box/quickstart-create-dev-box)에 따라 모든 Dev Box 관리 리소스를 만듭니다. 만든 모든 리소스를 보거나 DevPortal.microsoft.com 직접 이동하여 첫 번째 Dev Box를 만들 수 있습니다.

Terraform(AzAPI 공급자) 리소스 정의

imageTemplates 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.VirtualMachineImages/imageTemplates 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.VirtualMachineImages/imageTemplates@2024-02-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "UserAssigned"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      autoRun = {
        state = "string"
      }
      buildTimeoutInMinutes = int
      customize = [
        {
          name = "string"
          type = "string"
          // For remaining properties, see ImageTemplateCustomizer objects
        }
      ]
      distribute = [
        {
          artifactTags = {}
          runOutputName = "string"
          type = "string"
          // For remaining properties, see ImageTemplateDistributor objects
        }
      ]
      errorHandling = {
        onCustomizerError = "string"
        onValidationError = "string"
      }
      managedResourceTags = {}
      optimize = {
        vmBoot = {
          state = "string"
        }
      }
      source = {
        type = "string"
        // For remaining properties, see ImageTemplateSource objects
      }
      stagingResourceGroup = "string"
      validate = {
        continueDistributeOnFailure = bool
        inVMValidations = [
          {
            name = "string"
            type = "string"
            // For remaining properties, see ImageTemplateInVMValidator objects
          }
        ]
        sourceValidationOnly = bool
      }
      vmProfile = {
        osDiskSizeGB = int
        userAssignedIdentities = [
          "string"
        ]
        vmSize = "string"
        vnetConfig = {
          containerInstanceSubnetId = "string"
          proxyVmSize = "string"
          subnetId = "string"
        }
      }
    }
  })
}

ImageTemplateCustomizer 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

파일경우 다음을 사용합니다.

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

PowerShell경우 다음을 사용합니다.

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

Shell경우 다음을 사용합니다.

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

windowsRestart경우 다음을 사용합니다.

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

windowsUpdate경우 다음을 사용합니다.

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

ImageTemplateDistributor 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

ManagedImage경우 다음을 사용합니다.

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

sharedImage경우 다음을 사용합니다.

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

VHD경우 다음을 사용합니다.

  type = "VHD"
  uri = "string"

DistributeVersioner 개체

개체의 형식을 지정하려면 체계 속성을 설정합니다.

최신경우 다음을 사용합니다.

  scheme = "Latest"
  major = int

원본경우 다음을 사용합니다.

  scheme = "Source"

ImageTemplateSource 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

ManagedImage경우 다음을 사용합니다.

  type = "ManagedImage"
  imageId = "string"

PlatformImage경우 다음을 사용합니다.

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

sharedImageVersion경우 다음을 사용합니다.

  type = "SharedImageVersion"
  imageVersionId = "string"

ImageTemplateInVMValidator 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

파일경우 다음을 사용합니다.

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

PowerShell경우 다음을 사용합니다.

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

Shell경우 다음을 사용합니다.

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

속성 값

imageTemplates

이름	묘사	값
형	리소스 종류	"Microsoft.VirtualMachineImages/imageTemplates@2024-02-01"
이름	리소스 이름	string(필수)
위치	리소스가 있는 지리적 위치	string(필수)
parent_id	리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다.	string(필수)
태그	리소스 태그.	태그 이름 및 값의 사전입니다.
신원	구성된 경우 이미지 템플릿의 ID입니다.	imageTemplateIdentity (필수)
속성	이미지 템플릿의 속성	imageTemplateProperties

ImageTemplateIdentity

이름	묘사	값
형	이미지 템플릿에 사용되는 ID의 형식입니다. 'None' 형식은 이미지 템플릿에서 모든 ID를 제거합니다.	"UserAssigned"
identity_ids	리소스와 연결된 사용자 할당 ID 집합입니다. userAssignedIdentities 사전 키는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. 사전 값은 요청에서 빈 개체({})일 수 있습니다.	사용자 ID ID의 배열입니다.

UserAssignedIdentities

이름	묘사	값
{customized property}		UserAssignedIdentity

UserAssignedIdentity

이 개체에는 배포 중에 설정할 속성이 없습니다. 모든 속성은 ReadOnly입니다.

ImageTemplateProperties

이름	묘사	값
autoRun	템플릿 만들기 또는 업데이트에서 이미지 템플릿 빌드를 자동으로 실행할지 여부를 나타냅니다.	ImageTemplateAutoRun
buildTimeoutInMinutes	이미지 템플릿을 빌드하는 동안 대기할 최대 기간(모든 사용자 지정, 최적화, 유효성 검사 및 배포 포함). 기본값(4시간)을 사용하려면 0을 생략하거나 지정합니다.	int 제약 조건: 최소값 = 0 최대값 = 960
사용자 지정	이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다.	imageTemplateCustomizer[]
배포	이미지 출력을 이동해야 하는 배포 대상입니다.	imageTemplateDistributor[] (필수)
errorHandling	빌드 실패 시 오류 처리 옵션	imageTemplatePropertiesErrorHandling
managedResourceTags	서비스에서 만든 리소스 그룹 및/또는 리소스에 적용할 태그입니다.	객체
최적화	이미지에서 수행할 최적화를 지정합니다.	imageTemplatePropertiesOptimize
근원	원본 이미지를 설명하는 데 사용되는 속성을 지정합니다.	imageTemplateSource (필수)
stagingResourceGroup	이미지를 빌드하는 데 사용할 이미지 템플릿과 동일한 구독의 준비 리소스 그룹 ID입니다. 이 필드가 비어 있으면 임의 이름을 가진 리소스 그룹이 만들어집니다. 이 필드에 지정된 리소스 그룹이 없으면 동일한 이름으로 생성됩니다. 지정된 리소스 그룹이 있는 경우 비어 있어야 하며 이미지 템플릿과 동일한 지역에 있어야 합니다. 이 필드가 비어 있거나 지정된 리소스 그룹이 없는 경우 템플릿 삭제 중에 만든 리소스 그룹이 삭제되지만 지정된 리소스 그룹이 있는 경우 템플릿을 삭제하는 동안 리소스 그룹에서 만든 리소스가 삭제되고 리소스 그룹 자체는 유지됩니다.	문자열
확인	결과 이미지에서 수행할 구성 옵션 및 유효성 검사 목록입니다.	imageTemplatePropertiesValidate
vmProfile	가상 머신을 설정하여 이미지를 빌드하는 방법을 설명합니다.	ImageTemplateVmProfile

ImageTemplateAutoRun

이름	묘사	값
상태	이 필드를 사용하도록 설정하면 이미지 템플릿 만들기 또는 업데이트에 대한 자동 빌드가 트리거됩니다.	"사용 안 함" "사용"

ImageTemplateCustomizer

이름	묘사	값
이름	이 사용자 지정 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름	문자열
형	개체 유형 설정	파일 PowerShell 셸 windowsRestart windowsUpdate (필수)

ImageTemplateFileCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	"파일"(필수)
목적지	sourceUri에서 파일을 VM에 업로드할 파일의 절대 경로(이미 만들어진 중첩된 디렉터리 구조 포함)	문자열
sha256Checksum	위의 sourceUri 필드에 제공된 파일의 SHA256 체크섬	문자열
sourceUri	VM을 사용자 지정하기 위해 업로드할 파일의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.	문자열

ImageTemplatePowerShellCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	"PowerShell"(필수)
인라인	실행할 PowerShell 명령 배열	string[]
runAsSystem	지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다.	bool
runElevated	지정된 경우 PowerShell 스크립트는 상승된 권한으로 실행됩니다.	bool
scriptUri	사용자 지정을 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.	문자열
sha256Checksum	위의 scriptUri 필드에 제공된 Power Shell 스크립트의 SHA256 체크섬	문자열
validExitCodes	PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0]	int[]

ImageTemplateShellCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	"Shell"(필수)
인라인	실행할 셸 명령 배열	string[]
scriptUri	사용자 지정을 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다.	문자열
sha256Checksum	scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬	문자열

ImageTemplateRestartCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	"WindowsRestart"(필수)
restartCheckCommand	다시 시작이 성공했는지 확인하는 명령 [기본값: '']	문자열
restartCommand	다시 시작을 실행하는 명령 [기본값: 'shutdown /r /f /t 0 /c "packer restart"']	문자열
restartTimeout	크기 및 단위의 문자열로 지정된 다시 시작 시간 제한(예: '5m'(5분) 또는 '2h'(2시간) [기본값: '5m']	문자열

ImageTemplateWindowsUpdateCustomizer

이름	묘사	값
형	이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다.	"WindowsUpdate"(필수)
필터	적용할 업데이트를 선택할 필터 배열입니다. 기본값을 사용하도록 빈 배열을 생략하거나 지정합니다(필터 없음). 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요.	string[]
searchCriteria	업데이트를 검색할 조건입니다. 기본값을 사용하도록 빈 문자열을 생략하거나 지정합니다(모두 검색). 이 필드에 대한 예제 및 자세한 설명은 위의 링크를 참조하세요.	문자열
updateLimit	한 번에 적용할 최대 업데이트 수입니다. 기본값을 사용하려면 0을 생략하거나 지정합니다(1000).	int 제약 조건: 최소값 = 0

ImageTemplateDistributor

이름	묘사	값
artifactTags	배포자에 의해 아티팩트가 생성/업데이트되면 아티팩트에 적용될 태그입니다.	객체
runOutputName	연결된 RunOutput에 사용할 이름입니다.	string(필수) 제약 조건: 패턴 = `^[A-Za-z0-9-_.]{1,64}$`
형	개체 유형 설정	ManagedImage sharedImage VHD (필수)

ImageTemplateManagedImageDistributor

이름	묘사	값
형	배포 유형입니다.	"ManagedImage"(필수)
imageId	Managed Disk 이미지의 리소스 ID	string(필수)
위치	이미지의 Azure 위치는 이미지가 이미 있는 경우 일치해야 합니다.	string(필수)

ImageTemplateSharedImageDistributor

이름	묘사	값
형	배포 유형입니다.	"SharedImage"(필수)
excludeFromLatest	만든 이미지 버전을 최신 버전에서 제외해야 하는지 여부를 나타내는 플래그입니다. 기본값(false)을 사용하지 않습니다.	bool
galleryImageId	Azure Compute 갤러리 이미지의 리소스 ID	string(필수)
replicationRegions	[사용되지 않음] 이미지가 복제될 지역 목록입니다. targetRegions를 지정하지 않은 경우에만 이 목록을 지정할 수 있습니다. 이 필드는 더 이상 사용되지 않습니다. 대신 targetRegions를 사용합니다.	string[]
storageAccountType	[사용되지 않음] 공유 이미지를 저장하는 데 사용할 스토리지 계정 유형입니다. 기본값(Standard_LRS)을 사용하지 않습니다. 이 필드는 replicationRegions가 지정된 경우에만 지정할 수 있습니다. 이 필드는 더 이상 사용되지 않습니다. 대신 targetRegions를 사용합니다.	"Premium_LRS" "Standard_LRS" "Standard_ZRS"
targetRegions	분산 이미지 버전이 복제될 대상 지역입니다. 이 개체는 replicationRegions를 대체하며 replicationRegions를 지정하지 않은 경우에만 지정할 수 있습니다.	TargetRegion[]
버전 관리	배포를 위해 새 x.y.z 버전 번호를 생성하는 방법을 설명합니다.	DistributeVersioner

TargetRegion

이름	묘사	값
이름	지역 이름입니다.	string(필수)
replicaCount	이 지역에서 만들 이미지 버전의 복제본 수입니다. 기본값(1)을 사용하지 않습니다.	int 제약 조건: 최소값 = 1
storageAccountType	이 지역에 이미지를 저장하는 데 사용할 스토리지 계정 유형을 지정합니다. 기본값(Standard_LRS)을 사용하지 않습니다.	"Premium_LRS" "Standard_LRS" "Standard_ZRS"

DistributeVersioner

이름	묘사	값
음모	개체 유형 설정	최신 원본(필수)

DistributeVersionerLatest

이름	묘사	값
음모	사용할 버전 번호 매기기 체계입니다.	"Latest"(필수)
전공	생성된 버전 번호의 주 버전입니다. 이 값을 주 버전으로 사용하는 버전에 따라 "최신"이 무엇인지 확인합니다. -1은 설정되지 않은 상태로 두는 것과 같습니다.	int

DistributeVersionerSource

이름	묘사	값
음모	사용할 버전 번호 매기기 체계입니다.	"원본"(필수)

ImageTemplateVhdDistributor

이름	묘사	값
형	배포 유형입니다.	"VHD"(필수)
uri	분산 VHD Blob에 대한 선택적 Azure Storage URI입니다. 기본값(빈 문자열)을 사용하지 않습니다. 이 경우 VHD는 준비 리소스 그룹의 스토리지 계정에 게시됩니다.	문자열

ImageTemplatePropertiesErrorHandling

이름	묘사	값
onCustomizerError	사용자 지정자 오류가 있고 이 필드가 '정리'로 설정된 경우 빌드 VM 및 연결된 네트워크 리소스가 정리됩니다. 이것이 기본 동작입니다. 사용자 지정자 오류가 있고 이 필드가 '중단'으로 설정된 경우 빌드 VM이 유지됩니다.	"abort" "cleanup"
onValidationError	유효성 검사 오류가 있고 이 필드가 '정리'로 설정된 경우 빌드 VM 및 연결된 네트워크 리소스가 정리됩니다. 이것이 기본 동작입니다. 유효성 검사 오류가 있고 이 필드가 '중단'으로 설정된 경우 빌드 VM이 유지됩니다.	"abort" "cleanup"

ImageTemplatePropertiesOptimize

이름	묘사	값
vmBoot	더 빠른 VM 부팅을 위해 이미지에 최적화가 적용됩니다.	imageTemplatePropertiesOptimizeVmBoot

ImageTemplatePropertiesOptimizeVmBoot

이름	묘사	값
상태	이 필드를 사용하도록 설정하면 최종 사용자 지정된 이미지 출력을 최적화하여 VM 부팅 시간이 향상됩니다.	"사용 안 함" "사용"

ImageTemplateSource

이름	묘사	값
형	개체 유형 설정	ManagedImage platformImage sharedImageVersion (필수)

ImageTemplateManagedImageSource

이름	묘사	값
형	시작하려는 원본 이미지의 형식을 지정합니다.	"ManagedImage"(필수)
imageId	고객 구독에서 관리되는 이미지의 ARM 리소스 ID	string(필수)

ImageTemplatePlatformImageSource

이름	묘사	값
형	시작하려는 원본 이미지의 형식을 지정합니다.	"PlatformImage"(필수)
제공	Azure Gallery 이미지이미지 제품.	문자열
planInfo	플랫폼 이미지에 대한 구매 계획의 선택적 구성입니다.	platformImagePurchasePlan
게시자	Azure Gallery 이미지이미지 게시자.	문자열
sku	Azure Gallery 이미지이미지 sku.	문자열
버전	Azure Gallery 이미지이미지 버전입니다. 여기서 'latest'를 지정하면 템플릿을 제출할 때가 아니라 이미지 빌드가 발생할 때 버전이 평가됩니다.	문자열

PlatformImagePurchasePlan

이름	묘사	값
planName	구매 플랜의 이름입니다.	string(필수)
planProduct	구매 플랜의 제품입니다.	string(필수)
planPublisher	구매 플랜의 게시자입니다.	string(필수)

ImageTemplateSharedImageVersionSource

이름	묘사	값
형	시작하려는 원본 이미지의 형식을 지정합니다.	"SharedImageVersion"(필수)
imageVersionId	이미지 버전의 ARM 리소스 ID입니다. 이미지 버전 이름이 '최신'인 경우 이미지 빌드가 발생할 때 버전이 평가됩니다.	string(필수)

ImageTemplatePropertiesValidate

이름	묘사	값
continueDistributeOnFailure	유효성 검사가 실패하고 이 필드가 false로 설정되면 출력 이미지가 배포되지 않습니다. 이것이 기본 동작입니다. 유효성 검사가 실패하고 이 필드가 true로 설정된 경우 출력 이미지는 계속 배포됩니다. 잘못된 이미지가 배포될 수 있으므로 이 옵션을 주의해서 사용하세요. 두 경우 모두(true 또는 false) 엔드 투 엔드 이미지 실행은 유효성 검사 실패 시 실패한 것으로 보고됩니다. [참고: 유효성 검사에 성공하면 이 필드는 효과가 없습니다.]	bool
inVMValidations	수행할 유효성 검사 목록입니다.	imageTemplateInVMValidator[]
sourceValidationOnly	이 필드를 true로 설정하면 'source' 섹션에 지정된 이미지의 유효성이 직접 검사됩니다. 사용자 지정된 이미지를 생성하고 유효성을 검사하기 위해 별도의 빌드가 실행되지 않습니다.	bool

ImageTemplateInVMValidator

이름	묘사	값
이름	이 유효성 검사 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름	문자열
형	개체 유형 설정	파일 PowerShell Shell(필수)

ImageTemplateFileValidator

이름	묘사	값
형	이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.	"파일"(필수)
목적지	sourceUri에서 파일을 VM에 업로드할 파일의 절대 경로(이미 만들어진 중첩된 디렉터리 구조 포함)	문자열
sha256Checksum	위의 sourceUri 필드에 제공된 파일의 SHA256 체크섬	문자열
sourceUri	유효성 검사를 위해 VM에 업로드할 파일의 URI입니다. Github 링크, Azure Storage URI(권한 있는 또는 SAS) 등일 수 있습니다.	문자열

ImageTemplatePowerShellValidator

이름	묘사	값
형	이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.	"PowerShell"(필수)
인라인	실행할 PowerShell 명령 배열	string[]
runAsSystem	지정된 경우 PowerShell 스크립트는 로컬 시스템 사용자를 사용하여 상승된 권한으로 실행됩니다. 위의 runElevated 필드가 true로 설정된 경우에만 true일 수 있습니다.	bool
runElevated	지정된 경우 PowerShell 스크립트는 상승된 권한으로 실행됩니다.	bool
scriptUri	유효성 검사를 위해 실행할 PowerShell 스크립트의 URI입니다. Github 링크, Azure Storage URI 등일 수 있습니다.	문자열
sha256Checksum	위의 scriptUri 필드에 제공된 Power Shell 스크립트의 SHA256 체크섬	문자열
validExitCodes	PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0]	int[]

ImageTemplateShellValidator

이름	묘사	값
형	이미지에서 사용할 유효성 검사 유형입니다. 예를 들어 "Shell"은 셸 유효성 검사일 수 있습니다.	"Shell"(필수)
인라인	실행할 셸 명령 배열	string[]
scriptUri	유효성 검사를 위해 실행할 셸 스크립트의 URI입니다. Github 링크, Azure Storage URI 등일 수 있습니다.	문자열
sha256Checksum	scriptUri 필드에 제공된 셸 스크립트의 SHA256 체크섬	문자열

ImageTemplateVmProfile

이름	묘사	값
osDiskSizeGB	OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다.	int 제약 조건: 최소값 = 0
userAssignedIdentities	빌드 VM 및 유효성 검사 VM에서 구성할 사용자 할당 관리 ID의 리소스 ID의 선택적 배열입니다. 여기에는 이미지 템플릿의 ID가 포함될 수 있습니다.	string[]
vmSize	이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4).	문자열
vnetConfig	빌드 VM 및 유효성 검사 VM을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다.	VirtualNetworkConfig

VirtualNetworkConfig

이름	묘사	값
containerInstanceSubnetId	격리된 빌드에 대해 Azure Container Instance를 배포할 기존 서브넷의 리소스 ID입니다. 이 필드는 `subnetId` 지정되고 `subnetId`지정된 서브넷과 동일한 Virtual Network에 있어야 하는 경우에만 지정할 수 있습니다.	문자열
proxyVmSize	빌드 VM 및 유효성 검사 VM에 트래픽을 전달하는 데 사용되는 프록시 가상 머신의 크기입니다. 이 경우 프록시 가상 머신이 배포되지 않으므로 `containerInstanceSubnetId` 지정한 경우에는 지정해서는 안 됩니다. 기본값(Standard_A1_v2)을 사용하도록 빈 문자열을 생략하거나 지정합니다.	문자열
subnetId	빌드 VM 및 유효성 검사 VM이 배포될 기존 서브넷의 리소스 ID	문자열

다음을 통해 공유

Microsoft.VirtualMachineImages imageTemplates 2024-02-01

Bicep 리소스 정의

리소스 형식

ImageTemplateCustomizer 개체

ImageTemplateDistributor 개체

DistributeVersioner 개체

ImageTemplateSource 개체

ImageTemplateInVMValidator 개체

속성 값

imageTemplates

ImageTemplateIdentity

UserAssignedIdentities

UserAssignedIdentity

ImageTemplateProperties

ImageTemplateAutoRun

ImageTemplateCustomizer

ImageTemplateFileCustomizer

ImageTemplatePowerShellCustomizer

ImageTemplateShellCustomizer

ImageTemplateRestartCustomizer

ImageTemplateWindowsUpdateCustomizer

ImageTemplateDistributor

ImageTemplateManagedImageDistributor

ImageTemplateSharedImageDistributor

TargetRegion

DistributeVersioner

DistributeVersionerLatest

DistributeVersionerSource

ImageTemplateVhdDistributor

ImageTemplatePropertiesErrorHandling

ImageTemplatePropertiesOptimize

ImageTemplatePropertiesOptimizeVmBoot

ImageTemplateSource

ImageTemplateManagedImageSource

ImageTemplatePlatformImageSource

PlatformImagePurchasePlan

ImageTemplateSharedImageVersionSource

ImageTemplatePropertiesValidate

ImageTemplateInVMValidator

ImageTemplateFileValidator

ImageTemplatePowerShellValidator

ImageTemplateShellValidator

ImageTemplateVmProfile

VirtualNetworkConfig

빠른 시작 템플릿

ARM 템플릿 리소스 정의

리소스 형식

ImageTemplateCustomizer 개체

ImageTemplateDistributor 개체

DistributeVersioner 개체

ImageTemplateSource 개체

ImageTemplateInVMValidator 개체

속성 값

imageTemplates

ImageTemplateIdentity

UserAssignedIdentities

UserAssignedIdentity

ImageTemplateProperties

ImageTemplateAutoRun

ImageTemplateCustomizer

ImageTemplateFileCustomizer

ImageTemplatePowerShellCustomizer

ImageTemplateShellCustomizer

ImageTemplateRestartCustomizer

ImageTemplateWindowsUpdateCustomizer

ImageTemplateDistributor

ImageTemplateManagedImageDistributor

ImageTemplateSharedImageDistributor

TargetRegion

DistributeVersioner

DistributeVersionerLatest

DistributeVersionerSource

ImageTemplateVhdDistributor

ImageTemplatePropertiesErrorHandling

ImageTemplatePropertiesOptimize

ImageTemplatePropertiesOptimizeVmBoot

ImageTemplateSource

ImageTemplateManagedImageSource

ImageTemplatePlatformImageSource