다음을 통해 공유

Microsoft.VirtualMachineImages 이미지 템플릿 2020-02-14

Bicep 리소스 정의

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

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

리소스 형식

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

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2020-02-14' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    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
      }
    ]
    source: {
      type: 'string'
      // For remaining properties, see ImageTemplateSource objects
    }
    vmProfile: {
      osDiskSizeGB: int
      vmSize: 'string'
      vnetConfig: {
        subnetId: 'string'
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

ImageTemplateSource 개체

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

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 개체

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

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

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

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

{
  excludeFromLatest: bool
  galleryImageId: 'string'
  replicationRegions: [
    'string'
  ]
  storageAccountType: 'string'
  type: 'SharedImage'
}

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

{
  type: 'VHD'
}

ImageTemplateCustomizer 개체

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

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

{
  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

이름 묘사 값
신원 구성된 경우 이미지 템플릿의 ID입니다. imageTemplateIdentity (필수)
위치 리소스 위치 string(필수)
이름 리소스 이름 문자열

제약 조건:
패턴 = ^[A-Za-z0-9-_.]{1,64}$(필수)
속성 이미지 템플릿의 속성 imageTemplateProperties
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

구성 요소Vrq145스키마이미지 템플릿ID속성사용자 할당 ID추가 속성

이름 묘사 값

이미지템플릿커스터마이저

이름 묘사 값
이름 이 사용자 지정 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름 문자열
형 ImageTemplateFileCustomizer형식에 대해 '파일'로 설정합니다. ImageTemplatePowerShellCustomizer형식에 대해 'PowerShell'로 설정합니다. ImageTemplateShellCustomizer형식에 대해 'Shell'으로 설정합니다. ImageTemplateRestartCustomizer형식에 대해 'WindowsRestart'로 설정합니다. ImageTemplateWindowsUpdateCustomizer형식에 대해 'WindowsUpdate'로 설정합니다. '파일'
'PowerShell'
'껍질'
'Windows다시 시작'
'WindowsUpdate'(필수)

ImageTemplateDistributor

이름 묘사 값
아티팩트태그 배포자에 의해 아티팩트가 생성/업데이트되면 아티팩트에 적용될 태그입니다. imageTemplateDistributorArtifactTags
runOutputName 연결된 RunOutput에 사용할 이름입니다. 문자열

제약 조건:
패턴 = ^[A-Za-z0-9-_.]{1,64}$(필수)
형 ImageTemplateManagedImageDistributor형식에 대해 'ManagedImage'로 설정합니다. ImageTemplateSharedImageDistributor형식에 대해 'SharedImage'로 설정합니다. ImageTemplateVhdDistributor형식에 대해 'VHD'로 설정합니다. '관리 이미지'
'공유 이미지'
'VHD'(필수)

ImageTemplateDistributorArtifact태그

이름 묘사 값

이미지템플릿파일커스터마이저

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

ImageTemplateIdentity (이미지템플릿아이덴티티)

이름 묘사 값
형 이미지 템플릿에 사용되는 ID의 형식입니다. 'None' 형식은 이미지 템플릿에서 모든 ID를 제거합니다. '없음'
'사용자 할당됨'
userAssignedIdentities 이미지 템플릿과 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다. imageTemplateIdentityUserAssignedIdentities

ImageTemplateIdentityUserAssignedIdentities

이름 묘사 값

ImageTemplateManagedImageDistributor

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

ImageTemplateManagedImageSource

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

ImageTemplatePlatformImageSource

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

ImageTemplatePowerShellCustomizer

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

ImageTemplate속성

이름 묘사 값
buildTimeoutInMinutes 이미지 템플릿을 빌드하는 동안 대기할 최대 기간입니다. 기본값(4시간)을 사용하려면 0을 생략하거나 지정합니다. 정수

제약 조건:
최소값 = 0
최대값 = 960
사용자 지정 이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다. imageTemplateCustomizer[]
배포 이미지 출력을 이동해야 하는 배포 대상입니다. imageTemplateDistributor[] (필수)
근원 원본 이미지를 설명하는 데 사용되는 속성을 지정합니다. imageTemplateSource (필수)
vm프로필 가상 머신을 설정하여 이미지를 빌드하는 방법을 설명합니다. ImageTemplateVmProfile

ImageTemplateRestartCustomizer

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

ImageTemplateSharedImageDistributor

이름 묘사 값
최신 항목에서 제외 만든 이미지 버전을 최신 버전에서 제외해야 하는지 여부를 나타내는 플래그입니다. 기본값(false)을 사용하지 않습니다. 부울
갤러리 이미지 ID 공유 이미지 갤러리 이미지의 리소스 ID string(필수)
replicationRegions 이미지가 복제될 지역 목록 string[] (필수)
storageAccountType을 입력합니다 공유 이미지를 저장하는 데 사용할 스토리지 계정 유형입니다. 기본값(Standard_LRS)을 사용하지 않습니다. 'Standard_LRS'
'Standard_ZRS'
형 배포 유형입니다. 'SharedImage'(필수)

ImageTemplateSharedImageVersionSource

이름 묘사 값
이미지 버전 ID 공유 이미지 갤러리에 있는 이미지 버전의 ARM 리소스 ID string(필수)
형 시작하려는 원본 이미지의 형식을 지정합니다. 'SharedImageVersion'(필수)

ImageTemplateShellCustomizer

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

ImageTemplateSource 이미지 템플릿 소스

이름 묘사 값
형 ImageTemplateManagedImageSource형식에 대해 'ManagedImage'로 설정합니다. ImageTemplatePlatformImageSource형식에 대해 'PlatformImage'로 설정합니다. ImageTemplateSharedImageVersionSource형식에 대해 'SharedImageVersion'으로 설정합니다. '관리 이미지'
'플랫폼 이미지'
'SharedImageVersion'(필수)

이미지템플릿Vhd배포자

이름 묘사 값
형 배포 유형입니다. 'VHD'(필수)

ImageTemplateVmProfile

이름 묘사 값
운영체제디스크 크기GB OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다. 정수

제약 조건:
최소값 = 0
vm크기 이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4). 문자열
vnetConfig 빌드 가상 머신을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다. 가상 네트워크 구성

이미지템플릿WindowsUpdateCustomizer

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

제약 조건:
최소값 = 0

플랫폼이미지구매계획

이름 묘사 값
플랜명 구매 플랜의 이름입니다. string(필수)
플랜Product 구매 플랜의 제품입니다. string(필수)
계획게시자 구매 플랜의 게시자입니다. string(필수)

리소스태그

이름 묘사 값

가상 네트워크 구성

이름 묘사 값
서브넷 ID 기존 서브넷의 리소스 ID입니다. 문자열

사용 예제

Azure 확인된 모듈

다음 Azure 확인된 모듈 사용하여 이 리소스 유형을 배포할 수 있습니다.

모듈 묘사
Virtual Machine 이미지 템플릿 Virtual Machine 이미지 템플릿용 AVM 리소스 모듈

Azure 빠른 시작 샘플

다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.

Bicep 파일 묘사
Azure Windows 기준 사용하여 Azure Image Builder Azure Image Builder 환경을 만들고 최신 Windows 업데이트 및 Azure Windows 기준이 적용된 Windows Server 이미지를 빌드합니다.
Dev Box 서비스 구성 이 템플릿은 Dev Box 빠른 시작 가이드(/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": "2020-02-14",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "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
    } ],
    "source": {
      "type": "string"
      // For remaining properties, see ImageTemplateSource objects
    },
    "vmProfile": {
      "osDiskSizeGB": "int",
      "vmSize": "string",
      "vnetConfig": {
        "subnetId": "string"
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

ImageTemplateSource 개체

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

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 개체

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

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

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

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

{
  "excludeFromLatest": "bool",
  "galleryImageId": "string",
  "replicationRegions": [ "string" ],
  "storageAccountType": "string",
  "type": "SharedImage"
}

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

{
  "type": "VHD"
}

ImageTemplateCustomizer 개체

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

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

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

이름 묘사 값
API버전 api 버전 '2020-02-14'
신원 구성된 경우 이미지 템플릿의 ID입니다. imageTemplateIdentity (필수)
위치 리소스 위치 string(필수)
이름 리소스 이름 문자열

제약 조건:
패턴 = ^[A-Za-z0-9-_.]{1,64}$(필수)
속성 이미지 템플릿의 속성 imageTemplateProperties
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
형 리소스 종류 'Microsoft.VirtualMachineImages/imageTemplates'

구성 요소Vrq145스키마이미지 템플릿ID속성사용자 할당 ID추가 속성

이름 묘사 값

이미지템플릿커스터마이저

이름 묘사 값
이름 이 사용자 지정 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름 문자열
형 ImageTemplateFileCustomizer형식에 대해 '파일'로 설정합니다. ImageTemplatePowerShellCustomizer형식에 대해 'PowerShell'로 설정합니다. ImageTemplateShellCustomizer형식에 대해 'Shell'으로 설정합니다. ImageTemplateRestartCustomizer형식에 대해 'WindowsRestart'로 설정합니다. ImageTemplateWindowsUpdateCustomizer형식에 대해 'WindowsUpdate'로 설정합니다. '파일'
'PowerShell'
'껍질'
'Windows다시 시작'
'WindowsUpdate'(필수)

ImageTemplateDistributor

이름 묘사 값
아티팩트태그 배포자에 의해 아티팩트가 생성/업데이트되면 아티팩트에 적용될 태그입니다. imageTemplateDistributorArtifactTags
runOutputName 연결된 RunOutput에 사용할 이름입니다. 문자열

제약 조건:
패턴 = ^[A-Za-z0-9-_.]{1,64}$(필수)
형 ImageTemplateManagedImageDistributor형식에 대해 'ManagedImage'로 설정합니다. ImageTemplateSharedImageDistributor형식에 대해 'SharedImage'로 설정합니다. ImageTemplateVhdDistributor형식에 대해 'VHD'로 설정합니다. '관리 이미지'
'공유 이미지'
'VHD'(필수)

ImageTemplateDistributorArtifact태그

이름 묘사 값

이미지템플릿파일커스터마이저

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

ImageTemplateIdentity (이미지템플릿아이덴티티)

이름 묘사 값
형 이미지 템플릿에 사용되는 ID의 형식입니다. 'None' 형식은 이미지 템플릿에서 모든 ID를 제거합니다. '없음'
'사용자 할당됨'
userAssignedIdentities 이미지 템플릿과 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다. imageTemplateIdentityUserAssignedIdentities

ImageTemplateIdentityUserAssignedIdentities

이름 묘사 값

ImageTemplateManagedImageDistributor

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

ImageTemplateManagedImageSource

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

ImageTemplatePlatformImageSource

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

ImageTemplatePowerShellCustomizer

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

ImageTemplate속성

이름 묘사 값
buildTimeoutInMinutes 이미지 템플릿을 빌드하는 동안 대기할 최대 기간입니다. 기본값(4시간)을 사용하려면 0을 생략하거나 지정합니다. 정수

제약 조건:
최소값 = 0
최대값 = 960
사용자 지정 이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다. imageTemplateCustomizer[]
배포 이미지 출력을 이동해야 하는 배포 대상입니다. imageTemplateDistributor[] (필수)
근원 원본 이미지를 설명하는 데 사용되는 속성을 지정합니다. imageTemplateSource (필수)
vm프로필 가상 머신을 설정하여 이미지를 빌드하는 방법을 설명합니다. ImageTemplateVmProfile

ImageTemplateRestartCustomizer

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

ImageTemplateSharedImageDistributor

이름 묘사 값
최신 항목에서 제외 만든 이미지 버전을 최신 버전에서 제외해야 하는지 여부를 나타내는 플래그입니다. 기본값(false)을 사용하지 않습니다. 부울
갤러리 이미지 ID 공유 이미지 갤러리 이미지의 리소스 ID string(필수)
replicationRegions 이미지가 복제될 지역 목록 string[] (필수)
storageAccountType을 입력합니다 공유 이미지를 저장하는 데 사용할 스토리지 계정 유형입니다. 기본값(Standard_LRS)을 사용하지 않습니다. 'Standard_LRS'
'Standard_ZRS'
형 배포 유형입니다. 'SharedImage'(필수)

ImageTemplateSharedImageVersionSource

이름 묘사 값
이미지 버전 ID 공유 이미지 갤러리에 있는 이미지 버전의 ARM 리소스 ID string(필수)
형 시작하려는 원본 이미지의 형식을 지정합니다. 'SharedImageVersion'(필수)

ImageTemplateShellCustomizer

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

ImageTemplateSource 이미지 템플릿 소스

이름 묘사 값
형 ImageTemplateManagedImageSource형식에 대해 'ManagedImage'로 설정합니다. ImageTemplatePlatformImageSource형식에 대해 'PlatformImage'로 설정합니다. ImageTemplateSharedImageVersionSource형식에 대해 'SharedImageVersion'으로 설정합니다. '관리 이미지'
'플랫폼 이미지'
'SharedImageVersion'(필수)

이미지템플릿Vhd배포자

이름 묘사 값
형 배포 유형입니다. 'VHD'(필수)

ImageTemplateVmProfile

이름 묘사 값
운영체제디스크 크기GB OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다. 정수

제약 조건:
최소값 = 0
vm크기 이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4). 문자열
vnetConfig 빌드 가상 머신을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다. 가상 네트워크 구성

이미지템플릿WindowsUpdateCustomizer

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

제약 조건:
최소값 = 0

플랫폼이미지구매계획

이름 묘사 값
플랜명 구매 플랜의 이름입니다. string(필수)
플랜Product 구매 플랜의 제품입니다. string(필수)
계획게시자 구매 플랜의 게시자입니다. string(필수)

리소스태그

이름 묘사 값

가상 네트워크 구성

이름 묘사 값
서브넷 ID 기존 서브넷의 리소스 ID입니다. 문자열

사용 예제

Azure 빠른 시작 템플릿

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

템플렛 묘사
Azure Windows 기준 사용하여 Azure Image Builder

Azure 배포 		Azure Image Builder 환경을 만들고 최신 Windows 업데이트 및 Azure Windows 기준이 적용된 Windows Server 이미지를 빌드합니다.
Dev Box 서비스 구성

Azure 배포 		이 템플릿은 Dev Box 빠른 시작 가이드(/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@2020-02-14"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      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
        }
      ]
      source = {
        type = "string"
        // For remaining properties, see ImageTemplateSource objects
      }
      vmProfile = {
        osDiskSizeGB = int
        vmSize = "string"
        vnetConfig = {
          subnetId = "string"
        }
      }
    }
  }
}

ImageTemplateSource 개체

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

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 개체

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

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

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

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

{
  excludeFromLatest = bool
  galleryImageId = "string"
  replicationRegions = [
    "string"
  ]
  storageAccountType = "string"
  type = "SharedImage"
}

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

{
  type = "VHD"
}

ImageTemplateCustomizer 개체

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

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

{
  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

이름 묘사 값
신원 구성된 경우 이미지 템플릿의 ID입니다. imageTemplateIdentity (필수)
위치 리소스 위치 string(필수)
이름 리소스 이름 문자열

제약 조건:
패턴 = ^[A-Za-z0-9-_.]{1,64}$(필수)
속성 이미지 템플릿의 속성 imageTemplateProperties
태그 리소스 태그 태그 이름 및 값의 사전입니다.
형 리소스 종류 "Microsoft.VirtualMachineImages/imageTemplates@2020-02-14"

구성 요소Vrq145스키마이미지 템플릿ID속성사용자 할당 ID추가 속성

이름 묘사 값

이미지템플릿커스터마이저

이름 묘사 값
이름 이 사용자 지정 단계에서 수행하는 작업의 컨텍스트를 제공하는 친숙한 이름 문자열
형 ImageTemplateFileCustomizer형식에 대해 '파일'로 설정합니다. ImageTemplatePowerShellCustomizer형식에 대해 'PowerShell'로 설정합니다. ImageTemplateShellCustomizer형식에 대해 'Shell'으로 설정합니다. ImageTemplateRestartCustomizer형식에 대해 'WindowsRestart'로 설정합니다. ImageTemplateWindowsUpdateCustomizer형식에 대해 'WindowsUpdate'로 설정합니다. '파일'
'PowerShell'
'껍질'
'Windows다시 시작'
'WindowsUpdate'(필수)

ImageTemplateDistributor

이름 묘사 값
아티팩트태그 배포자에 의해 아티팩트가 생성/업데이트되면 아티팩트에 적용될 태그입니다. imageTemplateDistributorArtifactTags
runOutputName 연결된 RunOutput에 사용할 이름입니다. 문자열

제약 조건:
패턴 = ^[A-Za-z0-9-_.]{1,64}$(필수)
형 ImageTemplateManagedImageDistributor형식에 대해 'ManagedImage'로 설정합니다. ImageTemplateSharedImageDistributor형식에 대해 'SharedImage'로 설정합니다. ImageTemplateVhdDistributor형식에 대해 'VHD'로 설정합니다. '관리 이미지'
'공유 이미지'
'VHD'(필수)

ImageTemplateDistributorArtifact태그

이름 묘사 값

이미지템플릿파일커스터마이저

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

ImageTemplateIdentity (이미지템플릿아이덴티티)

이름 묘사 값
형 이미지 템플릿에 사용되는 ID의 형식입니다. 'None' 형식은 이미지 템플릿에서 모든 ID를 제거합니다. '없음'
'사용자 할당됨'
userAssignedIdentities 이미지 템플릿과 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다. imageTemplateIdentityUserAssignedIdentities

ImageTemplateIdentityUserAssignedIdentities

이름 묘사 값

ImageTemplateManagedImageDistributor

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

ImageTemplateManagedImageSource

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

ImageTemplatePlatformImageSource

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

ImageTemplatePowerShellCustomizer

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

ImageTemplate속성

이름 묘사 값
buildTimeoutInMinutes 이미지 템플릿을 빌드하는 동안 대기할 최대 기간입니다. 기본값(4시간)을 사용하려면 0을 생략하거나 지정합니다. 정수

제약 조건:
최소값 = 0
최대값 = 960
사용자 지정 이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다. imageTemplateCustomizer[]
배포 이미지 출력을 이동해야 하는 배포 대상입니다. imageTemplateDistributor[] (필수)
근원 원본 이미지를 설명하는 데 사용되는 속성을 지정합니다. imageTemplateSource (필수)
vm프로필 가상 머신을 설정하여 이미지를 빌드하는 방법을 설명합니다. ImageTemplateVmProfile

ImageTemplateRestartCustomizer

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

ImageTemplateSharedImageDistributor

이름 묘사 값
최신 항목에서 제외 만든 이미지 버전을 최신 버전에서 제외해야 하는지 여부를 나타내는 플래그입니다. 기본값(false)을 사용하지 않습니다. 부울
갤러리 이미지 ID 공유 이미지 갤러리 이미지의 리소스 ID string(필수)
replicationRegions 이미지가 복제될 지역 목록 string[] (필수)
storageAccountType을 입력합니다 공유 이미지를 저장하는 데 사용할 스토리지 계정 유형입니다. 기본값(Standard_LRS)을 사용하지 않습니다. 'Standard_LRS'
'Standard_ZRS'
형 배포 유형입니다. 'SharedImage'(필수)

ImageTemplateSharedImageVersionSource

이름 묘사 값
이미지 버전 ID 공유 이미지 갤러리에 있는 이미지 버전의 ARM 리소스 ID string(필수)
형 시작하려는 원본 이미지의 형식을 지정합니다. 'SharedImageVersion'(필수)

ImageTemplateShellCustomizer

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

ImageTemplateSource 이미지 템플릿 소스

이름 묘사 값
형 ImageTemplateManagedImageSource형식에 대해 'ManagedImage'로 설정합니다. ImageTemplatePlatformImageSource형식에 대해 'PlatformImage'로 설정합니다. ImageTemplateSharedImageVersionSource형식에 대해 'SharedImageVersion'으로 설정합니다. '관리 이미지'
'플랫폼 이미지'
'SharedImageVersion'(필수)

이미지템플릿Vhd배포자

이름 묘사 값
형 배포 유형입니다. 'VHD'(필수)

ImageTemplateVmProfile

이름 묘사 값
운영체제디스크 크기GB OS 디스크의 크기(GB)입니다. Azure의 기본 OS 디스크 크기를 사용하려면 0을 생략하거나 지정합니다. 정수

제약 조건:
최소값 = 0
vm크기 이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값을 사용하려면 빈 문자열을 생략하거나 지정합니다(Gen1 이미지의 경우 Standard_D1_v2, Gen2 이미지의 경우 Standard_D2ds_v4). 문자열
vnetConfig 빌드 가상 머신을 배포하는 데 사용할 가상 네트워크의 선택적 구성입니다. 특정 가상 네트워크를 사용할 필요가 없는 경우 생략합니다. 가상 네트워크 구성

이미지템플릿WindowsUpdateCustomizer

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

제약 조건:
최소값 = 0

플랫폼이미지구매계획

이름 묘사 값
플랜명 구매 플랜의 이름입니다. string(필수)
플랜Product 구매 플랜의 제품입니다. string(필수)
계획게시자 구매 플랜의 게시자입니다. string(필수)

리소스태그

이름 묘사 값

가상 네트워크 구성

이름 묘사 값
서브넷 ID 기존 서브넷의 리소스 ID입니다. 문자열