다음을 통해 공유

Microsoft.VirtualMachineImages imageTemplates 2018-02-01-preview

  • 아티클

Bicep 리소스 정의

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

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

리소스 형식

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

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2018-02-01-preview' = {
  location: 'string'
  name: 'string'
  properties: {
    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
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

ImageTemplateSource 개체

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

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

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

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

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

ImageTemplateCustomizer 개체

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

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

{
  script: 'string'
  type: 'shell'
}

ImageTemplateDistributor 개체

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

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

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

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

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

속성 값

ImageTemplateCustomizer

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

ImageTemplateDistributor

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

제약 조건:
패턴 = ^[A-Za-z0-9-_]{1,64}$(필수)
형 ImageTemplateManagedImageDistributor형식에 대해 'managedImage'로 설정합니다. ImageTemplateSharedImageDistributor형식에 대해 'sharedImage'로 설정합니다. 'managedImage'
'sharedImage'(필수)

ImageTemplateDistributorArtifactTags

이름 묘사 값

ImageTemplateIsoSource

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

ImageTemplateManagedImageDistributor

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

ImageTemplatePlatformImageSource

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

ImageTemplateProperties

이름 묘사 값
사용자 지정 이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다. imageTemplateCustomizer[]
배포 이미지 출력을 이동해야 하는 배포 대상입니다. imageTemplateDistributor[] (필수)
근원 원본 이미지를 설명하는 데 사용되는 속성을 지정합니다. imageTemplateSource (필수)

ImageTemplateSharedImageDistributor

이름 묘사 값
galleryImageId 공유 이미지 갤러리 이미지의 리소스 ID string(필수)
replicationRegions string[] (필수)
형 배포 유형입니다. 'sharedImage'(필수)

ImageTemplateShellCustomizer

이름 묘사 값
각본 사용자 지정을 위해 실행할 셸 스크립트입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다. 문자열
형 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "shell"은 shellCustomizer일 수 있습니다. 'shell'(필수)

ImageTemplateSource

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

Microsoft.VirtualMachineImages/imageTemplates

이름 묘사 값
위치 리소스 위치 string(필수)
이름 리소스 이름 문자열

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

ResourceTags

이름 묘사 값

사용 예제

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": "2018-02-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "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
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

ImageTemplateSource 개체

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

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

{
  "sha256Checksum": "string",
  "sourceURI": "string",
  "type": "ISO"
}

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

{
  "offer": "string",
  "publisher": "string",
  "sku": "string",
  "type": "PlatformImage",
  "version": "string"
}

ImageTemplateCustomizer 개체

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

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

{
  "script": "string",
  "type": "shell"
}

ImageTemplateDistributor 개체

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

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

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

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

{
  "galleryImageId": "string",
  "replicationRegions": [ "string" ],
  "type": "sharedImage"
}

속성 값

ImageTemplateCustomizer

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

ImageTemplateDistributor

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

제약 조건:
패턴 = ^[A-Za-z0-9-_]{1,64}$(필수)
형 ImageTemplateManagedImageDistributor형식에 대해 'managedImage'로 설정합니다. ImageTemplateSharedImageDistributor형식에 대해 'sharedImage'로 설정합니다. 'managedImage'
'sharedImage'(필수)

ImageTemplateDistributorArtifactTags

이름 묘사 값

ImageTemplateIsoSource

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

ImageTemplateManagedImageDistributor

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

ImageTemplatePlatformImageSource

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

ImageTemplateProperties

이름 묘사 값
사용자 지정 이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다. imageTemplateCustomizer[]
배포 이미지 출력을 이동해야 하는 배포 대상입니다. imageTemplateDistributor[] (필수)
근원 원본 이미지를 설명하는 데 사용되는 속성을 지정합니다. imageTemplateSource (필수)

ImageTemplateSharedImageDistributor

이름 묘사 값
galleryImageId 공유 이미지 갤러리 이미지의 리소스 ID string(필수)
replicationRegions string[] (필수)
형 배포 유형입니다. 'sharedImage'(필수)

ImageTemplateShellCustomizer

이름 묘사 값
각본 사용자 지정을 위해 실행할 셸 스크립트입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다. 문자열
형 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "shell"은 shellCustomizer일 수 있습니다. 'shell'(필수)

ImageTemplateSource

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

Microsoft.VirtualMachineImages/imageTemplates

이름 묘사 값
apiVersion api 버전 '2018-02-01-preview'
위치 리소스 위치 string(필수)
이름 리소스 이름 문자열

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

ResourceTags

이름 묘사 값

사용 예제

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@2018-02-01-preview"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      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
      }
    }
  }
}

ImageTemplateSource 개체

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

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

{
  sha256Checksum = "string"
  sourceURI = "string"
  type = "ISO"
}

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

{
  offer = "string"
  publisher = "string"
  sku = "string"
  type = "PlatformImage"
  version = "string"
}

ImageTemplateCustomizer 개체

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

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

{
  script = "string"
  type = "shell"
}

ImageTemplateDistributor 개체

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

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

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

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

{
  galleryImageId = "string"
  replicationRegions = [
    "string"
  ]
  type = "sharedImage"
}

속성 값

ImageTemplateCustomizer

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

ImageTemplateDistributor

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

제약 조건:
패턴 = ^[A-Za-z0-9-_]{1,64}$(필수)
형 ImageTemplateManagedImageDistributor형식에 대해 'managedImage'로 설정합니다. ImageTemplateSharedImageDistributor형식에 대해 'sharedImage'로 설정합니다. 'managedImage'
'sharedImage'(필수)

ImageTemplateDistributorArtifactTags

이름 묘사 값

ImageTemplateIsoSource

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

ImageTemplateManagedImageDistributor

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

ImageTemplatePlatformImageSource

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

ImageTemplateProperties

이름 묘사 값
사용자 지정 이미지 원본 등 이미지의 사용자 지정 단계를 설명하는 데 사용되는 속성을 지정합니다. imageTemplateCustomizer[]
배포 이미지 출력을 이동해야 하는 배포 대상입니다. imageTemplateDistributor[] (필수)
근원 원본 이미지를 설명하는 데 사용되는 속성을 지정합니다. imageTemplateSource (필수)

ImageTemplateSharedImageDistributor

이름 묘사 값
galleryImageId 공유 이미지 갤러리 이미지의 리소스 ID string(필수)
replicationRegions string[] (필수)
형 배포 유형입니다. 'sharedImage'(필수)

ImageTemplateShellCustomizer

이름 묘사 값
각본 사용자 지정을 위해 실행할 셸 스크립트입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다. 문자열
형 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "shell"은 shellCustomizer일 수 있습니다. 'shell'(필수)

ImageTemplateSource

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

Microsoft.VirtualMachineImages/imageTemplates

이름 묘사 값
위치 리소스 위치 string(필수)
이름 리소스 이름 문자열

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

ResourceTags

이름 묘사 값