Microsoft.Compute virtualMachineScaleSets/extensions

아티클
03/07/2024

Bicep 리소스 정의

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

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

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

리소스 형식

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

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01' = {
  name: 'string'
  parent: resourceSymbolicName
  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'
  }
}

속성 값

virtualMachineScaleSets/extensions

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

VirtualMachineScaleSetExtensionProperties

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

KeyVaultSecretReference

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

SubResource

Name	Description	값
id	리소스 ID	문자열

빠른 시작 템플릿

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

템플릿	Description
Darktrace 자동 크기 조정 vSensors 배포	이 템플릿을 사용하면 Darktrace vSensors의 자동 크기 조정 배포를 자동으로 배포할 수 있습니다.
이 템플릿은 이전에 암호화된 Windows VMSS의 암호를 해독합니다.	이 템플릿은 실행 중인 Windows VM 확장 집합에서 암호화를 사용하지 않도록 설정합니다.
이 템플릿은 실행 중인 Windows VMSS를 암호화합니다.	이 템플릿은 실행 중인 Windows VM 확장 집합에서 암호화를 사용하도록 설정합니다.
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에 설치됩니다. 이 확장은 클라우드 에서 원격 증명 을 수행합니다.

ARM 템플릿 리소스 정의

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

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

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

리소스 형식

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

{
  "type": "Microsoft.Compute/virtualMachineScaleSets/extensions",
  "apiVersion": "2023-09-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"
  }
}

속성 값

virtualMachineScaleSets/extensions

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

VirtualMachineScaleSetExtensionProperties

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

KeyVaultSecretReference

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

SubResource

Name	Description	값
id	리소스 ID	string

빠른 시작 템플릿

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

템플릿	Description
Darktrace 자동 크기 조정 vSensors 배포	이 템플릿을 사용하면 Darktrace vSensors의 자동 크기 조정 배포를 자동으로 배포할 수 있습니다.
이 템플릿은 이전에 암호화된 Windows VMSS의 암호를 해독합니다.	이 템플릿은 실행 중인 Windows VM 확장 집합에서 암호화를 사용하지 않도록 설정합니다.
이 템플릿은 실행 중인 Windows VMSS를 암호화합니다.	이 템플릿을 사용하면 실행 중인 Windows VM 확장 집합에서 암호화할 수 있습니다.
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에 설치됩니다. 이 확장은 클라우드 에서 원격 증명 을 수행합니다.

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

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

리소스 그룹

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

리소스 형식

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      autoUpgradeMinorVersion = bool
      enableAutomaticUpgrade = bool
      forceUpdateTag = "string"
      protectedSettingsFromKeyVault = {
        secretUrl = "string"
        sourceVault = {
          id = "string"
        }
      }
      provisionAfterExtensions = [
        "string"
      ]
      publisher = "string"
      suppressFailures = bool
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

속성 값

virtualMachineScaleSets/extensions

Name	Description	값
형식	리소스 종류	"Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01"
name	리소스 이름	string(필수)
parent_id	이 리소스의 부모인 리소스의 ID입니다.	유형의 리소스에 대한 ID: virtualMachineScaleSets
properties	Virtual Machine Scale Set 확장의 속성에 대해 설명합니다.	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

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

KeyVaultSecretReference

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

SubResource

Name	Description	값
id	리소스 ID	string

Microsoft.Compute virtualMachineScaleSets/extensions

Bicep 리소스 정의

리소스 형식

속성 값

virtualMachineScaleSets/extensions

VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

SubResource

빠른 시작 템플릿

ARM 템플릿 리소스 정의

리소스 형식

속성 값

virtualMachineScaleSets/extensions

VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

SubResource

빠른 시작 템플릿

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

리소스 형식

속성 값

virtualMachineScaleSets/extensions

VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

SubResource

피드백

피드백

추가 리소스