Microsoft.Compute virtualMachineScaleSets/확장

2025-06-27

Bicep 리소스 정의

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

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

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

리소스 형식

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

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/extensions@2024-11-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    autoUpgradeMinorVersion: bool
    enableAutomaticUpgrade: bool
    forceUpdateTag: 'string'
    protectedSettings: any(...)
    protectedSettingsFromKeyVault: {
      secretUrl: 'string'
      sourceVault: {
        id: 'string'
      }
    }
    provisionAfterExtensions: [
      'string'
    ]
    publisher: 'string'
    settings: any(...)
    suppressFailures: bool
    type: 'string'
    typeHandlerVersion: 'string'
  }
}

속성 값

Microsoft.Compute/virtualMachineScaleSets/확장

이름	묘사	값
이름	리소스 이름	string(필수)
부모	Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다. 자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요.	형식 리소스의 기호 이름: virtualMachineScaleSets
속성	Virtual Machine Scale Set 확장의 속성에 대해 설명합니다.	VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

이름	묘사	값
시크릿 URL	Key Vault의 비밀을 참조하는 URL입니다.	string(필수)
소스 볼트	비밀을 포함하는 Key Vault의 상대 URL입니다.	SubResource(필수)

하위 리소스

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

VirtualMachineScaleSetExtensionProperties

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

사용 예제

Azure 빠른 시작 샘플

다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.

Bicep 파일	묘사
신뢰할 수 있는 시작 지원 Windows VM 확장 집합 배포	이 템플릿을 사용하면 Windows Server 2016, Windows Server 2019 또는 Windows Server 2022 Azure Edition의 최신 패치 버전을 사용하여 신뢰할 수 있는 Windows VM 확장 집합을 배포할 수 있습니다. 이러한 VM은 RDP 연결에 대한 NAT 규칙을 사용하는 부하 분산 장치 뒤에 있습니다. Secureboot 및 vTPM을 사용하도록 설정하면 게스트 증명 확장이 VMSS에 설치됩니다. 이 확장은 클라우드에서 원격 증명 수행합니다.

Bicep 파일

묘사

신뢰할 수 있는 시작 지원 Windows VM 확장 집합 배포

이 템플릿을 사용하면 Windows Server 2016, Windows Server 2019 또는 Windows Server 2022 Azure Edition의 최신 패치 버전을 사용하여 신뢰할 수 있는 Windows VM 확장 집합을 배포할 수 있습니다. 이러한 VM은 RDP 연결에 대한 NAT 규칙을 사용하는 부하 분산 장치 뒤에 있습니다. Secureboot 및 vTPM을 사용하도록 설정하면 게스트 증명 확장이 VMSS에 설치됩니다. 이 확장은 클라우드에서 원격 증명 수행합니다.

ARM 템플릿 리소스 정의

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

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

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

리소스 형식

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

{
  "type": "Microsoft.Compute/virtualMachineScaleSets/extensions",
  "apiVersion": "2024-11-01",
  "name": "string",
  "properties": {
    "autoUpgradeMinorVersion": "bool",
    "enableAutomaticUpgrade": "bool",
    "forceUpdateTag": "string",
    "protectedSettings": {},
    "protectedSettingsFromKeyVault": {
      "secretUrl": "string",
      "sourceVault": {
        "id": "string"
      }
    },
    "provisionAfterExtensions": [ "string" ],
    "publisher": "string",
    "settings": {},
    "suppressFailures": "bool",
    "type": "string",
    "typeHandlerVersion": "string"
  }
}

속성 값

Microsoft.Compute/virtualMachineScaleSets/확장

이름	묘사	값
API버전	api 버전	'2024-11-01'
이름	리소스 이름	string(필수)
속성	Virtual Machine Scale Set 확장의 속성에 대해 설명합니다.	VirtualMachineScaleSetExtensionProperties
형	리소스 종류	'Microsoft.Compute/virtualMachineScaleSets/확장'

KeyVaultSecretReference

이름	묘사	값
시크릿 URL	Key Vault의 비밀을 참조하는 URL입니다.	string(필수)
소스 볼트	비밀을 포함하는 Key Vault의 상대 URL입니다.	SubResource(필수)

하위 리소스

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

VirtualMachineScaleSetExtensionProperties

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

사용 예제

Azure 빠른 시작 템플릿

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

템플렛	묘사
jumpbox 사용하여 새 Windows VMSS 만들기 및 암호화	이 템플릿을 사용하면 가장 마지막으로 패치된 버전의 서버 Windows 버전을 사용하여 간단한 Windows VM 확장 집합을 배포할 수 있습니다. 또한 이 템플릿은 동일한 가상 네트워크에 공용 IP 주소가 있는 jumpbox를 배포합니다. 이 공용 IP 주소를 통해 jumpbox에 연결한 다음, 개인 IP 주소를 통해 확장 집합의 VM에 연결할 수 있습니다. 이 템플릿은 Windows VM의 VM 확장 집합에서 암호화를 사용하도록 설정합니다.
신뢰할 수 있는 시작 지원 Windows VM 확장 집합 배포	이 템플릿을 사용하면 Windows Server 2016, Windows Server 2019 또는 Windows Server 2022 Azure Edition의 최신 패치 버전을 사용하여 신뢰할 수 있는 Windows VM 확장 집합을 배포할 수 있습니다. 이러한 VM은 RDP 연결에 대한 NAT 규칙을 사용하는 부하 분산 장치 뒤에 있습니다. Secureboot 및 vTPM을 사용하도록 설정하면 게스트 증명 확장이 VMSS에 설치됩니다. 이 확장은 클라우드에서 원격 증명 수행합니다.
Darktrace 자동 크기 조정 vSensors 배포	이 템플릿을 사용하면 Darktrace vSensors의 자동 크기 조정 배포를 배포할 수 있습니다.
이 템플릿은 이전에 암호화된 Windows VMSS 암호를 해독합니다.	이 템플릿은 실행 중인 Windows VM 확장 집합에서 암호화를 사용하지 않도록 설정합니다.
이 템플릿은 실행 중인 Windows VMSS 암호화합니다.	이 템플릿은 실행 중인 Windows VM 확장 집합에서 암호화를 사용하도록 설정합니다.

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

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

리소스 그룹

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

리소스 형식

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/extensions@2024-11-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      autoUpgradeMinorVersion = bool
      enableAutomaticUpgrade = bool
      forceUpdateTag = "string"
      protectedSettings = ?
      protectedSettingsFromKeyVault = {
        secretUrl = "string"
        sourceVault = {
          id = "string"
        }
      }
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      settings = ?
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  }
}

속성 값

Microsoft.Compute/virtualMachineScaleSets/확장

이름	묘사	값
이름	리소스 이름	string(필수)
부모 ID	이 리소스의 부모인 리소스의 ID입니다.	형식의 리소스 ID: virtualMachineScaleSets
속성	Virtual Machine Scale Set 확장의 속성에 대해 설명합니다.	VirtualMachineScaleSetExtensionProperties
형	리소스 종류	"Microsoft.Compute/virtualMachineScaleSets/extensions@2024-11-01"

KeyVaultSecretReference

이름	묘사	값
시크릿 URL	Key Vault의 비밀을 참조하는 URL입니다.	string(필수)
소스 볼트	비밀을 포함하는 Key Vault의 상대 URL입니다.	SubResource(필수)

하위 리소스

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

VirtualMachineScaleSetExtensionProperties

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

다음을 통해 공유

Microsoft.Compute virtualMachineScaleSets/확장

Bicep 리소스 정의

리소스 형식

속성 값

Microsoft.Compute/virtualMachineScaleSets/확장

KeyVaultSecretReference

하위 리소스

VirtualMachineScaleSetExtensionProperties

사용 예제

Azure 빠른 시작 샘플

ARM 템플릿 리소스 정의

리소스 형식

속성 값

Microsoft.Compute/virtualMachineScaleSets/확장

KeyVaultSecretReference

하위 리소스

VirtualMachineScaleSetExtensionProperties

사용 예제

Azure 빠른 시작 템플릿

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

리소스 형식

속성 값

Microsoft.Compute/virtualMachineScaleSets/확장

KeyVaultSecretReference

하위 리소스

VirtualMachineScaleSetExtensionProperties

피드백

추가 리소스