你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft.Compute virtualMachineScaleSets/virtualMachines/extensions 2019-07-01

• 最新
• 2024-07-01
• 2024-03-01
• 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
• 2020-06-01
• 2019-12-01
• 2019-07-01

Bicep 资源定义

可以使用目标操作部署 virtualMachineScaleSets/virtualMachines/extensions 资源类型：

• 资源组 - 请参阅 资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2019-07-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  properties: {
    autoUpgradeMinorVersion: 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(Azure.Bicep.Types.Concrete.AnyType)
    publisher: 'string'
    settings: any(Azure.Bicep.Types.Concrete.AnyType)
    type: 'string'
    typeHandlerVersion: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

属性值

InstanceViewStatus

名字	描述	价值
法典	状态代码。	字符串
displayStatus	状态的简短可本地化标签。	字符串
水平	级别代码。	“Error” “Info” “Warning”
消息	详细状态消息，包括警报和错误消息。	字符串
时间	状态的时间。	字符串

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

名字	描述	价值
位置	资源位置	string （必需）
名字	资源名称	string （必需）
父母	在 Bicep 中，可以为子资源指定父资源。 仅当子资源在父资源外部声明时，才需要添加此属性。 有关详细信息，请参阅 父资源外部的子资源。	类型资源的符号名称：virtualMachineScaleSets/virtualMachines
性能	描述虚拟机扩展的属性。	VirtualMachineExtensionProperties
标签	资源标记	标记名称和值的字典。 请参阅模板 中的 标记

ResourceTags

名字	描述	价值

VirtualMachineExtensionInstanceView

名字	描述	价值
名字	虚拟机扩展名称。	字符串
状态	资源状态信息。	InstanceViewStatus[]
substatuses	资源状态信息。	InstanceViewStatus[]
类型	指定扩展的类型;例如“CustomScriptExtension”。	字符串
typeHandlerVersion	指定脚本处理程序的版本。	字符串

VirtualMachineExtensionProperties

名字	描述	价值
autoUpgradeMinorVersion	指示扩展是否应在部署时使用较新的次要版本。 但是，部署后，除非重新部署，否则扩展不会升级次要版本，即使此属性设置为 true 也是如此。	bool
forceUpdateTag	即使扩展配置未更改，扩展处理程序也应强制更新。	字符串
instanceView	虚拟机扩展实例视图。	VirtualMachineExtensionInstanceView
protectedSettings	该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault，或者根本不包含受保护的设置。	任何
发行人	扩展处理程序发布者的名称。	字符串
设置	扩展的 Json 格式公共设置。	任何
类型	指定扩展的类型;例如“CustomScriptExtension”。	字符串
typeHandlerVersion	指定脚本处理程序的版本。	字符串

ARM 模板资源定义

可以使用目标操作部署 virtualMachineScaleSets/virtualMachines/extensions 资源类型：

• 资源组 - 请参阅 资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions 资源，请将以下 JSON 添加到模板。

{
  "type": "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions",
  "apiVersion": "2019-07-01",
  "name": "string",
  "location": "string",
  "properties": {
    "autoUpgradeMinorVersion": "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": {},
    "publisher": "string",
    "settings": {},
    "type": "string",
    "typeHandlerVersion": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

属性值

InstanceViewStatus

名字	描述	价值
法典	状态代码。	字符串
displayStatus	状态的简短可本地化标签。	字符串
水平	级别代码。	“Error” “Info” “Warning”
消息	详细状态消息，包括警报和错误消息。	字符串
时间	状态的时间。	字符串

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

名字	描述	价值
apiVersion	API 版本	'2019-07-01'
位置	资源位置	string （必需）
名字	资源名称	string （必需）
性能	描述虚拟机扩展的属性。	VirtualMachineExtensionProperties
标签	资源标记	标记名称和值的字典。 请参阅模板 中的 标记
类型	资源类型	“Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions”

ResourceTags

名字	描述	价值

VirtualMachineExtensionInstanceView

名字	描述	价值
名字	虚拟机扩展名称。	字符串
状态	资源状态信息。	InstanceViewStatus[]
substatuses	资源状态信息。	InstanceViewStatus[]
类型	指定扩展的类型;例如“CustomScriptExtension”。	字符串
typeHandlerVersion	指定脚本处理程序的版本。	字符串

VirtualMachineExtensionProperties

名字	描述	价值
autoUpgradeMinorVersion	指示扩展是否应在部署时使用较新的次要版本。 但是，部署后，除非重新部署，否则扩展不会升级次要版本，即使此属性设置为 true 也是如此。	bool
forceUpdateTag	即使扩展配置未更改，扩展处理程序也应强制更新。	字符串
instanceView	虚拟机扩展实例视图。	VirtualMachineExtensionInstanceView
protectedSettings	该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault，或者根本不包含受保护的设置。	任何
发行人	扩展处理程序发布者的名称。	字符串
设置	扩展的 Json 格式公共设置。	任何
类型	指定扩展的类型;例如“CustomScriptExtension”。	字符串
typeHandlerVersion	指定脚本处理程序的版本。	字符串

Terraform （AzAPI 提供程序）资源定义

可以使用目标操作部署 virtualMachineScaleSets/virtualMachines/extensions 资源类型：

• 资源组

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions 资源，请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2019-07-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      autoUpgradeMinorVersion = 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 = ?
      publisher = "string"
      settings = ?
      type = "string"
      typeHandlerVersion = "string"
    }
  })
}

属性值

InstanceViewStatus

名字	描述	价值
法典	状态代码。	字符串
displayStatus	状态的简短可本地化标签。	字符串
水平	级别代码。	“Error” “Info” “Warning”
消息	详细状态消息，包括警报和错误消息。	字符串
时间	状态的时间。	字符串

Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions

名字	描述	价值
位置	资源位置	string （必需）
名字	资源名称	string （必需）
parent_id	此资源的父资源的 ID。	类型资源的 ID：virtualMachineScaleSets/virtualMachines
性能	描述虚拟机扩展的属性。	VirtualMachineExtensionProperties
标签	资源标记	标记名称和值的字典。
类型	资源类型	“Microsoft.Compute/virtualMachineScaleSets/virtualMachines/extensions@2019-07-01”

ResourceTags

名字	描述	价值

VirtualMachineExtensionInstanceView

名字	描述	价值
名字	虚拟机扩展名称。	字符串
状态	资源状态信息。	InstanceViewStatus[]
substatuses	资源状态信息。	InstanceViewStatus[]
类型	指定扩展的类型;例如“CustomScriptExtension”。	字符串
typeHandlerVersion	指定脚本处理程序的版本。	字符串

VirtualMachineExtensionProperties

名字	描述	价值
autoUpgradeMinorVersion	指示扩展是否应在部署时使用较新的次要版本。 但是，部署后，除非重新部署，否则扩展不会升级次要版本，即使此属性设置为 true 也是如此。	bool
forceUpdateTag	即使扩展配置未更改，扩展处理程序也应强制更新。	字符串
instanceView	虚拟机扩展实例视图。	VirtualMachineExtensionInstanceView
protectedSettings	该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault，或者根本不包含受保护的设置。	任何
发行人	扩展处理程序发布者的名称。	字符串
设置	扩展的 Json 格式公共设置。	任何
类型	指定扩展的类型;例如“CustomScriptExtension”。	字符串
typeHandlerVersion	指定脚本处理程序的版本。	字符串