Microsoft.VirtualMachineImages imageTemplates 2019-05-01-preview

아티클
12/17/2024

Bicep 리소스 정의

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

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

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

리소스 형식

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

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2019-05-01-preview' = {
  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: {
      vmSize: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

ImageTemplateDistributor 개체

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

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

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

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

{
  galleryImageId: 'string'
  replicationRegions: [
    'string'
  ]
  type: 'SharedImage'
}

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

{
  type: 'VHD'
}

ImageTemplateCustomizer 개체

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

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

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

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

{
  inline: [
    'string'
  ]
  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'
}

ImageTemplateSource 개체

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

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

{
  sha256Checksum: 'string'
  sourceUri: 'string'
  type: 'ISO'
}

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

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

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

{
  offer: 'string'
  publisher: 'string'
  sku: 'string'
  type: 'PlatformImage'
  version: 'string'
}

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

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

속성 값

ComponentsVrq145SchemasImagetemplateidentityPropertiesUserassignedidentitiesAdditionalproperties

이름	묘사	값

ImageTemplateCustomizer

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

ImageTemplateDistributor

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

ImageTemplateDistributorArtifactTags

이름	묘사	값

ImageTemplateFileCustomizer

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

ImageTemplateIdentity

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

ImageTemplateIdentityUserAssignedIdentities

이름	묘사	값

ImageTemplateIsoSource

이름	묘사	값
sha256Checksum	ISO 이미지의 SHA256 체크섬입니다.	string(필수)
sourceUri	ISO 이미지를 가져오는 URI입니다. 이 URI는 이미지 템플릿을 만들 때 리소스 공급자가 액세스할 수 있어야 합니다.	string(필수)
형	시작하려는 원본 이미지의 형식을 지정합니다.	'ISO'(필수)

ImageTemplateManagedImageDistributor

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

ImageTemplateManagedImageSource

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

ImageTemplatePlatformImageSource

이름	묘사	값
제공	Azure Gallery 이미지이미지 제품.	문자열
게시자	Azure Gallery 이미지이미지 게시자.	문자열
sku	Azure Gallery 이미지이미지 sku.	문자열
형	시작하려는 원본 이미지의 형식을 지정합니다.	'PlatformImage'(필수)
버전	Azure Gallery 이미지이미지 버전입니다.	문자열

ImageTemplatePowerShellCustomizer

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

ImageTemplateProperties

이름	묘사	값
buildTimeoutInMinutes	이미지 템플릿을 빌드하는 동안 대기할 최대 기간입니다. 기본값(4시간)을 사용하려면 0을 생략하거나 지정합니다.	int 제약 조건: 최소값 = 0 최대값 = 960
사용자 지정	이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다.	imageTemplateCustomizer[]
배포	이미지 출력을 이동해야 하는 배포 대상입니다.	imageTemplateDistributor[] (필수)
근원	원본 이미지를 설명하는 데 사용되는 속성을 지정합니다.	imageTemplateSource (필수)
vmProfile	가상 머신을 설정하여 이미지를 빌드하는 방법을 설명합니다.	ImageTemplateVmProfile

ImageTemplateRestartCustomizer

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

ImageTemplateSharedImageDistributor

이름	묘사	값
galleryImageId	공유 이미지 갤러리 이미지의 리소스 ID	string(필수)
replicationRegions	이미지가 복제될 지역 목록	string[] (필수)
형	배포 유형입니다.	'SharedImage'(필수)

ImageTemplateSharedImageVersionSource

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

ImageTemplateShellCustomizer

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

ImageTemplateSource

이름	묘사	값
형	ImageTemplateIsoSource형식에 대해 'ISO'로 설정합니다. ImageTemplateManagedImageSource형식에 대해 'ManagedImage'로 설정합니다. ImageTemplatePlatformImageSource형식에 대해 'PlatformImage'로 설정합니다. ImageTemplateSharedImageVersionSource형식에 대해 'SharedImageVersion'으로 설정합니다.	'ISO' 'ManagedImage' 'PlatformImage' 'SharedImageVersion'(필수)

ImageTemplateVhdDistributor

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

ImageTemplateVmProfile

이름	묘사	값
vmSize	이미지를 빌드, 사용자 지정 및 캡처하는 데 사용되는 가상 머신의 크기입니다. 기본값(Standard_D1_v2)을 사용하도록 빈 문자열을 생략하거나 지정합니다.	문자열