다음을 통해 공유

Microsoft.VirtualMachineImages imageTemplates 2019-02-01-preview

  • 아티클

Bicep 리소스 정의

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

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

리소스 형식

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

resource symbolicname 'Microsoft.VirtualMachineImages/imageTemplates@2019-02-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  properties: {
    customize: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ]
    distribute: [
      {
        artifactTags: {}
        runOutputName: 'string'
        type: 'string'
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ]
    source: {
      type: 'string'
      // For remaining properties, see ImageTemplateSource objects
    }
  }
}

ImageTemplateCustomizer 개체

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

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

  type: 'PowerShell'
  inline: [
    'string'
  ]
  script: 'string'
  validExitCodes: [
    int
  ]

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

  type: 'Shell'
  inline: [
    'string'
  ]
  script: 'string'

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

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

ImageTemplateDistributor 개체

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

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

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

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

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

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

  type: 'VHD'

ImageTemplateSource 개체

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

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

  type: 'ISO'
  sha256Checksum: 'string'
  sourceURI: 'string'

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

  type: 'ManagedImage'
  imageId: 'string'

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

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

속성 값

imageTemplates

이름 묘사 값
이름 리소스 이름 string(필수)
위치 리소스 위치 string(필수)
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
속성 imageTemplateProperties

ImageTemplateProperties

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

ImageTemplateCustomizer

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

ImageTemplatePowerShellCustomizer

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

ImageTemplateShellCustomizer

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

ImageTemplateRestartCustomizer

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

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'(필수)
galleryImageId 공유 이미지 갤러리 이미지의 리소스 ID string(필수)
replicationRegions string[] (필수)

ImageTemplateVhdDistributor

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

ImageTemplateSource

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

ImageTemplateIsoSource

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

ImageTemplateManagedImageSource

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

ImageTemplatePlatformImageSource

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

빠른 시작 템플릿

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

템플렛 묘사
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": "2019-02-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "customize": [
      {
        "name": "string",
        "type": "string"
        // For remaining properties, see ImageTemplateCustomizer objects
      }
    ],
    "distribute": [
      {
        "artifactTags": {},
        "runOutputName": "string",
        "type": "string"
        // For remaining properties, see ImageTemplateDistributor objects
      }
    ],
    "source": {
      "type": "string"
      // For remaining properties, see ImageTemplateSource objects
    }
  }
}

ImageTemplateCustomizer 개체

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

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

  "type": "PowerShell",
  "inline": [ "string" ],
  "script": "string",
  "validExitCodes": [ "int" ]

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

  "type": "Shell",
  "inline": [ "string" ],
  "script": "string"

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

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

ImageTemplateDistributor 개체

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

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

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

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

  "type": "SharedImage",
  "galleryImageId": "string",
  "replicationRegions": [ "string" ]

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

  "type": "VHD"

ImageTemplateSource 개체

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

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

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

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

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

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

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

속성 값

imageTemplates

이름 묘사 값
형 리소스 종류 'Microsoft.VirtualMachineImages/imageTemplates'
apiVersion 리소스 api 버전 '2019-02-01-preview'
이름 리소스 이름 string(필수)
위치 리소스 위치 string(필수)
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
속성 imageTemplateProperties

ImageTemplateProperties

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

ImageTemplateCustomizer

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

ImageTemplatePowerShellCustomizer

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

ImageTemplateShellCustomizer

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

ImageTemplateRestartCustomizer

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

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'(필수)
galleryImageId 공유 이미지 갤러리 이미지의 리소스 ID string(필수)
replicationRegions string[] (필수)

ImageTemplateVhdDistributor

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

ImageTemplateSource

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

ImageTemplateIsoSource

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

ImageTemplateManagedImageSource

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

ImageTemplatePlatformImageSource

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

빠른 시작 템플릿

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

템플렛 묘사
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@2019-02-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      customize = [
        {
          name = "string"
          type = "string"
          // For remaining properties, see ImageTemplateCustomizer objects
        }
      ]
      distribute = [
        {
          artifactTags = {}
          runOutputName = "string"
          type = "string"
          // For remaining properties, see ImageTemplateDistributor objects
        }
      ]
      source = {
        type = "string"
        // For remaining properties, see ImageTemplateSource objects
      }
    }
  })
}

ImageTemplateCustomizer 개체

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

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

  type = "PowerShell"
  inline = [
    "string"
  ]
  script = "string"
  validExitCodes = [
    int
  ]

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

  type = "Shell"
  inline = [
    "string"
  ]
  script = "string"

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

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

ImageTemplateDistributor 개체

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

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

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

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

  type = "SharedImage"
  galleryImageId = "string"
  replicationRegions = [
    "string"
  ]

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

  type = "VHD"

ImageTemplateSource 개체

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

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

  type = "ISO"
  sha256Checksum = "string"
  sourceURI = "string"

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

  type = "ManagedImage"
  imageId = "string"

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

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

속성 값

imageTemplates

이름 묘사 값
형 리소스 종류 "Microsoft.VirtualMachineImages/imageTemplates@2019-02-01-preview"
이름 리소스 이름 string(필수)
위치 리소스 위치 string(필수)
parent_id 리소스 그룹에 배포하려면 해당 리소스 그룹의 ID를 사용합니다. string(필수)
태그 리소스 태그 태그 이름 및 값의 사전입니다.
속성 imageTemplateProperties

ImageTemplateProperties

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

ImageTemplateCustomizer

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

ImageTemplatePowerShellCustomizer

이름 묘사 값
형 이미지에서 사용하려는 사용자 지정 도구의 유형입니다. 예를 들어 "Shell"은 셸 사용자 지정자일 수 있습니다. "PowerShell"(필수)
인라인 실행할 PowerShell 명령 배열 string[]
각본 사용자 지정을 위해 실행할 PowerShell 스크립트입니다. Github 링크, Azure Storage용 SAS URI 등이 될 수 있습니다. 문자열
validExitCodes PowerShell 스크립트에 대한 유효한 종료 코드입니다. [기본값: 0] int[]

ImageTemplateShellCustomizer

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

ImageTemplateRestartCustomizer

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

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"(필수)
galleryImageId 공유 이미지 갤러리 이미지의 리소스 ID string(필수)
replicationRegions string[] (필수)

ImageTemplateVhdDistributor

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

ImageTemplateSource

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

ImageTemplateIsoSource

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

ImageTemplateManagedImageSource

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

ImageTemplatePlatformImageSource

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