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

Microsoft.Compute virtualMachineScaleSets/extensions

项目
03/13/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	资源名称了解如何在 Bicep 中设置子资源的名称和类型。	字符串 (必需)
父级 (parent)	在 Bicep 中，可以为子资源指定父资源。仅当子资源在父资源外部声明时，才需要添加此属性。有关详细信息，请参阅父资源之外的子资源。	类型为的资源的符号名称： virtualMachineScaleSets
properties	描述虚拟机规模集扩展的属性。	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

名称	说明	值
autoUpgradeMinorVersion	指示扩展是否应使用较新的次要版本（如果在部署时可用）。但是，部署后，除非重新部署，否则扩展不会升级次要版本，即使此属性设置为 true 也是如此。	bool
enableAutomaticUpgrade	指示如果有较新版本的可用扩展，平台是否应自动升级扩展。	bool
forceUpdateTag	如果提供的值与以前的值不同，则即使扩展配置未更改，也会强制更新扩展处理程序。	字符串
protectedSettings	该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault，或者根本不包含受保护的设置。	对于 Bicep，可以使用任何 () 函数。
protectedSettingsFromKeyVault	通过引用传递并从密钥保管库使用的扩展保护设置	KeyVaultSecretReference
provisionAfterExtensions	扩展名称的集合，之后需要预配此扩展。	string[]
发布者	扩展处理程序发布者的名称。	字符串
设置	扩展的 Json 格式的公共设置。	对于 Bicep，可以使用任何 () 函数。
suppressFailures	指示无论此值) 如何，都不会禁止因扩展而引发的故障 (操作故障（如未连接到 VM）。默认值为 false。	bool
类型	指定扩展的类型;例如“CustomScriptExtension”。	字符串
typeHandlerVersion	指定脚本处理程序的版本。	字符串

KeyVaultSecretReference

名称	说明	值
secretUrl	引用密钥保管库中的机密的 URL。	字符串 (必需)
sourceVault	包含机密的密钥保管库的相对 URL。	需要子资源 ()

SubResource

名称	说明	Value
id	资源 ID	字符串

快速入门模板

以下快速入门模板部署此资源类型。

模板	说明
部署 Darktrace 自动缩放 vSensors	此模板允许部署 Darktrace vSensors 的自动缩放部署
此模板解密以前加密的 Windows VMSS	此模板在正在运行的 Windows VM 规模集上禁用加密
此模板加密正在运行的 Windows VMSS	此模板在正在运行的 Windows VM 规模集上启用加密
使用 jumpbox 创建和加密新的 Windows VMSS	此模板允许使用最新修补版本的服务器 Windows 版本部署 Windows VM 的简单 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

名称	说明	Value
type	资源类型	'Microsoft.Compute/virtualMachineScaleSets/extensions'
apiVersion	资源 API 版本	'2023-09-01'
name	资源名称了解如何在 JSON ARM 模板中设置子资源的名称和类型。	字符串 (必需)
properties	描述虚拟机规模集扩展的属性。	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

名称	说明	值
autoUpgradeMinorVersion	指示扩展是否应使用较新的次要版本（如果在部署时可用）。但是，部署后，除非重新部署，否则扩展不会升级次要版本，即使此属性设置为 true 也是如此。	bool
enableAutomaticUpgrade	指示如果有较新版本的可用扩展，平台是否应自动升级扩展。	bool
forceUpdateTag	如果提供的值与以前的值不同，则即使扩展配置未更改，也会强制更新扩展处理程序。	字符串
protectedSettings	该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault，或者根本不包含受保护的设置。
protectedSettingsFromKeyVault	通过引用传递并从密钥保管库使用的扩展保护设置	KeyVaultSecretReference
provisionAfterExtensions	扩展名称的集合，之后需要预配此扩展。	string[]
发布者	扩展处理程序发布者的名称。	字符串
设置	扩展的 Json 格式的公共设置。
suppressFailures	指示无论此值) 如何，都不会禁止因扩展而引发的故障 (操作故障（如未连接到 VM）。默认值为 false。	bool
类型	指定扩展的类型;例如“CustomScriptExtension”。	字符串
typeHandlerVersion	指定脚本处理程序的版本。	字符串

KeyVaultSecretReference

名称	说明	值
secretUrl	引用密钥保管库中的机密的 URL。	字符串 (必需)
sourceVault	包含机密的密钥保管库的相对 URL。	需要子资源 ()

SubResource

名称	说明	Value
id	资源 ID	字符串

快速入门模板

以下快速入门模板部署此资源类型。

模板	说明
部署 Darktrace 自动缩放 vSensors	此模板允许部署 Darktrace vSensors 的自动缩放部署
此模板解密以前加密的 Windows VMSS	此模板在正在运行的 Windows VM 规模集上禁用加密
此模板加密正在运行的 Windows VMSS	此模板在正在运行的 Windows VM 规模集上启用加密
使用 jumpbox 创建和加密新的 Windows VMSS	此模板允许使用最新修补版本的服务器 Windows 版本部署 Windows VM 的简单 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

名称	说明	Value
type	资源类型	“Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01”
name	资源名称	字符串 (必需)
parent_id	此资源的父资源的 ID。	类型为：virtualMachineScaleSets 的资源的 ID
properties	描述虚拟机规模集扩展的属性。	VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProperties

名称	说明	值
autoUpgradeMinorVersion	指示扩展是否应使用较新的次要版本（如果在部署时可用）。但是，部署后，除非重新部署，否则扩展不会升级次要版本，即使此属性设置为 true 也是如此。	bool
enableAutomaticUpgrade	指示如果有较新版本的可用扩展，平台是否应自动升级扩展。	bool
forceUpdateTag	如果提供的值与以前的值不同，则即使扩展配置未更改，也会强制更新扩展处理程序。	字符串
protectedSettings	该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault，或者根本不包含受保护的设置。
protectedSettingsFromKeyVault	通过引用传递并从密钥保管库使用的扩展保护设置	KeyVaultSecretReference
provisionAfterExtensions	扩展名称的集合，之后需要预配此扩展。	string[]
发布者	扩展处理程序发布者的名称。	字符串
设置	扩展的 Json 格式的公共设置。
suppressFailures	指示无论此值) 如何，都不会禁止因扩展而引发的故障 (操作故障（如未连接到 VM）。默认值为 false。	bool
类型	指定扩展的类型;例如“CustomScriptExtension”。	字符串
typeHandlerVersion	指定脚本处理程序的版本。	字符串

KeyVaultSecretReference

名称	说明	值
secretUrl	引用密钥保管库中的机密的 URL。	字符串 (必需)
sourceVault	包含机密的密钥保管库的相对 URL。	需要子资源 ()

SubResource

名称	说明	Value
id	资源 ID	字符串

Microsoft.Compute virtualMachineScaleSets/extensions

Bicep 资源定义

资源格式

属性值

virtualMachineScaleSets/extensions

VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

SubResource

快速入门模板

ARM 模板资源定义

资源格式

属性值

virtualMachineScaleSets/extensions

VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

SubResource

快速入门模板

Terraform (AzAPI 提供程序) 资源定义

资源格式

属性值

virtualMachineScaleSets/extensions

VirtualMachineScaleSetExtensionProperties

KeyVaultSecretReference

SubResource

反馈

反馈

其他资源