你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn 。
Microsoft.Compute virtualMachineScaleSets/extensions
本文内容
Bicep 资源定义
可以使用目标操作部署 virtualMachineScaleSets/extensions 资源类型：
有关每个 API 版本中已更改属性的列表，请参阅 更改日志 。
若要创建 Microsoft.Compute/virtualMachineScaleSets/extensions 资源，请将以下 Bicep 添加到模板。
resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets/extensions@2024-07-01' = {
parent: resourceSymbolicName
name: 'string'
properties: {
autoUpgradeMinorVersion: bool
enableAutomaticUpgrade: bool
forceUpdateTag: 'string'
protectedSettings: any(Azure.Bicep.Types.Concrete.AnyType)
protectedSettingsFromKeyVault: {
secretUrl: 'string'
sourceVault: {
id: 'string'
}
}
provisionAfterExtensions: [
'string'
]
publisher: 'string'
settings: any(Azure.Bicep.Types.Concrete.AnyType)
suppressFailures: bool
type: 'string'
typeHandlerVersion: 'string'
}
}
属性值
KeyVaultSecretReference
名字
描述
价值
secretUrl
引用 Key Vault 中的机密的 URL。
string （必需）
sourceVault
包含机密的 Key Vault 的相对 URL。
SubResource （必需）
Microsoft.Compute/virtualMachineScaleSets/extensions
SubResource
VirtualMachineScaleSetExtensionProperties
名字
描述
价值
autoUpgradeMinorVersion
指示扩展是否应在部署时使用较新的次要版本。 但是，部署后，除非重新部署，否则扩展不会升级次要版本，即使此属性设置为 true 也是如此。
bool
enableAutomaticUpgrade
指示如果有较新版本的扩展可用，平台是否应自动升级扩展。
bool
forceUpdateTag
如果提供值并且与上一个值不同，则即使扩展配置未更改，扩展处理程序也会强制更新。
字符串
protectedSettings
该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault，或者根本不包含受保护的设置。
任何
protectedSettingsFromKeyVault
由引用传递的扩展保护的设置，并从密钥保管库使用
KeyVaultSecretReference
provisionAfterExtensions
需要预配此扩展的扩展名称的集合。
string[]
发行人
扩展处理程序发布者的名称。
字符串
设置
扩展的 Json 格式公共设置。
任何
suppressFailures
指示是否取消来自扩展的故障（不连接到 VM 等操作故障不会取消，而不管此值如何）。 默认值为 false。
bool
类型
指定扩展的类型;例如“CustomScriptExtension”。
字符串
typeHandlerVersion
指定脚本处理程序的版本。
字符串
快速入门示例
以下快速入门示例部署此资源类型。
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-07-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"
}
}
属性值
KeyVaultSecretReference
名字
描述
价值
secretUrl
引用 Key Vault 中的机密的 URL。
string （必需）
sourceVault
包含机密的 Key Vault 的相对 URL。
SubResource （必需）
Microsoft.Compute/virtualMachineScaleSets/extensions
SubResource
VirtualMachineScaleSetExtensionProperties
名字
描述
价值
autoUpgradeMinorVersion
指示扩展是否应在部署时使用较新的次要版本。 但是，部署后，除非重新部署，否则扩展不会升级次要版本，即使此属性设置为 true 也是如此。
bool
enableAutomaticUpgrade
指示如果有较新版本的扩展可用，平台是否应自动升级扩展。
bool
forceUpdateTag
如果提供值并且与上一个值不同，则即使扩展配置未更改，扩展处理程序也会强制更新。
字符串
protectedSettings
该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault，或者根本不包含受保护的设置。
任何
protectedSettingsFromKeyVault
由引用传递的扩展保护的设置，并从密钥保管库使用
KeyVaultSecretReference
provisionAfterExtensions
需要预配此扩展的扩展名称的集合。
string[]
发行人
扩展处理程序发布者的名称。
字符串
设置
扩展的 Json 格式公共设置。
任何
suppressFailures
指示是否取消来自扩展的故障（不连接到 VM 等操作故障不会取消，而不管此值如何）。 默认值为 false。
bool
类型
指定扩展的类型;例如“CustomScriptExtension”。
字符串
typeHandlerVersion
指定脚本处理程序的版本。
字符串
快速入门模板
以下快速入门模板部署此资源类型。
模板
描述
使用 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 规模集上启用加密
可以使用目标操作部署 virtualMachineScaleSets/extensions 资源类型：
有关每个 API 版本中已更改属性的列表，请参阅 更改日志 。
若要创建 Microsoft.Compute/virtualMachineScaleSets/extensions 资源，请将以下 Terraform 添加到模板。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/virtualMachineScaleSets/extensions@2024-07-01"
name = "string"
body = jsonencode({
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"
}
})
}
属性值
KeyVaultSecretReference
名字
描述
价值
secretUrl
引用 Key Vault 中的机密的 URL。
string （必需）
sourceVault
包含机密的 Key Vault 的相对 URL。
SubResource （必需）
Microsoft.Compute/virtualMachineScaleSets/extensions
SubResource
VirtualMachineScaleSetExtensionProperties
名字
描述
价值
autoUpgradeMinorVersion
指示扩展是否应在部署时使用较新的次要版本。 但是，部署后，除非重新部署，否则扩展不会升级次要版本，即使此属性设置为 true 也是如此。
bool
enableAutomaticUpgrade
指示如果有较新版本的扩展可用，平台是否应自动升级扩展。
bool
forceUpdateTag
如果提供值并且与上一个值不同，则即使扩展配置未更改，扩展处理程序也会强制更新。
字符串
protectedSettings
该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault，或者根本不包含受保护的设置。
任何
protectedSettingsFromKeyVault
由引用传递的扩展保护的设置，并从密钥保管库使用
KeyVaultSecretReference
provisionAfterExtensions
需要预配此扩展的扩展名称的集合。
string[]
发行人
扩展处理程序发布者的名称。
字符串
设置
扩展的 Json 格式公共设置。
任何
suppressFailures
指示是否取消来自扩展的故障（不连接到 VM 等操作故障不会取消，而不管此值如何）。 默认值为 false。
bool
类型
指定扩展的类型;例如“CustomScriptExtension”。
字符串
typeHandlerVersion
指定脚本处理程序的版本。
字符串
