Microsoft.Compute virtualMachineScaleSets/extensions \(英文\)
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[] |
| publisher | 擴充處理程序發行者的名稱。 | 字串 |
| 設定 | 擴充功能的 Json 格式化公用設定。 | 針對 Bicep，您可以使用 任何 () 函式。 |
| suppressFailures | 指出延伸模組的失敗是否會隱藏 (作業失敗，例如不會連線到 VM，而不論此值) 為何。 預設值為 false。 | bool |
| 類型 | 指定延伸模組的類型;範例為 「CustomScriptExtension」。。 | 字串 |
| typeHandlerVersion | 指定文稿處理程式的版本。 | 字串 |
KeyVaultSecretReference
| 名稱 | 描述 | 值 |
|---|---|---|
| secretUrl | 參考 金鑰保存庫 秘密的 URL。 | 字串 (必要) |
| sourceVault | 包含秘密之 金鑰保存庫的相對 URL。 | 必要子資源 () |
SubResource
| 名稱 | 描述 | 值 |
|---|---|---|
| id | 資源標識碼 | 字串 |
快速入門範本
下列快速入門範本會部署此資源類型。
| 範本 | 描述 |
|---|---|
部署深色追蹤自動調整 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
| 名稱 | 描述 | 值 |
|---|---|---|
| 類型 | 資源類型 | '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[] |
| publisher | 擴充處理程序發行者的名稱。 | 字串 |
| 設定 | 擴充功能的 Json 格式化公用設定。 | |
| suppressFailures | 指出延伸模組的失敗是否會隱藏 (作業失敗，例如不會連線到 VM，而不論此值) 為何。 預設值為 false。 | bool |
| 類型 | 指定延伸模組的類型;範例為 「CustomScriptExtension」。。 | 字串 |
| typeHandlerVersion | 指定文稿處理程式的版本。 | 字串 |
KeyVaultSecretReference
| 名稱 | 描述 | 值 |
|---|---|---|
| secretUrl | 參考 金鑰保存庫 秘密的 URL。 | 字串 (必要) |
| sourceVault | 包含秘密之 金鑰保存庫的相對 URL。 | 必要子資源 () |
SubResource
| 名稱 | 描述 | 值 |
|---|---|---|
| id | 資源標識碼 | 字串 |
快速入門範本
下列快速入門範本會部署此資源類型。
| 範本 | 描述 |
|---|---|
| 部署 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
| 名稱 | 描述 | 值 |
|---|---|---|
| 類型 | 資源類型 | “Microsoft.Compute/virtualMachineScaleSets/extensions@2023-09-01” |
| NAME | 資源名稱 | 需要字串 () |
| parent_id | 此資源父系之資源的標識碼。 | 類型資源的標識碼： virtualMachineScaleSets |
| properties | 描述虛擬機擴展集擴充功能的屬性。 | VirtualMachineScaleSetExtensionProperties |
VirtualMachineScaleSetExtensionProperties
| 名稱 | 描述 | 值 |
|---|---|---|
| autoUpgradeMinorVersion | 指出擴充功能是否應該在部署期間使用較新的次要版本。 不過，部署之後，除非重新部署延伸模組，否則延伸模組將不會升級次要版本，即使此屬性設定為 true 亦然。 | bool |
| enableAutomaticUpgrade | 指出如果有較新版本的擴充功能可用，平臺是否應該自動升級延伸模組。 | bool |
| forceUpdateTag | 如果提供值且與先前的值不同，即使延伸模組組態尚未變更，擴充處理程式仍會強制更新。 | 字串 |
| protectedSettings | 延伸模組可以包含 protectedSettings 或 protectedSettingsFromKeyVault，或完全不包含受保護的設定。 | |
| protectedSettingsFromKeyVault | 以傳址方式傳遞並從金鑰保存庫取用的延伸模組受保護設定 | KeyVaultSecretReference |
| provisionAfterExtensions | 延伸模組名稱的集合，之後必須布建此延伸模組。 | string[] |
| publisher | 擴充處理程序發行者的名稱。 | 字串 |
| 設定 | 延伸模組的 Json 格式化公用設定。 | |
| suppressFailures | 指出從擴充功能產生的失敗是否會隱藏 (作業失敗，例如不會連線到 VM，而不論此值為何) 。 預設值為 false。 | bool |
| 類型 | 指定延伸模組的類型;例如“CustomScriptExtension”。 | 字串 |
| typeHandlerVersion | 指定文稿處理程式的版本。 | 字串 |
KeyVaultSecretReference
| 名稱 | 描述 | 值 |
|---|---|---|
| secretUrl | 參考 金鑰保存庫 中秘密的URL。 | 需要字串 () |
| sourceVault | 包含秘密之 金鑰保存庫的相對 URL。 | 必要子資源 () |
SubResource
| 名稱 | 描述 | 值 |
|---|---|---|
| id | 資源標識碼 | 字串 |
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應