다음을 통해 공유


Microsoft.Compute virtualMachineScaleSets/virtualMachines/extensions 2023-09-01

Bicep 리소스 정의

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

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

리소스 형식

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

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

속성 값

virtualMachineScaleSets/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 문자열

ARM 템플릿 리소스 정의

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

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

리소스 형식

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

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

속성 값

virtualMachineScaleSets/virtualMachines/extensions

이름 묘사
리소스 종류 'Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions'
apiVersion 리소스 api 버전 '2023-09-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 문자열

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

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

  • 리소스 그룹

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

리소스 형식

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2023-09-01"
  name = "string"
  location = "string"
  parent_id = "string"
  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"
    }
  })
}

속성 값

virtualMachineScaleSets/virtualMachines/extensions

이름 묘사
리소스 종류 "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2023-09-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 문자열