Microsoft.Compute virtualMachines/extensions

아티클
08/17/2024

Bicep 리소스 정의

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

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

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

리소스 형식

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

resource symbolicname 'Microsoft.Compute/virtualMachines/extensions@2024-07-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

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

VirtualMachineExtensionProperties

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

VirtualMachineExtensionInstanceView

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

InstanceViewStatus

이름	묘사	값
코드	상태 코드입니다.	문자열
displayStatus	상태에 대한 짧은 지역화 가능 레이블입니다.	문자열
수준	수준 코드입니다.	'Error' '정보' '경고'
메시지	경고 및 오류 메시지를 포함한 자세한 상태 메시지입니다.	문자열
시간	상태의 시간입니다.	문자열

KeyVaultSecretReference

이름	묘사	값
secretUrl	Key Vault의 비밀을 참조하는 URL입니다.	string(필수)
sourceVault	비밀을 포함하는 Key Vault의 상대 URL입니다.	SubResource(필수)

SubResource

이름	묘사	값
아이디	리소스 ID	문자열

빠른 시작 템플릿

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

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

ARM 템플릿 리소스 정의

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

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

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

리소스 형식

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

{
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "apiVersion": "2024-07-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

이름	묘사	값
형	리소스 종류	'Microsoft.Compute/virtualMachines/extensions'
apiVersion	리소스 api 버전	'2024-07-01'
이름	리소스 이름 JSON ARM 템플릿자식 리소스의 이름과 형식을 설정하는 방법을 참조하세요.	string(필수)
위치	리소스 위치	문자열
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
속성	Virtual Machine 확장의 속성에 대해 설명합니다.	VirtualMachineExtensionProperties

VirtualMachineExtensionProperties

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

VirtualMachineExtensionInstanceView

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

InstanceViewStatus

이름	묘사	값
코드	상태 코드입니다.	문자열
displayStatus	상태에 대한 짧은 지역화 가능 레이블입니다.	문자열
수준	수준 코드입니다.	'Error' '정보' '경고'
메시지	경고 및 오류 메시지를 포함한 자세한 상태 메시지입니다.	문자열
시간	상태의 시간입니다.	문자열

KeyVaultSecretReference

이름	묘사	값
secretUrl	Key Vault의 비밀을 참조하는 URL입니다.	string(필수)
sourceVault	비밀을 포함하는 Key Vault의 상대 URL입니다.	SubResource(필수)

SubResource

이름	묘사	값
아이디	리소스 ID	문자열

빠른 시작 템플릿

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

템플렛	묘사
맬웨어 방지 확장을 사용하도록 설정된 Windows VM 만들기 Azure 배포	이 템플릿은 Windows VM을 만들고 맬웨어 방지 보호를 설정합니다.
Windows VM DSC 확장을 사용하여 IIS 서버 Azure 배포	이 템플릿은 Windows VM을 만들고 DSC 확장을 사용하여 IIS 서버를 설정합니다. DSC 구성 모듈은 Azure Storage를 사용하는 경우 SAS 토큰을 전달해야 합니다. GitHub의 DSC 모듈 링크(이 템플릿의 기본값)의 경우 필요하지 않습니다.
ESET VM 확장 Azure 배포	ESET 확장을 사용하여 VM 만들기
Windows VM McAfee Endpoint Security(평가판 라이선스) Azure 배포	이 템플릿은 Windows VM을 만들고 McAfee Endpoint Security의 평가판 버전을 설정합니다.
OMS 확장 사용하여 Ubuntu VM 배포 Azure 배포	이 템플릿을 사용하면 OMS 확장이 설치되고 지정된 작업 영역에 온보딩된 Ubuntu VM을 배포할 수 있습니다.
OMS 확장 사용하여 Windows VM 배포 Azure 배포	이 템플릿을 사용하면 OMS 확장이 설치되고 지정된 작업 영역에 온보딩된 Windows VM을 배포할 수 있습니다.
Windows VM Symantec Endpoint Protection 확장 평가판 Azure 배포	이 템플릿은 Windows VM을 만들고 Symantec Endpoint Protection의 평가판 버전을 설정합니다.
Ubuntu VM 사용자 지정 스크립트 확장 Azure 배포	이 템플릿은 Ubuntu VM을 만들고 CustomScript 확장을 설치합니다.
Ubuntu VM OS 패치 확장을 Azure 배포	이 템플릿은 Ubuntu VM을 만들고 OSPatching 확장을 설치합니다.
진단 사용하여 프리미엄 Windows VM 배포 Azure 배포	이 템플릿을 사용하면 최신 패치 버전을 사용하여 Windows 버전에 대한 몇 가지 다른 옵션을 사용하여 프리미엄 Windows VM을 배포할 수 있습니다.
모니터링 및 진단 사용하여 간단한 Windows VM 배포 Azure 배포	이 템플릿을 사용하면 VM에 대한 모니터링 및 진단을 가능하게 하는 진단 확장과 함께 간단한 Windows VM을 배포할 수 있습니다.
스크립트 확장을 사용하여 Ubuntu VM Mongo DB 설치 Azure 배포	이 템플릿은 두 개의 별도 스크립트로 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@2024-07-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

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

VirtualMachineExtensionProperties

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

VirtualMachineExtensionInstanceView

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

InstanceViewStatus

이름	묘사	값
코드	상태 코드입니다.	문자열
displayStatus	상태에 대한 짧은 지역화 가능 레이블입니다.	문자열
수준	수준 코드입니다.	"오류" "정보" "경고"
메시지	경고 및 오류 메시지를 포함한 자세한 상태 메시지입니다.	문자열
시간	상태의 시간입니다.	문자열

KeyVaultSecretReference

이름	묘사	값
secretUrl	Key Vault의 비밀을 참조하는 URL입니다.	string(필수)
sourceVault	비밀을 포함하는 Key Vault의 상대 URL입니다.	SubResource(필수)

SubResource

이름	묘사	값
아이디	리소스 ID	문자열

다음을 통해 공유

Microsoft.Compute virtualMachines/extensions

Bicep 리소스 정의

리소스 형식

속성 값

virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

SubResource

빠른 시작 템플릿

ARM 템플릿 리소스 정의

리소스 형식

속성 값

virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

SubResource

빠른 시작 템플릿

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

리소스 형식

속성 값

virtualMachines/extensions

VirtualMachineExtensionProperties

VirtualMachineExtensionInstanceView

InstanceViewStatus

KeyVaultSecretReference

SubResource

피드백

추가 리소스