Microsoft.Compute virtualMachines/extensions

• 최신
• 2023-09-01
• 2023-07-01
• 2023-03-01
• 2022-11-01
• 2022-08-01
• 2022-03-01
• 2021-11-01
• 2021-07-01
• 2021-04-01
• 2021-03-01
• 2020-12-01

Bicep 리소스 정의

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

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

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

리소스 형식

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

resource symbolicname 'Microsoft.Compute/virtualMachines/extensions@2023-09-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    autoUpgradeMinorVersion: bool
    enableAutomaticUpgrade: bool
    forceUpdateTag: 'string'
    instanceView: {
      name: 'string'
      statuses: [
        {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
      ]
      substatuses: [
        {
          code: 'string'
          displayStatus: 'string'
          level: 'string'
          message: 'string'
          time: 'string'
        }
      ]
      type: 'string'
      typeHandlerVersion: 'string'
    }
    protectedSettings: any()
    protectedSettingsFromKeyVault: {
      secretUrl: 'string'
      sourceVault: {
        id: 'string'
      }
    }
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any()
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

속성 값

virtualMachines/extensions

Name	Description	값
name	리소스 이름 Bicep에서 자식 리소스의 이름과 형식을 설정하는 방법을 참조하세요.	string(필수)
위치	리소스 위치	문자열
tags	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요.
부모(parent)	Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가하면 됩니다. 자세한 내용은 부모 리소스 외부의 자식 리소스를 참조하세요.	형식의 리소스에 대한 기호 이름: virtualMachines
properties	가상 머신 확장의 속성에 대해 설명합니다.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Name	Description	값
autoUpgradeMinorVersion	배포 시 사용할 수 있는 경우 확장에서 최신 부 버전을 사용해야 하는지 여부를 나타냅니다. 그러나 일단 배포되면 이 속성이 true로 설정된 경우에도 확장이 재배포되지 않는 한 부 버전을 업그레이드하지 않습니다.	bool
enableAutomaticUpgrade	사용 가능한 최신 버전의 확장이 있는 경우 플랫폼에서 확장을 자동으로 업그레이드해야 하는지 여부를 나타냅니다.	bool
forceUpdateTag	확장 구성이 변경되지 않은 경우에도 확장 처리기를 강제로 업데이트해야 하는 방법입니다.	문자열
instanceView	가상 머신 확장 instance 보기입니다.	VirtualMachineExtensionInstanceView
protectedSettings	확장에는 protectedSettings 또는 protectedSettingsFromKeyVault 또는 보호된 설정이 전혀 포함될 수 있습니다.	Bicep의 경우 any() 함수를 사용할 수 있습니다.
protectedSettingsFromKeyVault	키 자격 증명 모음에서 참조로 전달되고 사용되는 확장 보호 설정	KeyVaultSecretReference
provisionAfterExtensions	이 확장을 프로비전해야 하는 확장 이름 컬렉션입니다.	string[]
publisher	확장 처리기 게시자의 이름입니다.	문자열
설정	확장에 대한 Json 형식의 공용 설정입니다.	Bicep의 경우 any() 함수를 사용할 수 있습니다.
suppressFailures	확장에서 비롯된 오류가 표시되지 않는지 여부를 나타냅니다(VM에 연결하지 않는 등의 운영 오류는 이 값에 관계없이 표시되지 않음). 기본값은 false입니다.	bool
형식	확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.	문자열
typeHandlerVersion	스크립트 처리기의 버전을 지정합니다.	문자열

VirtualMachineExtensionInstanceView

Name	Description	값
name	가상 머신 확장 이름입니다.	문자열
statuses	리소스 상태 정보입니다.	InstanceViewStatus[]
하위 통계	리소스 상태 정보입니다.	InstanceViewStatus[]
형식	확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.	문자열
typeHandlerVersion	스크립트 처리기의 버전을 지정합니다.	문자열

InstanceViewStatus

Name	Description	값
코드	상태 코드입니다.	string
displayStatus	상태 대한 짧은 지역화 가능 레이블입니다.	string
수준	수준 코드입니다.	'Error' '정보' '경고'
message	경고 및 오류 메시지를 포함하여 자세한 상태 메시지입니다.	문자열
time	상태 시간입니다.	string

KeyVaultSecretReference

Name	Description	값
secretUrl	Key Vault 비밀을 참조하는 URL입니다.	string(필수)
sourceVault	비밀을 포함하는 Key Vault 상대 URL입니다.	SubResource (필수)

SubResource

Name	Description	값
id	리소스 ID	string

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.

템플릿	Description
맬웨어 방지 확장을 사용하도록 설정된 Windows VM 만들기	이 템플릿은 Windows VM을 만들고 맬웨어 방지 보호를 설정합니다.
Windows VM에서 DSC 확장을 사용하는 IIS 서버	이 템플릿은 Windows VM을 만들고 DSC 확장을 사용하여 IIS 서버를 설정합니다. DSC 구성 모듈은 Azure Storage를 사용하는 경우 SAS 토큰을 전달해야 합니다. GitHub의 DSC 모듈 링크(이 템플릿의 기본값)의 경우 필요하지 않습니다.
ESET VM 확장	ESET 확장을 사용하여 VM 만들기
Windows VM의 McAfee Endpoint Security(평가판 라이선스)	이 템플릿은 Windows VM을 만들고 McAfee Endpoint Security의 평가판 버전을 설정합니다.
OMS 확장을 사용하여 Ubuntu VM 배포	이 템플릿을 사용하면 OMS 확장이 설치되고 지정된 작업 영역에 온보딩된 Ubuntu VM을 배포할 수 있습니다.
OMS 확장을 사용하여 Windows VM 배포	이 템플릿을 사용하면 OMS 확장이 설치되고 지정된 작업 영역에 온보딩된 Windows VM을 배포할 수 있습니다.
Windows VM에서 Symantec Endpoint Protection 확장 평가판	이 템플릿은 Windows VM을 만들고 Symantec Endpoint Protection의 평가판 버전을 설정합니다.
Ubuntu VM의 사용자 지정 스크립트 확장	이 템플릿은 Ubuntu VM을 만들고 CustomScript 확장을 설치합니다.
Ubuntu VM의 OS 패치 확장	이 템플릿은 Ubuntu VM을 만들고 OSPatching 확장을 설치합니다.
진단 사용하여 프리미엄 Windows VM 배포	이 템플릿을 사용하면 최신 패치 버전을 사용하여 Windows 버전에 대한 몇 가지 다른 옵션을 사용하여 프리미엄 Windows VM을 배포할 수 있습니다.
모니터링 및 진단 사용하여 간단한 Windows VM 배포	이 템플릿을 사용하면 VM에 대한 모니터링 및 진단 수 있는 진단 확장과 함께 간단한 Windows VM을 배포할 수 있습니다.
스크립트 확장을 사용하여 Ubuntu VM에 Mongo DB 설치	이 템플릿은 두 개의 개별 스크립트로 Ubuntu Virtual Machine에 Mongo DB 구성 및 설치를 배포합니다. 이 템플릿은 동일한 가상 머신에서 실행되는 두 스크립트 간의 종속성을 표현하는 방법을 보여 주는 좋은 예입니다. 또한 이 템플릿은 스토리지 계정, Virtual Network, 공용 IP 주소 및 네트워크 인터페이스를 배포합니다.

ARM 템플릿 리소스 정의

virtualMachines/extensions 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

• 리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.

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

리소스 형식

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

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "apiVersion": "2023-09-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "autoUpgradeMinorVersion": "bool",
    "enableAutomaticUpgrade": "bool",
    "forceUpdateTag": "string",
    "instanceView": {
      "name": "string",
      "statuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        }
      ],
      "substatuses": [
        {
          "code": "string",
          "displayStatus": "string",
          "level": "string",
          "message": "string",
          "time": "string"
        }
      ],
      "type": "string",
      "typeHandlerVersion": "string"
    },
    "protectedSettings": {},
    "protectedSettingsFromKeyVault": {
      "secretUrl": "string",
      "sourceVault": {
        "id": "string"
      }
    },
    "provisionAfterExtensions": [ "string" ],
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

속성 값

virtualMachines/extensions

Name	Description	값
형식	리소스 종류	'Microsoft.Compute/virtualMachines/extensions'
apiVersion	리소스 api 버전	'2023-09-01'
name	리소스 이름 JSON ARM 템플릿에서 자식 리소스의 이름 및 형식을 설정하는 방법을 참조하세요.	string(필수)
위치	리소스 위치	string
tags	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요.
properties	가상 머신 확장의 속성에 대해 설명합니다.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Name	Description	값
autoUpgradeMinorVersion	배포 시 사용할 수 있는 경우 확장에서 최신 부 버전을 사용해야 하는지 여부를 나타냅니다. 그러나 일단 배포되면 이 속성이 true로 설정된 경우에도 확장이 재배포되지 않는 한 부 버전을 업그레이드하지 않습니다.	bool
enableAutomaticUpgrade	사용 가능한 최신 버전의 확장이 있는 경우 플랫폼에서 확장을 자동으로 업그레이드해야 하는지 여부를 나타냅니다.	bool
forceUpdateTag	확장 구성이 변경되지 않은 경우에도 확장 처리기를 강제로 업데이트해야 하는 방법입니다.	string
instanceView	가상 머신 확장 instance 보기입니다.	VirtualMachineExtensionInstanceView
protectedSettings	확장에는 protectedSettings 또는 protectedSettingsFromKeyVault 또는 보호된 설정이 전혀 포함될 수 있습니다.
protectedSettingsFromKeyVault	키 자격 증명 모음에서 참조로 전달되고 사용되는 확장 보호 설정	KeyVaultSecretReference
provisionAfterExtensions	이 확장을 프로비전해야 하는 확장 이름 컬렉션입니다.	string[]
publisher	확장 처리기 게시자의 이름입니다.	문자열
설정	확장에 대한 Json 형식의 공용 설정입니다.
suppressFailures	확장에서 비롯된 오류가 표시되지 않는지 여부를 나타냅니다(VM에 연결하지 않는 등의 운영 오류는 이 값에 관계없이 표시되지 않음). 기본값은 false입니다.	bool
형식	확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.	문자열
typeHandlerVersion	스크립트 처리기의 버전을 지정합니다.	문자열

VirtualMachineExtensionInstanceView

Name	Description	값
name	가상 머신 확장 이름입니다.	문자열
statuses	리소스 상태 정보입니다.	InstanceViewStatus[]
하위 통계	리소스 상태 정보입니다.	InstanceViewStatus[]
형식	확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.	문자열
typeHandlerVersion	스크립트 처리기의 버전을 지정합니다.	문자열

InstanceViewStatus

Name	Description	값
코드	상태 코드입니다.	문자열
displayStatus	상태 대한 짧은 지역화 가능 레이블입니다.	문자열
수준	수준 코드입니다.	'오류' '정보' '경고'
message	경고 및 오류 메시지를 포함하여 자세한 상태 메시지입니다.	string
time	상태 시간입니다.	string

KeyVaultSecretReference

Name	Description	값
secretUrl	Key Vault 비밀을 참조하는 URL입니다.	string(필수)
sourceVault	비밀을 포함하는 Key Vault 상대 URL입니다.	SubResource (필수)

SubResource

Name	Description	값
id	리소스 ID	문자열

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.

템플릿	Description
맬웨어 방지 확장을 사용하도록 설정된 Windows VM 만들기	이 템플릿은 Windows VM을 만들고 맬웨어 방지 보호를 설정합니다.
Windows VM에서 DSC 확장을 사용하는 IIS 서버	이 템플릿은 Windows VM을 만들고 DSC 확장을 사용하여 IIS 서버를 설정합니다. DSC 구성 모듈은 Azure Storage를 사용하는 경우 SAS 토큰을 전달해야 합니다. GitHub의 DSC 모듈 링크(이 템플릿의 기본값)의 경우 필요하지 않습니다.
ESET VM 확장	ESET 확장을 사용하여 VM 만들기
Windows VM의 McAfee Endpoint Security(평가판 라이선스)	이 템플릿은 Windows VM을 만들고 McAfee Endpoint Security의 평가판 버전을 설정합니다.
OMS 확장을 사용하여 Ubuntu VM 배포	이 템플릿을 사용하면 OMS 확장이 설치되고 지정된 작업 영역에 온보딩된 Ubuntu VM을 배포할 수 있습니다.
OMS 확장을 사용하여 Windows VM 배포	이 템플릿을 사용하면 OMS 확장이 설치되고 지정된 작업 영역에 온보딩된 Windows VM을 배포할 수 있습니다.
Windows VM에서 Symantec Endpoint Protection 확장 평가판	이 템플릿은 Windows VM을 만들고 Symantec Endpoint Protection의 평가판 버전을 설정합니다.
Ubuntu VM의 사용자 지정 스크립트 확장	이 템플릿은 Ubuntu VM을 만들고 CustomScript 확장을 설치합니다.
Ubuntu VM의 OS 패치 확장	이 템플릿은 Ubuntu VM을 만들고 OSPatching 확장을 설치합니다.
진단 사용하여 프리미엄 Windows VM 배포	이 템플릿을 사용하면 최신 패치 버전을 사용하여 Windows 버전에 대한 몇 가지 다른 옵션을 사용하여 프리미엄 Windows VM을 배포할 수 있습니다.
모니터링 및 진단 사용하여 간단한 Windows VM 배포	이 템플릿을 사용하면 VM에 대한 모니터링 및 진단 수 있는 진단 확장과 함께 간단한 Windows VM을 배포할 수 있습니다.
스크립트 확장을 사용하여 Ubuntu VM에 Mongo DB 설치	이 템플릿은 두 개의 개별 스크립트로 Ubuntu Virtual Machine에 Mongo DB 구성 및 설치를 배포합니다. 이 템플릿은 동일한 가상 머신에서 실행되는 두 스크립트 간의 종속성을 표현하는 방법을 보여 주는 좋은 예입니다. 또한 이 템플릿은 스토리지 계정, Virtual Network, 공용 IP 주소 및 네트워크 인터페이스를 배포합니다.

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

virtualMachines/extensions 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

• 리소스 그룹

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

리소스 형식

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachines/extensions@2023-09-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      autoUpgradeMinorVersion = bool
      enableAutomaticUpgrade = bool
      forceUpdateTag = "string"
      instanceView = {
        name = "string"
        statuses = [
          {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
        ]
        substatuses = [
          {
            code = "string"
            displayStatus = "string"
            level = "string"
            message = "string"
            time = "string"
          }
        ]
        type = "string"
        typeHandlerVersion = "string"
      }
      protectedSettingsFromKeyVault = {
        secretUrl = "string"
        sourceVault = {
          id = "string"
        }
      }
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

속성 값

virtualMachines/extensions

Name	Description	값
형식	리소스 종류	"Microsoft.Compute/virtualMachines/extensions@2023-09-01"
name	리소스 이름	string(필수)
위치	리소스 위치	문자열
parent_id	이 리소스의 부모인 리소스의 ID입니다.	유형의 리소스에 대한 ID: virtualMachines
tags	리소스 태그	태그 이름 및 값의 사전입니다.
properties	Virtual Machine 확장의 속성에 대해 설명합니다.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

Name	Description	값
autoUpgradeMinorVersion	배포 시 사용할 수 있는 경우 확장에서 최신 부 버전을 사용해야 하는지 여부를 나타냅니다. 그러나 일단 배포되면 이 속성이 true로 설정된 경우에도 확장이 재배포되지 않는 한 부 버전을 업그레이드하지 않습니다.	bool
enableAutomaticUpgrade	사용 가능한 최신 버전의 확장이 있는 경우 플랫폼에서 확장을 자동으로 업그레이드해야 하는지 여부를 나타냅니다.	bool
forceUpdateTag	확장 구성이 변경되지 않은 경우에도 확장 처리기를 강제로 업데이트해야 하는 방법입니다.	문자열
instanceView	가상 머신 확장 instance 보기입니다.	VirtualMachineExtensionInstanceView
protectedSettings	확장에는 protectedSettings 또는 protectedSettingsFromKeyVault 또는 보호된 설정이 전혀 포함될 수 있습니다.
protectedSettingsFromKeyVault	키 자격 증명 모음에서 참조로 전달되고 사용되는 확장 보호 설정	KeyVaultSecretReference
provisionAfterExtensions	이 확장을 프로비전해야 하는 확장 이름 컬렉션입니다.	string[]
publisher	확장 처리기 게시자의 이름입니다.	string
설정	확장에 대한 Json 형식의 공용 설정입니다.
suppressFailures	확장에서 비롯된 오류가 표시되지 않는지 여부를 나타냅니다(VM에 연결하지 않는 등의 운영 오류는 이 값에 관계없이 표시되지 않음). 기본값은 false입니다.	bool
형식	확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.	문자열
typeHandlerVersion	스크립트 처리기의 버전을 지정합니다.	string

VirtualMachineExtensionInstanceView

Name	Description	값
name	가상 머신 확장 이름입니다.	string
statuses	리소스 상태 정보입니다.	InstanceViewStatus[]
하위 통계	리소스 상태 정보입니다.	InstanceViewStatus[]
형식	확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.	문자열
typeHandlerVersion	스크립트 처리기의 버전을 지정합니다.	문자열

InstanceViewStatus

Name	Description	값
코드	상태 코드입니다.	문자열
displayStatus	상태 대한 짧은 지역화 가능 레이블입니다.	문자열
수준	수준 코드입니다.	"오류" "정보" "Warning"
message	경고 및 오류 메시지를 포함하여 자세한 상태 메시지입니다.	string
time	상태 시간입니다.	문자열

KeyVaultSecretReference

Name	Description	값
secretUrl	Key Vault 비밀을 참조하는 URL입니다.	string(필수)
sourceVault	비밀을 포함하는 Key Vault 상대 URL입니다.	SubResource (필수)

SubResource

Name	Description	값
id	리소스 ID	string