共用方式為


Microsoft.Compute virtualMachineScaleSets 2022-11-01

Bicep 資源定義

virtualMachineScaleSets 資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔

資源格式

若要建立 Microsoft.Compute/virtualMachineScaleSets 資源,請將下列 Bicep 新增至範本。

resource symbolicname 'Microsoft.Compute/virtualMachineScaleSets@2022-11-01' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  plan: {
    name: 'string'
    product: 'string'
    promotionCode: 'string'
    publisher: 'string'
  }
  properties: {
    additionalCapabilities: {
      hibernationEnabled: bool
      ultraSSDEnabled: bool
    }
    automaticRepairsPolicy: {
      enabled: bool
      gracePeriod: 'string'
      repairAction: 'string'
    }
    constrainedMaximumCapacity: bool
    doNotRunExtensionsOnOverprovisionedVMs: bool
    hostGroup: {
      id: 'string'
    }
    orchestrationMode: 'string'
    overprovision: bool
    platformFaultDomainCount: int
    priorityMixPolicy: {
      baseRegularPriorityCount: int
      regularPriorityPercentageAboveBase: int
    }
    proximityPlacementGroup: {
      id: 'string'
    }
    scaleInPolicy: {
      forceDeletion: bool
      rules: [
        'string'
      ]
    }
    singlePlacementGroup: bool
    spotRestorePolicy: {
      enabled: bool
      restoreTimeout: 'string'
    }
    upgradePolicy: {
      automaticOSUpgradePolicy: {
        disableAutomaticRollback: bool
        enableAutomaticOSUpgrade: bool
        useRollingUpgradePolicy: bool
      }
      mode: 'string'
      rollingUpgradePolicy: {
        enableCrossZoneUpgrade: bool
        maxBatchInstancePercent: int
        maxSurge: bool
        maxUnhealthyInstancePercent: int
        maxUnhealthyUpgradedInstancePercent: int
        pauseTimeBetweenBatches: 'string'
        prioritizeUnhealthyInstances: bool
        rollbackFailedInstancesOnPolicyBreach: bool
      }
    }
    virtualMachineProfile: {
      applicationProfile: {
        galleryApplications: [
          {
            configurationReference: 'string'
            enableAutomaticUpgrade: bool
            order: int
            packageReferenceId: 'string'
            tags: 'string'
            treatFailureAsDeploymentFailure: bool
          }
        ]
      }
      billingProfile: {
        maxPrice: int
      }
      capacityReservation: {
        capacityReservationGroup: {
          id: 'string'
        }
      }
      diagnosticsProfile: {
        bootDiagnostics: {
          enabled: bool
          storageUri: 'string'
        }
      }
      evictionPolicy: 'string'
      extensionProfile: {
        extensions: [
          {
            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'
            }
          }
        ]
        extensionsTimeBudget: 'string'
      }
      hardwareProfile: {
        vmSizeProperties: {
          vCPUsAvailable: int
          vCPUsPerCore: int
        }
      }
      licenseType: 'string'
      networkProfile: {
        healthProbe: {
          id: 'string'
        }
        networkApiVersion: 'string'
        networkInterfaceConfigurations: [
          {
            name: 'string'
            properties: {
              deleteOption: 'string'
              disableTcpStateTracking: bool
              dnsSettings: {
                dnsServers: [
                  'string'
                ]
              }
              enableAcceleratedNetworking: bool
              enableFpga: bool
              enableIPForwarding: bool
              ipConfigurations: [
                {
                  name: 'string'
                  properties: {
                    applicationGatewayBackendAddressPools: [
                      {
                        id: 'string'
                      }
                    ]
                    applicationSecurityGroups: [
                      {
                        id: 'string'
                      }
                    ]
                    loadBalancerBackendAddressPools: [
                      {
                        id: 'string'
                      }
                    ]
                    loadBalancerInboundNatPools: [
                      {
                        id: 'string'
                      }
                    ]
                    primary: bool
                    privateIPAddressVersion: 'string'
                    publicIPAddressConfiguration: {
                      name: 'string'
                      properties: {
                        deleteOption: 'string'
                        dnsSettings: {
                          domainNameLabel: 'string'
                        }
                        idleTimeoutInMinutes: int
                        ipTags: [
                          {
                            ipTagType: 'string'
                            tag: 'string'
                          }
                        ]
                        publicIPAddressVersion: 'string'
                        publicIPPrefix: {
                          id: 'string'
                        }
                      }
                      sku: {
                        name: 'string'
                        tier: 'string'
                      }
                    }
                    subnet: {
                      id: 'string'
                    }
                  }
                }
              ]
              networkSecurityGroup: {
                id: 'string'
              }
              primary: bool
            }
          }
        ]
      }
      osProfile: {
        adminPassword: 'string'
        adminUsername: 'string'
        allowExtensionOperations: bool
        computerNamePrefix: 'string'
        customData: 'string'
        linuxConfiguration: {
          disablePasswordAuthentication: bool
          enableVMAgentPlatformUpdates: bool
          patchSettings: {
            assessmentMode: 'string'
            automaticByPlatformSettings: {
              rebootSetting: 'string'
            }
            patchMode: 'string'
          }
          provisionVMAgent: bool
          ssh: {
            publicKeys: [
              {
                keyData: 'string'
                path: 'string'
              }
            ]
          }
        }
        requireGuestProvisionSignal: bool
        secrets: [
          {
            sourceVault: {
              id: 'string'
            }
            vaultCertificates: [
              {
                certificateStore: 'string'
                certificateUrl: 'string'
              }
            ]
          }
        ]
        windowsConfiguration: {
          additionalUnattendContent: [
            {
              componentName: 'Microsoft-Windows-Shell-Setup'
              content: 'string'
              passName: 'OobeSystem'
              settingName: 'string'
            }
          ]
          enableAutomaticUpdates: bool
          enableVMAgentPlatformUpdates: bool
          patchSettings: {
            assessmentMode: 'string'
            automaticByPlatformSettings: {
              rebootSetting: 'string'
            }
            enableHotpatching: bool
            patchMode: 'string'
          }
          provisionVMAgent: bool
          timeZone: 'string'
          winRM: {
            listeners: [
              {
                certificateUrl: 'string'
                protocol: 'string'
              }
            ]
          }
        }
      }
      priority: 'string'
      scheduledEventsProfile: {
        osImageNotificationProfile: {
          enable: bool
          notBeforeTimeout: 'string'
        }
        terminateNotificationProfile: {
          enable: bool
          notBeforeTimeout: 'string'
        }
      }
      securityProfile: {
        encryptionAtHost: bool
        securityType: 'string'
        uefiSettings: {
          secureBootEnabled: bool
          vTpmEnabled: bool
        }
      }
      serviceArtifactReference: {
        id: 'string'
      }
      storageProfile: {
        dataDisks: [
          {
            caching: 'string'
            createOption: 'string'
            deleteOption: 'string'
            diskIOPSReadWrite: int
            diskMBpsReadWrite: int
            diskSizeGB: int
            lun: int
            managedDisk: {
              diskEncryptionSet: {
                id: 'string'
              }
              securityProfile: {
                diskEncryptionSet: {
                  id: 'string'
                }
                securityEncryptionType: 'string'
              }
              storageAccountType: 'string'
            }
            name: 'string'
            writeAcceleratorEnabled: bool
          }
        ]
        diskControllerType: 'string'
        imageReference: {
          communityGalleryImageId: 'string'
          id: 'string'
          offer: 'string'
          publisher: 'string'
          sharedGalleryImageId: 'string'
          sku: 'string'
          version: 'string'
        }
        osDisk: {
          caching: 'string'
          createOption: 'string'
          deleteOption: 'string'
          diffDiskSettings: {
            option: 'string'
            placement: 'string'
          }
          diskSizeGB: int
          image: {
            uri: 'string'
          }
          managedDisk: {
            diskEncryptionSet: {
              id: 'string'
            }
            securityProfile: {
              diskEncryptionSet: {
                id: 'string'
              }
              securityEncryptionType: 'string'
            }
            storageAccountType: 'string'
          }
          name: 'string'
          osType: 'string'
          vhdContainers: [
            'string'
          ]
          writeAcceleratorEnabled: bool
        }
      }
      userData: 'string'
    }
    zoneBalance: bool
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

屬性值

AdditionalCapabilities

名字 描述 價值
hibernationEnabled 啟用或停用 VM 上休眠功能的旗標。 bool
ultraSSDEnabled 旗標,可讓或停用在 VM 或 VMSS 上具有一或多個具有 UltraSSD_LRS記憶體帳戶類型的受控數據磁碟。 只有啟用此屬性,才能將具有記憶體帳戶類型的受控磁碟UltraSSD_LRS新增至虛擬機或虛擬機擴展集。 bool

AdditionalUnattendContent

名字 描述 價值
componentName 元件名稱。 目前,唯一允許的值是 Microsoft-Windows-Shell-Setup。 'Microsoft-Windows-Shell-Setup'
內容 指定新增至指定路徑和元件之 unattend.xml 檔案的 XML 格式化內容。 XML 必須小於 4KB,而且必須包含要插入之設定或功能的根元素。 字串
passName 傳遞名稱。 目前唯一允許的值是 OobeSystem。 'OobeSystem'
settingName 指定套用內容之設定的名稱。 可能的值為:FirstLogonCommands 和 AutoLogon。 'AutoLogon'
'FirstLogonCommands'

ApiEntityReference

名字 描述 價值
id 以 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... 格式的 ARM 資源標識符 字串

ApplicationProfile

名字 描述 價值
galleryApplications 指定應該提供給 VM/VMSS 的資源庫應用程式 VMGalleryApplication[]

AutomaticOSUpgradePolicy

名字 描述 價值
disableAutomaticRollback 是否應停用OS映像復原功能。 默認值為 false。 bool
enableAutomaticOSUpgrade 指出當較新版本的OS映像可用時,是否應該以滾動方式自動套用作業系統升級至擴展集實例。 默認值為 false。

如果 Windows 擴展集設為 true,enableAutomaticUpdates 會自動設定為 false,且無法設定為 true。
bool
useRollingUpgradePolicy 指出是否應在自動OS升級期間使用滾動升級原則。 默認值為 false。 如果未在 VMSS 上定義任何原則,自動 OS 升級將會回復為默認原則。 bool

AutomaticRepairsPolicy

名字 描述 價值
啟用 指定是否應在虛擬機擴展集上啟用自動修復。 默認值為 false。 bool
gracePeriod 由於 VM 上的狀態變更,自動修復暫停的時間量。 寬限時間會在狀態變更完成之後開始。 這有助於避免過早或意外修復。 持續時間應以 ISO 8601 格式指定。 允許的最小寬限期為 10 分鐘(PT10M),這也是預設值。 允許的寬限期上限為 90 分鐘(PT90M)。 字串
repairAction 將用於修復擴展集中狀況不良虛擬機的修復動作類型(取代、重新啟動、重新安裝映像)。 預設值為 replace。 'Reimage'
'Replace'
'Restart'

BillingProfile

名字 描述 價值
maxPrice 指定您願意為 Azure Spot VM/VMSS 付費的最高價格。 這個價格以美元為單位。

此價格會與 VM 大小的目前 Azure Spot 價格進行比較。 此外,價格會在建立/更新 Azure Spot VM/VMSS 時進行比較,只有在 maxPrice 大於目前的 Azure Spot 價格時,作業才會成功。

如果目前的 Azure Spot 價格超出建立 VM/VMSS 之後的 maxPrice,maxPrice 也會用於收回 Azure Spot VM/VMSS。

可能的值為:

- 任何大於零的十進位值。 範例:0.01538

-1 – 表示預設價格 up-to 隨選。

您可以將 maxPrice 設定為 -1,表示基於價格原因,不應收回 Azure Spot VM/VMSS。 此外,如果預設的最大價格不是由您提供,則為 -1。

API 版本下限:2019-03-01。
int

BootDiagnostics

名字 描述 價值
啟用 是否應在虛擬機上啟用開機診斷。 bool
storageUri 用來放置主控台輸出和螢幕快照的記憶體帳戶 URI。

如果在啟用開機診斷時未指定 storageUri,則會使用受控記憶體。
字串

CapacityReservationProfile

名字 描述 價值
capacityReservationGroup 指定容量保留群組資源標識符,該標識元應該用於配置已保留足夠容量的虛擬機或擴展集 VM 實例。 如需詳細資訊, https://aka.ms/CapacityReservation 請參閱 。 SubResource

DiagnosticsProfile

名字 描述 價值
bootDiagnostics 開機診斷是一項偵錯功能,可讓您檢視控制台輸出和螢幕快照來診斷 VM 狀態。
NOTE:如果指定 storageUri,請確定記憶體帳戶位於與 VM 相同的區域和訂用帳戶中。

您可以輕鬆地檢視主控台記錄的輸出。

Azure 也可讓您從 Hypervisor 查看 VM 的螢幕快照。
BootDiagnostics

DiffDiskSettings

名字 描述 價值
選擇 指定作業系統磁碟的暫時磁碟設定。 'Local'
放置 指定作業系統磁碟的暫時磁碟位置。

可能的值為:

CacheDisk

ResourceDisk

默認值:如果已針對 VM 大小設定快取Disk ,否則會使用 resourceDisk

請參閱 /azure/virtual-machines/windows/size 和 Linux VM 在 /azure/virtual-machines/linux/size 上 Windows VM 的 VM 大小檔,以檢查哪些 VM 大小會公開快取磁碟。
'CacheDisk'
'ResourceDisk'

DiskEncryptionSetParameters

名字 描述 價值
id 資源標識碼 字串

ExtendedLocation

名字 描述 價值
名字 擴充位置的名稱。 字串
類型 擴充位置的類型。 'EdgeZone'

ImageReference

名字 描述 價值
communityGalleryImageId 指定 vm 部署的社群資源庫映像唯一標識碼。 這可以從社群資源庫映像 GET 呼叫擷取。 字串
id 資源標識碼 字串
提供 指定用來建立虛擬機的平臺映像或市集映像供應專案。 字串
發行人 映像發行者。 字串
sharedGalleryImageId 指定 vm 部署的共享資源庫映像唯一標識碼。 這可以從共用資源庫映像 GET 呼叫擷取。 字串
sku 映像 SKU。 字串
版本 指定用來建立虛擬機的平臺映像或市集映像版本。 允許的格式為 Major.Minor.Build 或 'latest'。 主要、次要和組建是十進位數。 指定 'latest' 以在部署時間使用可用映像的最新版本。 即使您使用「最新」,即使有新版本可用,VM 映像也不會在部署時間之後自動更新。 請勿使用欄位 'version' 進行資源庫映射部署,資源庫映射應一律使用 'id' 字段進行部署,若要使用資源庫映射的 'latest' 版本,只要設定 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}' 字段,即可不使用版本輸入。 字串

KeyVaultSecretReference

名字 描述 價值
secretUrl 參考 Key Vault 中秘密的 URL。 字串 (必要)
sourceVault 包含秘密之 Key Vault 的相對 URL。 SubResource (必要)

LinuxConfiguration

名字 描述 價值
disablePasswordAuthentication 指定是否應停用密碼驗證。 bool
enableVMAgentPlatformUpdates 指出是否為Linux虛擬機啟用VMAgent平臺更新。 默認值為 false。 bool
patchSettings [預覽功能]指定與Linux上的VM客體修補相關的設定。 LinuxPatchSettings
provisionVMAgent 指出虛擬機器代理程式是否應該佈建在虛擬機上。

當要求本文中未指定此屬性時,預設行為是將它設定為 true。 這可確保 VM 代理程式已安裝在 VM 上,以便稍後將擴充功能新增至 VM。
bool
ssh 指定 Linux OS 的 SSH 金鑰組態。 SshConfiguration

LinuxPatchSettings

名字 描述 價值
assessmentMode 指定 IaaS 虛擬機的 VM 客體修補評估模式。

可能的值為:

ImageDefault - 您可以在虛擬機上控制修補程式評估的時間。

AutomaticByPlatform - 平台將觸發定期修補程序評估。 屬性 provisionVMAgent 必須為 true。
'AutomaticByPlatform'
'ImageDefault'
automaticByPlatformSettings 在 Linux 上的 VM 客體修補中,指定修補程式模式 AutomaticByPlatform 的其他設定。 LinuxVMGuestPatchAutomaticByPlatformSettings
patchMode 將 VM 客體修補模式指定為彈性的 IaaS 虛擬機或與虛擬機擴展集相關聯的虛擬機。

可能的值為:

ImageDefault - 會使用虛擬機的預設修補組態。

AutomaticByPlatform - 虛擬機將由平台自動更新。 屬性 provisionVMAgent 必須為 true
'AutomaticByPlatform'
'ImageDefault'

LinuxVMGuestPatchAutomaticByPlatformSettings

名字 描述 價值
rebootSetting 指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。 'Always'
'IfRequired'
'Never'
'Unknown'

Microsoft.Compute/virtualMachineScaleSets

名字 描述 價值
extendedLocation 虛擬機擴展集的擴充位置。 ExtendedLocation
身份 如果已設定,則為虛擬機擴展集的身分識別。 VirtualMachineScaleSetIdentity
位置 資源位置 字串 (必要)
名字 資源名稱 字串 (必要)
計劃 指定用來建立虛擬機之 Marketplace 映像的相關信息。 此元素僅用於市集映像。 您必須先啟用映像以程序設計方式使用,才能從 API 使用市集映射。 在 Azure 入口網站中,尋找您想要使用的市集映像,然後按兩下 [想要以程序設計方式部署]、[開始使用] ->。 輸入任何必要資訊,然後按下 [儲存] 計劃
性能 描述虛擬機擴展集的屬性。 VirtualMachineScaleSetProperties
sku 虛擬機擴展集 SKU。 Sku
標籤 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤
虛擬機擴展集區域。 注意:只有在建立擴展集時,才能設定可用性區域 string[]

OSImageNotificationProfile

名字 描述 價值
使 指定是否啟用或停用OS映像排程事件。 bool
notBeforeTimeout 虛擬機重新映像或升級其操作系統的時間長度,在事件自動核准之前,必須核准OS映射排程事件(逾時)。 設定是以 ISO 8601 格式指定,且值必須是 15 分鐘(PT15M) 字串

PatchSettings

名字 描述 價值
assessmentMode 指定 IaaS 虛擬機的 VM 客體修補評估模式。

可能的值為:

ImageDefault - 您可以在虛擬機上控制修補程式評估的時間。

AutomaticByPlatform - 平台將觸發定期修補程序評估。 屬性 provisionVMAgent 必須為 true。
'AutomaticByPlatform'
'ImageDefault'
automaticByPlatformSettings 指定 Windows 上 VM 客體修補中的 Patch 模式 AutomaticByPlatform 的其他設定。 WindowsVMGuestPatchAutomaticByPlatformSettings
enableHotpatching 可讓客戶修補其 Azure VM,而不需要重新啟動。 針對 enableHotpatching,'provisionVMAgent' 必須設定為 true,且 'patchMode' 必須設定為 'AutomaticByPlatform'。 bool
patchMode 將 VM 客體修補模式指定為彈性的 IaaS 虛擬機或與虛擬機擴展集相關聯的虛擬機。

可能的值為:

手動 - 您可以控制將修補程式的應用程式套用至虛擬機。 您可以手動在 VM 內套用修補程式來執行此動作。 在此模式中,會停用自動更新;屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 false

AutomaticByOS - 作業系統會自動更新虛擬機。 屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 true。

AutomaticByPlatform - 虛擬機會由平台自動更新。 provisionVMAgent 和 WindowsConfiguration.enableAutomaticUpdates 的屬性必須是 true
'AutomaticByOS'
'AutomaticByPlatform'
'Manual'

計劃

名字 描述 價值
名字 方案標識碼。 字串
產品 指定來自市集的映像產品。 這個值與 imageReference 元素下的 Offer 值相同。 字串
promotionCode 促銷碼。 字串
發行人 發行者標識碼。 字串

PriorityMixPolicy

名字 描述 價值
baseRegularPriorityCount 將在此擴展集中建立之一般優先順序 VM 的基數,因為它會相應放大。 int

約束:
最小值 = 0
regularPriorityPercentageAboveBase 達到基底一般優先順序計數之後,VM 實例的百分比預期會使用一般優先順序。 int

約束:
最小值 = 0
最大值 = 100

PublicIPAddressSku

名字 描述 價值
名字 指定公用IP SKU 名稱 'Basic'
'Standard'
指定公用IP SKU層 'Global'
'地區'

ResourceTags

名字 描述 價值

RollingUpgradePolicy

名字 描述 價值
enableCrossZoneUpgrade 允許 VMSS 在建構升級批次時忽略 AZ 界限。 將 Update 網域和 maxBatchInstancePercent 納入考慮,以判斷批次大小。 bool
maxBatchInstancePercent 一個批次中滾動升級同時升級的虛擬機實例總數上限百分比。 由於這是最大值,先前或未來批次中狀況不良的實例可能會導致批次中的實例百分比降低,以確保更高的可靠性。 此參數預設值為 20%。 int

約束:
最小值 = 5
最大值 = 100
maxSurge 建立新的虛擬機來升級擴展集,而不是更新現有的虛擬機。 建立每個批次的新虛擬機之後,將會刪除現有的虛擬機。 bool
maxUnhealthyInstancePercent 擴展集中可同時狀況不良的虛擬機實例總數百分比上限,可能是因為升級而造成狀況不良,或在滾動升級中止之前,在虛擬機健康情況檢查中發現狀況不良狀態。 啟動任何批次之前,會先檢查此條件約束。 此參數預設值為 20%。 int

約束:
最小值 = 5
最大值 = 100
maxUnhealthyUpgradedInstancePercent 可發現處於狀況不良狀態的已升級虛擬機實例百分比上限。 升級每個批次之後,就會進行這項檢查。 如果超過這個百分比,滾動更新就會中止。 此參數預設值為 20%。 int

約束:
最小值 = 0
最大值 = 100
pauseTimeBetweenBatches 完成一個批次中所有虛擬機的更新,以及開始下一個批次之間的等候時間。 持續時間應以 ISO 8601 格式指定。 預設值為 0 秒(PT0S)。 字串
prioritizeUnhealthyInstances 在任何狀況良好的實例之前,升級擴展集中所有狀況不良的實例。 bool
rollbackFailedInstancesOnPolicyBreach 如果違反滾動升級原則,回復實例至先前的模型。 bool

ScaleInPolicy

名字 描述 價值
forceDeletion 此屬性可讓您指定在虛擬機擴展集相應縮小時,是否必須強制刪除選擇移除的虛擬機。(預覽中的功能) bool
規則 調整虛擬機擴展集時要遵循的規則。

可能的值為:

預設 當虛擬機擴展集相應縮小時,如果擴展集是區域性擴展集,則擴展集會先跨區域平衡。 然後,它會盡可能跨容錯網域進行平衡。 在每個容錯網域內,選擇移除的虛擬機將會是不受相應縮小保護的最新虛擬機。

OldestVM 當虛擬機擴展集相應縮小時,將會選擇未受相應縮小保護的最舊虛擬機進行移除。 針對區域性虛擬機擴展集,擴展集會先跨區域進行平衡。 在每個區域內,將會選擇未受保護的最舊虛擬機來移除。

NewestVM 當虛擬機擴展集相應縮小時,將會選擇未受相應縮小保護的最新虛擬機來移除。 針對區域性虛擬機擴展集,擴展集會先跨區域進行平衡。 在每個區域內,將會選擇未受保護的最新虛擬機來移除。

包含任何的字串數組:
'Default'
'NewestVM'
'OldestVM'

ScheduledEventsProfile

名字 描述 價值
osImageNotificationProfile 指定OS映像排程事件相關組態。 OSImageNotificationProfile
terminateNotificationProfile 指定終止已排程的事件相關組態。 TerminateNotificationProfile

SecurityProfile

名字 描述 價值
encryptionAtHost 用戶可以在要求中使用這個屬性來啟用或停用虛擬機或虛擬機擴展集的主機加密。 這會啟用所有磁碟的加密,包括主機本身的資源/暫存磁碟。

默認值:除非資源將此屬性設定為 true,否則將會停用主機的加密。
bool
securityType 指定虛擬機的 SecurityType。 它必須設定為任何指定的值,才能啟用 UefiSettings。

默認值:除非設定此屬性,否則不會啟用 UefiSettings。
'ConfidentialVM'
'TrustedLaunch'
uefiSettings 指定建立虛擬機時所使用的安全開機和 vTPM 等安全性設定。

API 版本下限:2020-12-01
UefiSettings

ServiceArtifactReference

名字 描述 價值
id 服務成品參考標識符的格式為 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} 字串

Sku

名字 描述 價值
能力 指定擴展集中的虛擬機數目。 int
名字 SKU 名稱。 字串
指定擴展集中虛擬機的層級。

可能的值:

Standard

基本
字串

SpotRestorePolicy

名字 描述 價值
啟用 啟用 Spot-Try-Restore 功能,其中將嘗試根據容量可用性和定價限制,以機會方式還原收回的 VMSS SPOT 實例 bool
restoreTimeout 以 ISO 8601 時間持續時間表示的逾時值,之後平臺不會嘗試還原 VMSS SPOT 實例 字串

SshConfiguration

名字 描述 價值
publicKeys 用來向Linux型VM進行驗證的SSH公鑰清單。 SshPublicKey[]

SshPublicKey

名字 描述 價值
keyData 用來透過 ssh 向 VM 進行驗證的 SSH 公鑰憑證。 密鑰至少必須是 2048 位,且格式為 ssh-rsa。

如需建立 ssh 金鑰,請參閱 [在 Azure 中建立 Linux 和 Mac 上的 SSH 密鑰]/azure/virtual-machines/linux/create-ssh-keys-detailed。
字串
路徑 指定已建立 VM 上儲存 SSH 公鑰的完整路徑。 如果檔案已經存在,指定的索引鍵會附加至檔案。 範例:/home/user/.ssh/authorized_keys 字串

SubResource

名字 描述 價值
id 資源標識碼 字串

TerminateNotificationProfile

名字 描述 價值
使 指定是否啟用或停用終止排程事件。 bool
notBeforeTimeout 刪除虛擬機的可設定時間長度,在事件自動核准之前,必須先核准終止排程事件(逾時)。 設定必須以 ISO 8601 格式指定,預設值為 5 分鐘(PT5M) 字串

UefiSettings

名字 描述 價值
secureBootEnabled 指定是否應在虛擬機上啟用安全開機。

API 版本下限:2020-12-01
bool
vTpmEnabled 指定是否應在虛擬機上啟用 vTPM。

API 版本下限:2020-12-01
bool

UpgradePolicy

名字 描述 價值
automaticOSUpgradePolicy 用於執行自動OS升級的組態參數。 AutomaticOSUpgradePolicy
模式 指定升級至擴展集中虛擬機的模式。

可能的值為:

手動 - 您可以控制擴充集中虛擬機的更新應用程式。 您可以使用 manualUpgrade 動作來執行此動作。

自動 - 擴展集中的所有虛擬機都會同時自動更新。
'Automatic'
'Manual'
'滾動'
rollingUpgradePolicy 執行滾動升級時所使用的組態參數。 RollingUpgradePolicy

UserAssignedIdentities

名字 描述 價值

UserAssignedIdentitiesValue

名字 描述 價值

VaultCertificate

名字 描述 價值
certificateStore 針對 Windows VM,指定應新增憑證之虛擬機上的證書存儲。 指定的證書存儲隱含在 LocalMachine 帳戶中。

針對 Linux VM,憑證檔案會放在 /var/lib/waagent 目錄底下,檔名 <X509 憑證檔案的大寫Thumbprint>.crt,並針對私鑰 <大寫Thumbprint>.prv。 這兩個檔案都是 .pem 格式。
字串
certificateUrl 這是已上傳至 Key Vault 做為秘密之憑證的 URL。 如需將秘密新增至 Key Vault,請參閱 將金鑰或秘密新增至金鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼,其編碼方式為 UTF-8:

{
“data”:“<Base64 編碼憑證>”,
“dataType”:“pfx”,
“password”:“<pfx-file-password>”
}
若要在虛擬機上安裝憑證,建議使用適用於Linux 的 Azure Key Vault 虛擬機擴充功能,或適用於Windows的 Azure Key Vault 虛擬機擴充功能。
字串

VaultSecretGroup

名字 描述 價值
sourceVault Key Vault 的相對 URL,其中包含 VaultCertificates 中的所有憑證。 SubResource
vaultCertificates SourceVault 中包含憑證的金鑰保存庫參考清單。 VaultCertificate[]

VirtualHardDisk

名字 描述 價值
uri 指定虛擬硬碟的 URI。 字串

VirtualMachineScaleSetDataDisk

名字 描述 價值
緩存 指定快取需求。

可能的值為:



ReadOnly

ReadWrite

預設值:標準記憶體 None。進階記憶體的 ReadOnly
'None'
'ReadOnly'
'ReadWrite'
createOption create 選項。 'Attach'
'Empty'
'FromImage' (必要)
deleteOption 指定數據磁碟應該在 VMSS Flex 刪除時刪除或中斷連結(此功能僅適用於具有彈性 OrchestrationMode 的 VMSS)。

可能的值:

刪除 如果使用此值,則會在刪除 VMSS Flex VM 時刪除資料磁碟。

卸離 如果使用此值,則會在刪除 VMSS Flex VM 之後保留數據磁碟。

預設值設定為 Delete
'Delete'
'Detach'
diskIOPSReadWrite 指定受控磁碟 Read-Write IOPS。 只有當 StorageAccountType UltraSSD_LRS時,才應該使用。 如果未指定,則會根據diskSizeGB指派預設值。 int
diskMBpsReadWrite 指定受控磁碟每秒 MB 的頻寬。 只有當 StorageAccountType UltraSSD_LRS時,才應該使用。 如果未指定,則會根據diskSizeGB指派預設值。 int
diskSizeGB 指定以 GB 為單位的空白資料磁碟大小。 這個元素可用來覆寫虛擬機映像中的磁碟大小。

diskSizeGB 是磁碟的位元組數 x 1024^3,值不能大於 1023
int
指定數據磁碟的邏輯單元編號。 這個值是用來識別 VM 內的數據磁碟,因此對於連結至 VM 的每個數據磁碟而言都必須是唯一的。 int (必要)
managedDisk 受控磁碟參數。 VirtualMachineScaleSetManagedDiskParameters
名字 磁碟名稱。 字串
writeAcceleratorEnabled 指定是否應該在磁碟上啟用或停用 writeAccelerator。 bool

VirtualMachineScaleSetExtension

名字 描述 價值
名字 延伸模組的名稱。 字串
性能 描述虛擬機擴展集擴充功能的屬性。 VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProfile

名字 描述 價值
擴展 虛擬機擴展集子擴充功能資源。 VirtualMachineScaleSetExtension[]
extensionsTimeBudget 指定所有延伸模組要啟動的時間。 持續時間應介於 15 分鐘到 120 分鐘之間(含),且應以 ISO 8601 格式指定。 預設值為90分鐘(PT1H30M)。

API 版本下限:2020-06-01
字串

VirtualMachineScaleSetExtensionProperties

名字 描述 價值
autoUpgradeMinorVersion 指出如果部署期間有新的次要版本,擴充功能是否應該使用較新的次要版本。 不過,部署之後,除非重新部署,否則擴充功能不會升級次要版本,即使此屬性設定為 true 也一定會升級。 bool
enableAutomaticUpgrade 指出如果有較新版本的延伸模組可用,平臺是否應該自動升級延伸模組。 bool
forceUpdateTag 如果提供值,且與先前的值不同,即使延伸模組組態尚未變更,擴充處理程式仍會強制更新。 字串
protectedSettings 延伸模組可以包含 protectedSettings 或 protectedSettingsFromKeyVault 或完全沒有受保護的設定。 任何
protectedSettingsFromKeyVault 以傳址方式傳遞的延伸模組受保護設定,並從金鑰保存庫取用 KeyVaultSecretReference
provisionAfterExtensions 必須布建此延伸模組之後的延伸模組名稱集合。 string[]
發行人 擴充處理程序發行者的名稱。 字串
設置 擴充功能的 Json 格式化公用設定。 任何
suppressFailures 指出延伸模組產生的失敗是否會隱藏(不論此值為何,無法連線到 VM 等作業失敗)。 默認值為 false。 bool
類型 指定延伸模組的類型;例如“CustomScriptExtension”。 字串
typeHandlerVersion 指定文稿處理程式的版本。 字串

VirtualMachineScaleSetHardwareProfile

名字 描述 價值
vmSizeProperties 指定自定義虛擬機大小的屬性。 API 版本下限:2021-11-01。

如需詳細資訊,請遵循 VM 自定義 中的指示。
VMSizeProperties

VirtualMachineScaleSetIdentity

名字 描述 價值
類型 用於虛擬機擴展集的身分識別類型。 類型 'SystemAssigned, UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。 類型 『None』 會從虛擬機擴展集移除任何身分識別。 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities 與虛擬機擴展集相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 UserAssignedIdentities

VirtualMachineScaleSetIPConfiguration

名字 描述 價值
名字 IP 組態名稱。 字串 (必要)
性能 描述虛擬機擴展集網路配置檔的IP組態屬性。 VirtualMachineScaleSetIPConfigurationProperties

VirtualMachineScaleSetIPConfigurationProperties

名字 描述 價值
applicationGatewayBackendAddressPools 指定應用程式閘道後端位址池的參考數位。 擴展集可以參考多個應用程式閘道的後端位址池。 多個擴展集無法使用相同的應用程式閘道。 SubResource[]
applicationSecurityGroups 指定應用程式安全組參考的陣列。 SubResource[]
loadBalancerBackendAddressPools 指定負載平衡器後端位址池的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的後端位址池。 多個擴展集無法使用相同的基本 SKU 負載平衡器。 SubResource[]
loadBalancerInboundNatPools 指定負載平衡器輸入 Nat 集區的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的輸入 nat 集區。 多個擴展集無法使用相同的基本 SKU 負載平衡器。 SubResource[]
主要 指定虛擬機有1個以上的網路介面時的主要網路介面。 bool
privateIPAddressVersion 從 Api-Version 2017-03-30 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 'IPv4'
'IPv6'
publicIPAddressConfiguration publicIPAddressConfiguration。 VirtualMachineScaleSetPublicIPAddressConfiguration
指定子網的識別碼。 ApiEntityReference

VirtualMachineScaleSetIpTag

名字 描述 價值
ipTagType IP 標籤類型。 範例:FirstPartyUsage。 字串
標記 與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 字串

VirtualMachineScaleSetManagedDiskParameters

名字 描述 價值
diskEncryptionSet 指定受控磁碟的客戶受控磁碟加密集資源標識符。 DiskEncryptionSetParameters
securityProfile 指定受控磁碟的安全性配置檔。 VMDiskSecurityProfile
storageAccountType 指定受控磁碟的記憶體帳戶類型。 注意:UltraSSD_LRS只能與數據磁碟搭配使用,因此無法與OS磁碟搭配使用。 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

VirtualMachineScaleSetNetworkConfiguration

名字 描述 價值
名字 網路組態名稱。 字串 (必要)
性能 描述虛擬機擴展集網路配置檔的IP組態。 VirtualMachineScaleSetNetworkConfigurationProperties

VirtualMachineScaleSetNetworkConfigurationDnsSettings

名字 描述 價值
dnsServers DNS 伺服器 IP 位址清單 string[]

VirtualMachineScaleSetNetworkConfigurationProperties

名字 描述 價值
deleteOption 指定刪除 VM 時網路介面會發生什麼事 'Delete'
'Detach'
disableTcpStateTracking 指定是否停用 tcp 狀態追蹤的網路介面。 bool
dnsSettings 要套用在網路介面上的 DNS 設定。 VirtualMachineScaleSetNetworkConfigurationDnsSettings
enableAcceleratedNetworking 指定網路介面是否已啟用加速網路功能。 bool
enableFpga 指定網路介面是否已啟用 FPGA 網路功能。 bool
enableIPForwarding 是否在此 NIC 上啟用 IP 轉送。 bool
ipConfigurations 指定網路介面的IP組態。 VirtualMachineScaleSetIPConfiguration[] (必要)
networkSecurityGroup 網路安全組。 SubResource
主要 指定虛擬機有1個以上的網路介面時的主要網路介面。 bool

VirtualMachineScaleSetNetworkProfile

名字 描述 價值
healthProbe 負載平衡器探查的參考,用來判斷虛擬機擴展集中實例的健康情況。 參考的格式為:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}'。 ApiEntityReference
networkApiVersion 會指定在具有協調流程模式 「彈性」的虛擬機擴展集網路介面組態中建立網路資源時所使用的Microsoft.Network API 版本 '2020-11-01'
networkInterfaceConfigurations 網路組態的清單。 VirtualMachineScaleSetNetworkConfiguration[]

VirtualMachineScaleSetOSDisk

名字 描述 價值
緩存 指定快取需求。

可能的值為:



ReadOnly

ReadWrite

預設值:標準記憶體 None。進階記憶體的 ReadOnly
'None'
'ReadOnly'
'ReadWrite'
createOption 指定應該如何建立擴展集中的虛擬機。

唯一允許的值是:FromImage \u2013 當您使用映像來建立虛擬機時,會使用此值。 如果您使用平臺映像,則也會使用上述的 imageReference 元素。 如果您使用市集映像,則也會使用先前所述的 plan 元素。
'Attach'
'Empty'
'FromImage' (必要)
deleteOption 指定 VMSS Flex 刪除時是否應該刪除或中斷連結 OS 磁碟(此功能僅適用於具有彈性 OrchestrationMode 的 VMSS)。

可能的值:

刪除 如果使用此值,刪除 VMSS Flex VM 時會刪除 OS 磁碟。

卸離 如果使用此值,則會在刪除 VMSS Flex VM 之後保留 OS 磁碟。

預設值設定為 Delete。 針對暫時 OS 磁碟,預設值會設定為 [刪除]。 使用者無法變更暫時 OS 磁碟的刪除選項。
'Delete'
'Detach'
diffDiskSettings 指定虛擬機擴展集所使用作業系統磁碟的暫時磁碟設定。 DiffDiskSettings
diskSizeGB 指定以 GB 為單位的空白資料磁碟大小。 這個元素可用來覆寫虛擬機映像中的磁碟大小。

diskSizeGB 是磁碟的位元組數 x 1024^3,值不能大於 1023
int
圖像 指定要以擴展集為基礎之 Unmanaged 使用者映像的相關信息。 VirtualHardDisk
managedDisk 受控磁碟參數。 VirtualMachineScaleSetManagedDiskParameters
名字 磁碟名稱。 字串
osType 此屬性可讓您指定從使用者映像或特製化 VHD 建立 VM 時,磁碟包含的 OS 類型。

可能的值為:

Windows

Linux
'Linux'
'Windows'
vhdContainers 指定用來儲存擴展集作業系統磁碟的容器 URL。 string[]
writeAcceleratorEnabled 指定是否應該在磁碟上啟用或停用 writeAccelerator。 bool

VirtualMachineScaleSetOSProfile

名字 描述 價值
adminPassword 指定系統管理員帳戶的密碼。

最小長度 (Windows): 8 個字元

最小長度 (Linux): 6 個字元

長度上限 (Windows): 123 個字元

長度上限(Linux): 72 個字元

複雜性需求:需要滿足下列 4 個條件中的 3 個
字元較低
具有大字元
具有數位
具有特殊字元 (Regex match [\W_])

不允許的值: “abc@123”、“P@$$w 0rd”、“P@ssw0rd”、“P@ssword123”、“Pa$$word”、“pass@word1”、“Password!”、“Password1”、“Password22”、“iloveyou!”

如需重設密碼,請參閱 如何在 Windows VM 中重設遠端桌面服務或其登入密碼

如需重設根密碼,請參閱 使用 VMAccess 擴充功能 管理使用者、SSH 及檢查或修復 Azure Linux VM 上的磁碟
字串

約束:
敏感性值。 以安全參數的形式傳入。
adminUsername 指定系統管理員帳戶的名稱。

僅限 Windows 的限制: 不能以 “” 結尾。

不允許的值: “administrator”、“admin”、“user”、“user1”、“test”、“user2”、“test1”、“user3”、“admin1”、“1” “123”、“a”、“actuser”、“adm”、“admin2”、“aspnet”、“backup”、“console”、“david”、“guest”、“john”、“owner”、“root”、“server”、“sql”、“support”、“support_388945a0”、“sys”、“test2”、“test3”、“user4”、“user5”。

最小長度 (Linux): 1 個字元

最大長度 (Linux): 64 個字元

長度上限 (Windows): 20 個字元
字串
allowExtensionOperations 指定虛擬機擴展集上是否應該允許擴充功能作業。

只有在虛擬機擴展集上沒有擴充功能時,才會將此選項設定為 False。
bool
computerNamePrefix 指定擴展集中所有虛擬機的計算機名稱前置詞。 計算機名稱前置詞長度必須為1到15個字元。 字串
customData 指定自訂數據的base-64編碼字串。 base-64 編碼字串會譯碼為儲存為虛擬機上檔案的二進位數組。 二進位陣列的最大長度為65535個字節。

如需針對 VM 使用 cloud-init,請參閱在建立期間使用 cloud-init 自定義 Linux VM
字串
linuxConfiguration 指定虛擬機上的Linux作業系統設定。

如需支援的 Linux 發行版清單,請參閱 Azure-Endorsed 發行版上的 Linux
LinuxConfiguration
requireGuestProvisionSignal 必須設定為 True 或省略的選擇性屬性。 bool
秘密 指定應該安裝在擴展集中虛擬機上的憑證集。 若要在虛擬機上安裝憑證,建議使用適用於Linux 的 Azure Key Vault 虛擬機擴充功能,或適用於Windows的 Azure Key Vault 虛擬機擴充功能。 VaultSecretGroup[]
windowsConfiguration 指定虛擬機上的 Windows 作業系統設定。 WindowsConfiguration

VirtualMachineScaleSetProperties

名字 描述 價值
additionalCapabilities 指定在虛擬機擴展集的虛擬機上啟用或停用的其他功能。 例如:虛擬機是否能夠支援使用UltraSSD_LRS記憶體帳戶類型鏈接受控數據磁碟。 AdditionalCapabilities
automaticRepairsPolicy 自動修復的原則。 AutomaticRepairsPolicy
constrainedMaximumCapacity 必須設定為 True 或省略的選擇性屬性。 bool
doNotRunExtensionsOnOverprovisionedVMs 啟用 Overprovision 時,只會在最後保留的要求 VM 數目上啟動擴充功能。 因此,這個屬性可確保延伸模組不會在額外的過度布建 VM 上執行。 bool
hostGroup 指定虛擬機擴展集所在專用主機群組的相關信息。

API 版本下限:2020-06-01。
SubResource
orchestrationMode 指定虛擬機擴展集的協調流程模式。 '彈性'
'Uniform'
overprovision 指定虛擬機擴展集是否應該過度布建。 bool
platformFaultDomainCount 每個放置群組的容錯網域計數。 int
priorityMixPolicy 指定在相同 VMSS Flex 實例內混合 Spot 和一般優先順序 VM 所需的目標。 PriorityMixPolicy
proximityPlacementGroup 指定應該指派虛擬機擴展集之鄰近放置群組的相關信息。

API 版本下限:2018-04-01。
SubResource
scaleInPolicy 指定在虛擬機擴展集中調整虛擬機時所套用的原則。 ScaleInPolicy
singlePlacementGroup 若為 true,這會將擴展集限制為單一放置群組,大小上限為 100 部虛擬機。 注意:如果 singlePlacementGroup 為 true,它可能會修改為 false。 不過,如果 singlePlacementGroup 為 false,它可能不會修改為 true。 bool
spotRestorePolicy 指定虛擬機擴展集的Spot Restore 屬性。 SpotRestorePolicy
upgradePolicy 升級原則。 UpgradePolicy
virtualMachineProfile 虛擬機器配置檔。 VirtualMachineScaleSetVMProfile
zoneBalance 如果發生區域中斷,是否要強制甚至虛擬機散發跨 x 區域。 只有在擴展集的區域屬性包含多個區域時,才能設定 zoneBalance 屬性。 如果沒有區域或只有一個指定區域,則不應該設定 zoneBalance 屬性。 bool

VirtualMachineScaleSetPublicIPAddressConfiguration

名字 描述 價值
名字 publicIP 位址組態名稱。 字串 (必要)
性能 描述虛擬機擴展集IP組態的PublicIPAddress組態 VirtualMachineScaleSetPublicIPAddressConfigurationProperties
sku 描述公用IP Sku。 它只能將 OrchestrationMode 設定為彈性。 PublicIPAddressSku

VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings

名字 描述 價值
domainNameLabel 功能變數名稱標籤。功能變數名稱標籤和 VM 索引的串連將是將要建立之 PublicIPAddress 資源的功能變數名稱標籤 字串 (必要)

VirtualMachineScaleSetPublicIPAddressConfigurationProperties

名字 描述 價值
deleteOption 指定刪除 VM 時,公用 IP 會發生什麼事 'Delete'
'Detach'
dnsSettings 要套用至 publicIP 位址的 DNS 設定。 VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings
idleTimeoutInMinutes 公用IP位址的閒置逾時。 int
ipTags 與公用IP位址相關聯的IP標籤清單。 VirtualMachineScaleSetIpTag[]
publicIPAddressVersion 從 Api-Version 2019-07-01 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 'IPv4'
'IPv6'
publicIPPrefix 要從中配置 publicIP 位址的 PublicIPPrefix。 SubResource

VirtualMachineScaleSetStorageProfile

名字 描述 價值
dataDisks 指定參數,用來將數據磁碟新增至擴展集中的虛擬機。

如需磁碟的詳細資訊,請參閱 關於 Azure 虛擬機器的磁碟和 VHD
VirtualMachineScaleSetDataDisk[]
diskControllerType 字串
imageReference 指定要使用之映像的相關信息。 您可以指定平臺映像、市集映像或虛擬機映像的相關信息。 當您想要使用平臺映像、市集映像或虛擬機映像,但未用於其他建立作業時,則需要此元素。 ImageReference
osDisk 指定擴展集中虛擬機所使用的操作系統磁碟相關信息。

如需磁碟的詳細資訊,請參閱 關於 Azure 虛擬機器的磁碟和 VHD
VirtualMachineScaleSetOSDisk

VirtualMachineScaleSetVMProfile

名字 描述 價值
applicationProfile 指定應該提供給 VM/VMSS 的資源庫應用程式 ApplicationProfile
billingProfile 指定 Azure Spot VMSS 的計費相關詳細數據。

API 版本下限:2019-03-01。
BillingProfile
capacityReservation 指定擴展集的容量保留相關詳細數據。

API 版本下限:2021-04-01。
CapacityReservationProfile
diagnosticsProfile 指定開機診斷設定狀態。

API 版本下限:2015-06-15。
DiagnosticsProfile
evictionPolicy 指定 Azure Spot 虛擬機和 Azure Spot 擴展集的收回原則。

針對 Azure Spot 虛擬機,支援「解除分配」和「刪除」,且最低 API 版本為 2019-03-01。

針對 Azure Spot 擴展集,支援「解除分配」和「刪除」,且最低 API 版本為 2017-10-30-preview。
'Deallocate'
'Delete'
extensionProfile 指定擴展集中虛擬機上所安裝延伸模組的設定集合。 VirtualMachineScaleSetExtensionProfile
hardwareProfile 指定擴展集的硬體配置檔相關詳細數據。

API 版本下限:2021-11-01。
VirtualMachineScaleSetHardwareProfile
licenseType 指定所使用的映像或磁碟已獲內部部署授權。

Windows Server 操作系統的可能值為:

Windows_Client

Windows_Server

Linux Server 操作系統的可能值為:

RHEL_BYOS (RHEL)

SLES_BYOS (適用於 SUSE)

如需詳細資訊,請參閱 適用於 Windows Server 的 Azure Hybrid Use Benefit

適用於Linux Server的 Azure Hybrid Use Benefit

API 版本下限:2015-06-15
字串
networkProfile 指定擴展集中虛擬機網路介面的屬性。 VirtualMachineScaleSetNetworkProfile
osProfile 指定擴展集中虛擬機的作業系統設定。 VirtualMachineScaleSetOSProfile
優先權 指定擴展集中虛擬機的優先順序。

最低 api-version:2017-10-30-preview
'Low'
'Regular'
'Spot'
scheduledEventsProfile 指定排程的事件相關組態。 ScheduledEventsProfile
securityProfile 指定擴展集中虛擬機的安全性相關配置檔設定。 SecurityProfile
serviceArtifactReference 指定使用 'latest' 映射版本時,用來為擴展集中所有虛擬機設定相同映像版本的服務成品參考標識符。 API 版本下限:2022-11-01 ServiceArtifactReference
storageProfile 指定虛擬機磁碟的記憶體設定。 VirtualMachineScaleSetStorageProfile
userData 擴展集中虛擬機的UserData,其必須是base-64編碼。 客戶不應在此傳遞任何秘密。

API 版本下限:2021-03-01
字串

VMDiskSecurityProfile

名字 描述 價值
diskEncryptionSet 針對客戶受控密鑰加密的機密VM OS 磁碟和 VMGuest Blob 所使用的受控磁碟,指定客戶受控磁碟加密集資源識別碼。 DiskEncryptionSetParameters
securityEncryptionType 指定受控磁碟的 EncryptionType。
它設定為 DiskWithVMGuestState 以加密受控磁碟以及 VMGuestState Blob,而 VMGuestStateOnly 則只會加密 VMGuestState Blob。

注意:只能針對機密 VM 進行設定。
'DiskWithVMGuestState'
'VMGuestStateOnly'

VMGalleryApplication

名字 描述 價值
configurationReference 選擇性,指定 Azure Blob 的 URI,如果提供的話,將會取代套件的預設組態 字串
enableAutomaticUpgrade 如果設定為 true,當 PIR/SIG 中提供新的資源庫應用程式版本時,VM/VMSS 會自動更新它 bool
次序 選擇性,指定必須安裝套件的順序 int
packageReferenceId 指定 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/applications/{application}/versions/{version} 形式的 GalleryApplicationVersion 資源標識符 字串 (必要)
標籤 選擇性,指定更多泛型內容的傳遞值。 字串
treatFailureAsDeploymentFailure 選擇性,如果為 true,VmApplication 中任何作業的任何失敗都會使部署失敗 bool

VMSizeProperties

名字 描述 價值
vCPUUsAvailable 指定 VM 可用的 vCPU 數目。

當要求本文中未指定此屬性時,預設行為是將它設定為 api 回應中公開的 vCPU 值,列出區域中所有可用的虛擬機大小
int
vCPUUsPerCore 指定 vCPU 與實體核心比率。

當要求本文中未指定此屬性時,預設行為會針對 api 回應中公開的 VM 大小設定為 vCPUUsPerCore 的值,列出區域中所有可用的虛擬機大小

將此屬性設定為 1 也表示已停用超線程處理。
int

WindowsConfiguration

名字 描述 價值
additionalUnattendContent 指定其他base-64編碼的 XML 格式資訊,這些資訊可以包含在 Windows 安裝程式所使用的 Unattend.xml 檔案中。 AdditionalUnattendContent[]
enableAutomaticUpdates 指出是否為 Windows 虛擬機啟用自動更新。 默認值為 true。

針對虛擬機擴展集,此屬性可以更新,更新將會在OS重新佈建上生效。
bool
enableVMAgentPlatformUpdates 指出是否為 Windows 虛擬機啟用 VMAgent 平臺更新。 默認值為 false。 bool
patchSettings [預覽功能]指定與 Windows 上的 VM 客體修補相關的設定。 PatchSettings
provisionVMAgent 指出虛擬機器代理程式是否應該佈建在虛擬機上。

當要求本文中未指定此屬性時,預設行為是將它設定為 true。 這可確保 VM 代理程式已安裝在 VM 上,以便稍後將擴充功能新增至 VM。
bool
timeZone 指定虛擬機的時區。 例如「太平洋標準時間」。

可能的值可以從 TimeZoneInfo.GetSystemTimeZones傳回的時區 TimeZoneInfo.Id 值。
字串
winRM 指定 Windows 遠端管理接聽程式。 這可啟用遠端 Windows PowerShell。 WinRMConfiguration

WindowsVMGuestPatchAutomaticByPlatformSettings

名字 描述 價值
rebootSetting 指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。 'Always'
'IfRequired'
'Never'
'Unknown'

WinRMConfiguration

名字 描述 價值
聽眾 Windows 遠端管理接聽程式清單 WinRMListener[]

WinRMListener

名字 描述 價值
certificateUrl 這是已上傳至 Key Vault 做為秘密之憑證的 URL。 如需將秘密新增至 Key Vault,請參閱 將金鑰或秘密新增至金鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼,其編碼方式為 UTF-8:

{
“data”:“<Base64 編碼憑證>”,
“dataType”:“pfx”,
“password”:“<pfx-file-password>”
}
若要在虛擬機上安裝憑證,建議使用適用於Linux 的 Azure Key Vault 虛擬機擴充功能,或適用於Windows的 Azure Key Vault 虛擬機擴充功能。
字串
協定 指定 WinRM 接聽程式的通訊協定。

可能的值為:
http

https
'Http'
'Https'

快速入門範例

下列快速入門範例會部署此資源類型。

Bicep 檔案 描述
Azure Game 開發人員虛擬機擴展集 Azure 遊戲開發人員虛擬機擴展集包含 Unreal 等授權引擎。
部署5節點安全叢集 此範本可讓您在Standard_D2_v2大小 VMSS 上部署執行 Windows Server 2019 Datacenter 的安全 5 節點 Service Fabric 叢集。
部署 Nextflow genomics 叢集 此範本會部署具有 Jumpbox、n 叢集節點、Docker 支援和共用記憶體的可調整 Nextflow 叢集。
部署支援受信任啟動的 Windows VM 擴展集 此範本可讓您使用最新修補版本的 Windows Server 2016、Windows Server 2019 或 Windows Server 2022 Azure Edition,部署支援信任啟動的 Windows VM 擴展集。 這些 VM 位於具有 RDP 連線 NAT 規則的負載平衡器後方。 如果您啟用 Secureboot 和 vTPM,客體證明擴充功能將會安裝在您的 VMSS 上。 此延伸模組會執行雲端的遠端 證明
使用 Windows VM 部署 VM 擴展集和自動調整 此範本可讓您使用最新修補版本的 Windows 2008-R2-SP1、2012-Datacenter 或 2012-R2-Datacenter 部署簡單的 Windows VM 擴展集。 這些 VM 位於具有 RDP 連線 NAT 規則的負載平衡器後方。 它們也有自動調整整合
部署 VMSS,將每個 VM 連線到 Azure 檔案記憶體共用 此範本會部署 Ubuntu 虛擬機擴展集,並使用自定義腳本擴充功能將每個 VM 連線到 Azure 檔案記憶體共用
使用 Azure 應用程式閘道部署 Windows VM 擴展集 此範本可讓您部署與 Azure 應用程式閘道整合的簡單 Windows VM 擴展集,並支援最多 1000 部 VM
使用 Python Bottle 伺服器部署 VM 擴展集 & 自動調整 在負載平衡器/NAT 後方部署 VM 擴展集,& 執行可運作的簡單 Python Bottle 應用程式的每個 VM。 設定自動調整擴展集時,會視需要相應放大 &
執行 IIS WebApp 的自動調整 VM 擴展集 部署執行 IIS 的 Windows VM 擴展集和非常基本的 .NET MVC Web 應用程式。 VMSS PowerShell DSC 擴充功能可用來執行 IIS 安裝和 WebDeploy 套件部署。
VMSS 彈性協調流程模式快速入門 Linux 此範本會部署具有 Azure Load Balancer 後方實例的簡單 VM 擴展集。 VM 擴展集處於彈性協調流程模式。 使用 os 參數來選擇 Linux (Ubuntu) 或 Windows (Windows Server Datacenter 2019) 部署。 注意:本快速入門範本可讓您從任何因特網位址存取 VM 管理埠(SSH、RDP),而且不應該用於生產部署。
具有公用IP前置詞的VMSS 使用公用IP前綴部署VMSS的範本

ARM 樣本資源定義

virtualMachineScaleSets 資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔

資源格式

若要建立 Microsoft.Compute/virtualMachineScaleSets 資源,請將下列 JSON 新增至範本。

{
  "type": "Microsoft.Compute/virtualMachineScaleSets",
  "apiVersion": "2022-11-01",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "plan": {
    "name": "string",
    "product": "string",
    "promotionCode": "string",
    "publisher": "string"
  },
  "properties": {
    "additionalCapabilities": {
      "hibernationEnabled": "bool",
      "ultraSSDEnabled": "bool"
    },
    "automaticRepairsPolicy": {
      "enabled": "bool",
      "gracePeriod": "string",
      "repairAction": "string"
    },
    "constrainedMaximumCapacity": "bool",
    "doNotRunExtensionsOnOverprovisionedVMs": "bool",
    "hostGroup": {
      "id": "string"
    },
    "orchestrationMode": "string",
    "overprovision": "bool",
    "platformFaultDomainCount": "int",
    "priorityMixPolicy": {
      "baseRegularPriorityCount": "int",
      "regularPriorityPercentageAboveBase": "int"
    },
    "proximityPlacementGroup": {
      "id": "string"
    },
    "scaleInPolicy": {
      "forceDeletion": "bool",
      "rules": [ "string" ]
    },
    "singlePlacementGroup": "bool",
    "spotRestorePolicy": {
      "enabled": "bool",
      "restoreTimeout": "string"
    },
    "upgradePolicy": {
      "automaticOSUpgradePolicy": {
        "disableAutomaticRollback": "bool",
        "enableAutomaticOSUpgrade": "bool",
        "useRollingUpgradePolicy": "bool"
      },
      "mode": "string",
      "rollingUpgradePolicy": {
        "enableCrossZoneUpgrade": "bool",
        "maxBatchInstancePercent": "int",
        "maxSurge": "bool",
        "maxUnhealthyInstancePercent": "int",
        "maxUnhealthyUpgradedInstancePercent": "int",
        "pauseTimeBetweenBatches": "string",
        "prioritizeUnhealthyInstances": "bool",
        "rollbackFailedInstancesOnPolicyBreach": "bool"
      }
    },
    "virtualMachineProfile": {
      "applicationProfile": {
        "galleryApplications": [
          {
            "configurationReference": "string",
            "enableAutomaticUpgrade": "bool",
            "order": "int",
            "packageReferenceId": "string",
            "tags": "string",
            "treatFailureAsDeploymentFailure": "bool"
          }
        ]
      },
      "billingProfile": {
        "maxPrice": "int"
      },
      "capacityReservation": {
        "capacityReservationGroup": {
          "id": "string"
        }
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "enabled": "bool",
          "storageUri": "string"
        }
      },
      "evictionPolicy": "string",
      "extensionProfile": {
        "extensions": [
          {
            "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"
            }
          }
        ],
        "extensionsTimeBudget": "string"
      },
      "hardwareProfile": {
        "vmSizeProperties": {
          "vCPUsAvailable": "int",
          "vCPUsPerCore": "int"
        }
      },
      "licenseType": "string",
      "networkProfile": {
        "healthProbe": {
          "id": "string"
        },
        "networkApiVersion": "string",
        "networkInterfaceConfigurations": [
          {
            "name": "string",
            "properties": {
              "deleteOption": "string",
              "disableTcpStateTracking": "bool",
              "dnsSettings": {
                "dnsServers": [ "string" ]
              },
              "enableAcceleratedNetworking": "bool",
              "enableFpga": "bool",
              "enableIPForwarding": "bool",
              "ipConfigurations": [
                {
                  "name": "string",
                  "properties": {
                    "applicationGatewayBackendAddressPools": [
                      {
                        "id": "string"
                      }
                    ],
                    "applicationSecurityGroups": [
                      {
                        "id": "string"
                      }
                    ],
                    "loadBalancerBackendAddressPools": [
                      {
                        "id": "string"
                      }
                    ],
                    "loadBalancerInboundNatPools": [
                      {
                        "id": "string"
                      }
                    ],
                    "primary": "bool",
                    "privateIPAddressVersion": "string",
                    "publicIPAddressConfiguration": {
                      "name": "string",
                      "properties": {
                        "deleteOption": "string",
                        "dnsSettings": {
                          "domainNameLabel": "string"
                        },
                        "idleTimeoutInMinutes": "int",
                        "ipTags": [
                          {
                            "ipTagType": "string",
                            "tag": "string"
                          }
                        ],
                        "publicIPAddressVersion": "string",
                        "publicIPPrefix": {
                          "id": "string"
                        }
                      },
                      "sku": {
                        "name": "string",
                        "tier": "string"
                      }
                    },
                    "subnet": {
                      "id": "string"
                    }
                  }
                }
              ],
              "networkSecurityGroup": {
                "id": "string"
              },
              "primary": "bool"
            }
          }
        ]
      },
      "osProfile": {
        "adminPassword": "string",
        "adminUsername": "string",
        "allowExtensionOperations": "bool",
        "computerNamePrefix": "string",
        "customData": "string",
        "linuxConfiguration": {
          "disablePasswordAuthentication": "bool",
          "enableVMAgentPlatformUpdates": "bool",
          "patchSettings": {
            "assessmentMode": "string",
            "automaticByPlatformSettings": {
              "rebootSetting": "string"
            },
            "patchMode": "string"
          },
          "provisionVMAgent": "bool",
          "ssh": {
            "publicKeys": [
              {
                "keyData": "string",
                "path": "string"
              }
            ]
          }
        },
        "requireGuestProvisionSignal": "bool",
        "secrets": [
          {
            "sourceVault": {
              "id": "string"
            },
            "vaultCertificates": [
              {
                "certificateStore": "string",
                "certificateUrl": "string"
              }
            ]
          }
        ],
        "windowsConfiguration": {
          "additionalUnattendContent": [
            {
              "componentName": "Microsoft-Windows-Shell-Setup",
              "content": "string",
              "passName": "OobeSystem",
              "settingName": "string"
            }
          ],
          "enableAutomaticUpdates": "bool",
          "enableVMAgentPlatformUpdates": "bool",
          "patchSettings": {
            "assessmentMode": "string",
            "automaticByPlatformSettings": {
              "rebootSetting": "string"
            },
            "enableHotpatching": "bool",
            "patchMode": "string"
          },
          "provisionVMAgent": "bool",
          "timeZone": "string",
          "winRM": {
            "listeners": [
              {
                "certificateUrl": "string",
                "protocol": "string"
              }
            ]
          }
        }
      },
      "priority": "string",
      "scheduledEventsProfile": {
        "osImageNotificationProfile": {
          "enable": "bool",
          "notBeforeTimeout": "string"
        },
        "terminateNotificationProfile": {
          "enable": "bool",
          "notBeforeTimeout": "string"
        }
      },
      "securityProfile": {
        "encryptionAtHost": "bool",
        "securityType": "string",
        "uefiSettings": {
          "secureBootEnabled": "bool",
          "vTpmEnabled": "bool"
        }
      },
      "serviceArtifactReference": {
        "id": "string"
      },
      "storageProfile": {
        "dataDisks": [
          {
            "caching": "string",
            "createOption": "string",
            "deleteOption": "string",
            "diskIOPSReadWrite": "int",
            "diskMBpsReadWrite": "int",
            "diskSizeGB": "int",
            "lun": "int",
            "managedDisk": {
              "diskEncryptionSet": {
                "id": "string"
              },
              "securityProfile": {
                "diskEncryptionSet": {
                  "id": "string"
                },
                "securityEncryptionType": "string"
              },
              "storageAccountType": "string"
            },
            "name": "string",
            "writeAcceleratorEnabled": "bool"
          }
        ],
        "diskControllerType": "string",
        "imageReference": {
          "communityGalleryImageId": "string",
          "id": "string",
          "offer": "string",
          "publisher": "string",
          "sharedGalleryImageId": "string",
          "sku": "string",
          "version": "string"
        },
        "osDisk": {
          "caching": "string",
          "createOption": "string",
          "deleteOption": "string",
          "diffDiskSettings": {
            "option": "string",
            "placement": "string"
          },
          "diskSizeGB": "int",
          "image": {
            "uri": "string"
          },
          "managedDisk": {
            "diskEncryptionSet": {
              "id": "string"
            },
            "securityProfile": {
              "diskEncryptionSet": {
                "id": "string"
              },
              "securityEncryptionType": "string"
            },
            "storageAccountType": "string"
          },
          "name": "string",
          "osType": "string",
          "vhdContainers": [ "string" ],
          "writeAcceleratorEnabled": "bool"
        }
      },
      "userData": "string"
    },
    "zoneBalance": "bool"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

屬性值

AdditionalCapabilities

名字 描述 價值
hibernationEnabled 啟用或停用 VM 上休眠功能的旗標。 bool
ultraSSDEnabled 旗標,可讓或停用在 VM 或 VMSS 上具有一或多個具有 UltraSSD_LRS記憶體帳戶類型的受控數據磁碟。 只有啟用此屬性,才能將具有記憶體帳戶類型的受控磁碟UltraSSD_LRS新增至虛擬機或虛擬機擴展集。 bool

AdditionalUnattendContent

名字 描述 價值
componentName 元件名稱。 目前,唯一允許的值是 Microsoft-Windows-Shell-Setup。 'Microsoft-Windows-Shell-Setup'
內容 指定新增至指定路徑和元件之 unattend.xml 檔案的 XML 格式化內容。 XML 必須小於 4KB,而且必須包含要插入之設定或功能的根元素。 字串
passName 傳遞名稱。 目前唯一允許的值是 OobeSystem。 'OobeSystem'
settingName 指定套用內容之設定的名稱。 可能的值為:FirstLogonCommands 和 AutoLogon。 'AutoLogon'
'FirstLogonCommands'

ApiEntityReference

名字 描述 價值
id 以 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... 格式的 ARM 資源標識符 字串

ApplicationProfile

名字 描述 價值
galleryApplications 指定應該提供給 VM/VMSS 的資源庫應用程式 VMGalleryApplication[]

AutomaticOSUpgradePolicy

名字 描述 價值
disableAutomaticRollback 是否應停用OS映像復原功能。 默認值為 false。 bool
enableAutomaticOSUpgrade 指出當較新版本的OS映像可用時,是否應該以滾動方式自動套用作業系統升級至擴展集實例。 默認值為 false。

如果 Windows 擴展集設為 true,enableAutomaticUpdates 會自動設定為 false,且無法設定為 true。
bool
useRollingUpgradePolicy 指出是否應在自動OS升級期間使用滾動升級原則。 默認值為 false。 如果未在 VMSS 上定義任何原則,自動 OS 升級將會回復為默認原則。 bool

AutomaticRepairsPolicy

名字 描述 價值
啟用 指定是否應在虛擬機擴展集上啟用自動修復。 默認值為 false。 bool
gracePeriod 由於 VM 上的狀態變更,自動修復暫停的時間量。 寬限時間會在狀態變更完成之後開始。 這有助於避免過早或意外修復。 持續時間應以 ISO 8601 格式指定。 允許的最小寬限期為 10 分鐘(PT10M),這也是預設值。 允許的寬限期上限為 90 分鐘(PT90M)。 字串
repairAction 將用於修復擴展集中狀況不良虛擬機的修復動作類型(取代、重新啟動、重新安裝映像)。 預設值為 replace。 'Reimage'
'Replace'
'Restart'

BillingProfile

名字 描述 價值
maxPrice 指定您願意為 Azure Spot VM/VMSS 付費的最高價格。 這個價格以美元為單位。

此價格會與 VM 大小的目前 Azure Spot 價格進行比較。 此外,價格會在建立/更新 Azure Spot VM/VMSS 時進行比較,只有在 maxPrice 大於目前的 Azure Spot 價格時,作業才會成功。

如果目前的 Azure Spot 價格超出建立 VM/VMSS 之後的 maxPrice,maxPrice 也會用於收回 Azure Spot VM/VMSS。

可能的值為:

- 任何大於零的十進位值。 範例:0.01538

-1 – 表示預設價格 up-to 隨選。

您可以將 maxPrice 設定為 -1,表示基於價格原因,不應收回 Azure Spot VM/VMSS。 此外,如果預設的最大價格不是由您提供,則為 -1。

API 版本下限:2019-03-01。
int

BootDiagnostics

名字 描述 價值
啟用 是否應在虛擬機上啟用開機診斷。 bool
storageUri 用來放置主控台輸出和螢幕快照的記憶體帳戶 URI。

如果在啟用開機診斷時未指定 storageUri,則會使用受控記憶體。
字串

CapacityReservationProfile

名字 描述 價值
capacityReservationGroup 指定容量保留群組資源標識符,該標識元應該用於配置已保留足夠容量的虛擬機或擴展集 VM 實例。 如需詳細資訊, https://aka.ms/CapacityReservation 請參閱 。 SubResource

DiagnosticsProfile

名字 描述 價值
bootDiagnostics 開機診斷是一項偵錯功能,可讓您檢視控制台輸出和螢幕快照來診斷 VM 狀態。
NOTE:如果指定 storageUri,請確定記憶體帳戶位於與 VM 相同的區域和訂用帳戶中。

您可以輕鬆地檢視主控台記錄的輸出。

Azure 也可讓您從 Hypervisor 查看 VM 的螢幕快照。
BootDiagnostics

DiffDiskSettings

名字 描述 價值
選擇 指定作業系統磁碟的暫時磁碟設定。 'Local'
放置 指定作業系統磁碟的暫時磁碟位置。

可能的值為:

CacheDisk

ResourceDisk

默認值:如果已針對 VM 大小設定快取Disk ,否則會使用 resourceDisk

請參閱 /azure/virtual-machines/windows/size 和 Linux VM 在 /azure/virtual-machines/linux/size 上 Windows VM 的 VM 大小檔,以檢查哪些 VM 大小會公開快取磁碟。
'CacheDisk'
'ResourceDisk'

DiskEncryptionSetParameters

名字 描述 價值
id 資源標識碼 字串

ExtendedLocation

名字 描述 價值
名字 擴充位置的名稱。 字串
類型 擴充位置的類型。 'EdgeZone'

ImageReference

名字 描述 價值
communityGalleryImageId 指定 vm 部署的社群資源庫映像唯一標識碼。 這可以從社群資源庫映像 GET 呼叫擷取。 字串
id 資源標識碼 字串
提供 指定用來建立虛擬機的平臺映像或市集映像供應專案。 字串
發行人 映像發行者。 字串
sharedGalleryImageId 指定 vm 部署的共享資源庫映像唯一標識碼。 這可以從共用資源庫映像 GET 呼叫擷取。 字串
sku 映像 SKU。 字串
版本 指定用來建立虛擬機的平臺映像或市集映像版本。 允許的格式為 Major.Minor.Build 或 'latest'。 主要、次要和組建是十進位數。 指定 'latest' 以在部署時間使用可用映像的最新版本。 即使您使用「最新」,即使有新版本可用,VM 映像也不會在部署時間之後自動更新。 請勿使用欄位 'version' 進行資源庫映射部署,資源庫映射應一律使用 'id' 字段進行部署,若要使用資源庫映射的 'latest' 版本,只要設定 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}' 字段,即可不使用版本輸入。 字串

KeyVaultSecretReference

名字 描述 價值
secretUrl 參考 Key Vault 中秘密的 URL。 字串 (必要)
sourceVault 包含秘密之 Key Vault 的相對 URL。 SubResource (必要)

LinuxConfiguration

名字 描述 價值
disablePasswordAuthentication 指定是否應停用密碼驗證。 bool
enableVMAgentPlatformUpdates 指出是否為Linux虛擬機啟用VMAgent平臺更新。 默認值為 false。 bool
patchSettings [預覽功能]指定與Linux上的VM客體修補相關的設定。 LinuxPatchSettings
provisionVMAgent 指出虛擬機器代理程式是否應該佈建在虛擬機上。

當要求本文中未指定此屬性時,預設行為是將它設定為 true。 這可確保 VM 代理程式已安裝在 VM 上,以便稍後將擴充功能新增至 VM。
bool
ssh 指定 Linux OS 的 SSH 金鑰組態。 SshConfiguration

LinuxPatchSettings

名字 描述 價值
assessmentMode 指定 IaaS 虛擬機的 VM 客體修補評估模式。

可能的值為:

ImageDefault - 您可以在虛擬機上控制修補程式評估的時間。

AutomaticByPlatform - 平台將觸發定期修補程序評估。 屬性 provisionVMAgent 必須為 true。
'AutomaticByPlatform'
'ImageDefault'
automaticByPlatformSettings 在 Linux 上的 VM 客體修補中,指定修補程式模式 AutomaticByPlatform 的其他設定。 LinuxVMGuestPatchAutomaticByPlatformSettings
patchMode 將 VM 客體修補模式指定為彈性的 IaaS 虛擬機或與虛擬機擴展集相關聯的虛擬機。

可能的值為:

ImageDefault - 會使用虛擬機的預設修補組態。

AutomaticByPlatform - 虛擬機將由平台自動更新。 屬性 provisionVMAgent 必須為 true
'AutomaticByPlatform'
'ImageDefault'

LinuxVMGuestPatchAutomaticByPlatformSettings

名字 描述 價值
rebootSetting 指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。 'Always'
'IfRequired'
'Never'
'Unknown'

Microsoft.Compute/virtualMachineScaleSets

名字 描述 價值
apiVersion API 版本 '2022-11-01'
extendedLocation 虛擬機擴展集的擴充位置。 ExtendedLocation
身份 如果已設定,則為虛擬機擴展集的身分識別。 VirtualMachineScaleSetIdentity
位置 資源位置 字串 (必要)
名字 資源名稱 字串 (必要)
計劃 指定用來建立虛擬機之 Marketplace 映像的相關信息。 此元素僅用於市集映像。 您必須先啟用映像以程序設計方式使用,才能從 API 使用市集映射。 在 Azure 入口網站中,尋找您想要使用的市集映像,然後按兩下 [想要以程序設計方式部署]、[開始使用] ->。 輸入任何必要資訊,然後按下 [儲存] 計劃
性能 描述虛擬機擴展集的屬性。 VirtualMachineScaleSetProperties
sku 虛擬機擴展集 SKU。 Sku
標籤 資源標籤 標記名稱和值的字典。 請參閱範本中的 標籤
類型 資源類型 'Microsoft.Compute/virtualMachineScaleSets'
虛擬機擴展集區域。 注意:只有在建立擴展集時,才能設定可用性區域 string[]

OSImageNotificationProfile

名字 描述 價值
使 指定是否啟用或停用OS映像排程事件。 bool
notBeforeTimeout 虛擬機重新映像或升級其操作系統的時間長度,在事件自動核准之前,必須核准OS映射排程事件(逾時)。 設定是以 ISO 8601 格式指定,且值必須是 15 分鐘(PT15M) 字串

PatchSettings

名字 描述 價值
assessmentMode 指定 IaaS 虛擬機的 VM 客體修補評估模式。

可能的值為:

ImageDefault - 您可以在虛擬機上控制修補程式評估的時間。

AutomaticByPlatform - 平台將觸發定期修補程序評估。 屬性 provisionVMAgent 必須為 true。
'AutomaticByPlatform'
'ImageDefault'
automaticByPlatformSettings 指定 Windows 上 VM 客體修補中的 Patch 模式 AutomaticByPlatform 的其他設定。 WindowsVMGuestPatchAutomaticByPlatformSettings
enableHotpatching 可讓客戶修補其 Azure VM,而不需要重新啟動。 針對 enableHotpatching,'provisionVMAgent' 必須設定為 true,且 'patchMode' 必須設定為 'AutomaticByPlatform'。 bool
patchMode 將 VM 客體修補模式指定為彈性的 IaaS 虛擬機或與虛擬機擴展集相關聯的虛擬機。

可能的值為:

手動 - 您可以控制將修補程式的應用程式套用至虛擬機。 您可以手動在 VM 內套用修補程式來執行此動作。 在此模式中,會停用自動更新;屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 false

AutomaticByOS - 作業系統會自動更新虛擬機。 屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 true。

AutomaticByPlatform - 虛擬機會由平台自動更新。 provisionVMAgent 和 WindowsConfiguration.enableAutomaticUpdates 的屬性必須是 true
'AutomaticByOS'
'AutomaticByPlatform'
'Manual'

計劃

名字 描述 價值
名字 方案標識碼。 字串
產品 指定來自市集的映像產品。 這個值與 imageReference 元素下的 Offer 值相同。 字串
promotionCode 促銷碼。 字串
發行人 發行者標識碼。 字串

PriorityMixPolicy

名字 描述 價值
baseRegularPriorityCount 將在此擴展集中建立之一般優先順序 VM 的基數,因為它會相應放大。 int

約束:
最小值 = 0
regularPriorityPercentageAboveBase 達到基底一般優先順序計數之後,VM 實例的百分比預期會使用一般優先順序。 int

約束:
最小值 = 0
最大值 = 100

PublicIPAddressSku

名字 描述 價值
名字 指定公用IP SKU 名稱 'Basic'
'Standard'
指定公用IP SKU層 'Global'
'地區'

ResourceTags

名字 描述 價值

RollingUpgradePolicy

名字 描述 價值
enableCrossZoneUpgrade 允許 VMSS 在建構升級批次時忽略 AZ 界限。 將 Update 網域和 maxBatchInstancePercent 納入考慮,以判斷批次大小。 bool
maxBatchInstancePercent 一個批次中滾動升級同時升級的虛擬機實例總數上限百分比。 由於這是最大值,先前或未來批次中狀況不良的實例可能會導致批次中的實例百分比降低,以確保更高的可靠性。 此參數預設值為 20%。 int

約束:
最小值 = 5
最大值 = 100
maxSurge 建立新的虛擬機來升級擴展集,而不是更新現有的虛擬機。 建立每個批次的新虛擬機之後,將會刪除現有的虛擬機。 bool
maxUnhealthyInstancePercent 擴展集中可同時狀況不良的虛擬機實例總數百分比上限,可能是因為升級而造成狀況不良,或在滾動升級中止之前,在虛擬機健康情況檢查中發現狀況不良狀態。 啟動任何批次之前,會先檢查此條件約束。 此參數預設值為 20%。 int

約束:
最小值 = 5
最大值 = 100
maxUnhealthyUpgradedInstancePercent 可發現處於狀況不良狀態的已升級虛擬機實例百分比上限。 升級每個批次之後,就會進行這項檢查。 如果超過這個百分比,滾動更新就會中止。 此參數預設值為 20%。 int

約束:
最小值 = 0
最大值 = 100
pauseTimeBetweenBatches 完成一個批次中所有虛擬機的更新,以及開始下一個批次之間的等候時間。 持續時間應以 ISO 8601 格式指定。 預設值為 0 秒(PT0S)。 字串
prioritizeUnhealthyInstances 在任何狀況良好的實例之前,升級擴展集中所有狀況不良的實例。 bool
rollbackFailedInstancesOnPolicyBreach 如果違反滾動升級原則,回復實例至先前的模型。 bool

ScaleInPolicy

名字 描述 價值
forceDeletion 此屬性可讓您指定在虛擬機擴展集相應縮小時,是否必須強制刪除選擇移除的虛擬機。(預覽中的功能) bool
規則 調整虛擬機擴展集時要遵循的規則。

可能的值為:

預設 當虛擬機擴展集相應縮小時,如果擴展集是區域性擴展集,則擴展集會先跨區域平衡。 然後,它會盡可能跨容錯網域進行平衡。 在每個容錯網域內,選擇移除的虛擬機將會是不受相應縮小保護的最新虛擬機。

OldestVM 當虛擬機擴展集相應縮小時,將會選擇未受相應縮小保護的最舊虛擬機進行移除。 針對區域性虛擬機擴展集,擴展集會先跨區域進行平衡。 在每個區域內,將會選擇未受保護的最舊虛擬機來移除。

NewestVM 當虛擬機擴展集相應縮小時,將會選擇未受相應縮小保護的最新虛擬機來移除。 針對區域性虛擬機擴展集,擴展集會先跨區域進行平衡。 在每個區域內,將會選擇未受保護的最新虛擬機來移除。

包含任何的字串數組:
'Default'
'NewestVM'
'OldestVM'

ScheduledEventsProfile

名字 描述 價值
osImageNotificationProfile 指定OS映像排程事件相關組態。 OSImageNotificationProfile
terminateNotificationProfile 指定終止已排程的事件相關組態。 TerminateNotificationProfile

SecurityProfile

名字 描述 價值
encryptionAtHost 用戶可以在要求中使用這個屬性來啟用或停用虛擬機或虛擬機擴展集的主機加密。 這會啟用所有磁碟的加密,包括主機本身的資源/暫存磁碟。

默認值:除非資源將此屬性設定為 true,否則將會停用主機的加密。
bool
securityType 指定虛擬機的 SecurityType。 它必須設定為任何指定的值,才能啟用 UefiSettings。

默認值:除非設定此屬性,否則不會啟用 UefiSettings。
'ConfidentialVM'
'TrustedLaunch'
uefiSettings 指定建立虛擬機時所使用的安全開機和 vTPM 等安全性設定。

API 版本下限:2020-12-01
UefiSettings

ServiceArtifactReference

名字 描述 價值
id 服務成品參考標識符的格式為 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} 字串

Sku

名字 描述 價值
能力 指定擴展集中的虛擬機數目。 int
名字 SKU 名稱。 字串
指定擴展集中虛擬機的層級。

可能的值:

Standard

基本
字串

SpotRestorePolicy

名字 描述 價值
啟用 啟用 Spot-Try-Restore 功能,其中將嘗試根據容量可用性和定價限制,以機會方式還原收回的 VMSS SPOT 實例 bool
restoreTimeout 以 ISO 8601 時間持續時間表示的逾時值,之後平臺不會嘗試還原 VMSS SPOT 實例 字串

SshConfiguration

名字 描述 價值
publicKeys 用來向Linux型VM進行驗證的SSH公鑰清單。 SshPublicKey[]

SshPublicKey

名字 描述 價值
keyData 用來透過 ssh 向 VM 進行驗證的 SSH 公鑰憑證。 密鑰至少必須是 2048 位,且格式為 ssh-rsa。

如需建立 ssh 金鑰,請參閱 [在 Azure 中建立 Linux 和 Mac 上的 SSH 密鑰]/azure/virtual-machines/linux/create-ssh-keys-detailed。
字串
路徑 指定已建立 VM 上儲存 SSH 公鑰的完整路徑。 如果檔案已經存在,指定的索引鍵會附加至檔案。 範例:/home/user/.ssh/authorized_keys 字串

SubResource

名字 描述 價值
id 資源標識碼 字串

TerminateNotificationProfile

名字 描述 價值
使 指定是否啟用或停用終止排程事件。 bool
notBeforeTimeout 刪除虛擬機的可設定時間長度,在事件自動核准之前,必須先核准終止排程事件(逾時)。 設定必須以 ISO 8601 格式指定,預設值為 5 分鐘(PT5M) 字串

UefiSettings

名字 描述 價值
secureBootEnabled 指定是否應在虛擬機上啟用安全開機。

API 版本下限:2020-12-01
bool
vTpmEnabled 指定是否應在虛擬機上啟用 vTPM。

API 版本下限:2020-12-01
bool

UpgradePolicy

名字 描述 價值
automaticOSUpgradePolicy 用於執行自動OS升級的組態參數。 AutomaticOSUpgradePolicy
模式 指定升級至擴展集中虛擬機的模式。

可能的值為:

手動 - 您可以控制擴充集中虛擬機的更新應用程式。 您可以使用 manualUpgrade 動作來執行此動作。

自動 - 擴展集中的所有虛擬機都會同時自動更新。
'Automatic'
'Manual'
'滾動'
rollingUpgradePolicy 執行滾動升級時所使用的組態參數。 RollingUpgradePolicy

UserAssignedIdentities

名字 描述 價值

UserAssignedIdentitiesValue

名字 描述 價值

VaultCertificate

名字 描述 價值
certificateStore 針對 Windows VM,指定應新增憑證之虛擬機上的證書存儲。 指定的證書存儲隱含在 LocalMachine 帳戶中。

針對 Linux VM,憑證檔案會放在 /var/lib/waagent 目錄底下,檔名 <X509 憑證檔案的大寫Thumbprint>.crt,並針對私鑰 <大寫Thumbprint>.prv。 這兩個檔案都是 .pem 格式。
字串
certificateUrl 這是已上傳至 Key Vault 做為秘密之憑證的 URL。 如需將秘密新增至 Key Vault,請參閱 將金鑰或秘密新增至金鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼,其編碼方式為 UTF-8:

{
“data”:“<Base64 編碼憑證>”,
“dataType”:“pfx”,
“password”:“<pfx-file-password>”
}
若要在虛擬機上安裝憑證,建議使用適用於Linux 的 Azure Key Vault 虛擬機擴充功能,或適用於Windows的 Azure Key Vault 虛擬機擴充功能。
字串

VaultSecretGroup

名字 描述 價值
sourceVault Key Vault 的相對 URL,其中包含 VaultCertificates 中的所有憑證。 SubResource
vaultCertificates SourceVault 中包含憑證的金鑰保存庫參考清單。 VaultCertificate[]

VirtualHardDisk

名字 描述 價值
uri 指定虛擬硬碟的 URI。 字串

VirtualMachineScaleSetDataDisk

名字 描述 價值
緩存 指定快取需求。

可能的值為:



ReadOnly

ReadWrite

預設值:標準記憶體 None。進階記憶體的 ReadOnly
'None'
'ReadOnly'
'ReadWrite'
createOption create 選項。 'Attach'
'Empty'
'FromImage' (必要)
deleteOption 指定數據磁碟應該在 VMSS Flex 刪除時刪除或中斷連結(此功能僅適用於具有彈性 OrchestrationMode 的 VMSS)。

可能的值:

刪除 如果使用此值,則會在刪除 VMSS Flex VM 時刪除資料磁碟。

卸離 如果使用此值,則會在刪除 VMSS Flex VM 之後保留數據磁碟。

預設值設定為 Delete
'Delete'
'Detach'
diskIOPSReadWrite 指定受控磁碟 Read-Write IOPS。 只有當 StorageAccountType UltraSSD_LRS時,才應該使用。 如果未指定,則會根據diskSizeGB指派預設值。 int
diskMBpsReadWrite 指定受控磁碟每秒 MB 的頻寬。 只有當 StorageAccountType UltraSSD_LRS時,才應該使用。 如果未指定,則會根據diskSizeGB指派預設值。 int
diskSizeGB 指定以 GB 為單位的空白資料磁碟大小。 這個元素可用來覆寫虛擬機映像中的磁碟大小。

diskSizeGB 是磁碟的位元組數 x 1024^3,值不能大於 1023
int
指定數據磁碟的邏輯單元編號。 這個值是用來識別 VM 內的數據磁碟,因此對於連結至 VM 的每個數據磁碟而言都必須是唯一的。 int (必要)
managedDisk 受控磁碟參數。 VirtualMachineScaleSetManagedDiskParameters
名字 磁碟名稱。 字串
writeAcceleratorEnabled 指定是否應該在磁碟上啟用或停用 writeAccelerator。 bool

VirtualMachineScaleSetExtension

名字 描述 價值
名字 延伸模組的名稱。 字串
性能 描述虛擬機擴展集擴充功能的屬性。 VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProfile

名字 描述 價值
擴展 虛擬機擴展集子擴充功能資源。 VirtualMachineScaleSetExtension[]
extensionsTimeBudget 指定所有延伸模組要啟動的時間。 持續時間應介於 15 分鐘到 120 分鐘之間(含),且應以 ISO 8601 格式指定。 預設值為90分鐘(PT1H30M)。

API 版本下限:2020-06-01
字串

VirtualMachineScaleSetExtensionProperties

名字 描述 價值
autoUpgradeMinorVersion 指出如果部署期間有新的次要版本,擴充功能是否應該使用較新的次要版本。 不過,部署之後,除非重新部署,否則擴充功能不會升級次要版本,即使此屬性設定為 true 也一定會升級。 bool
enableAutomaticUpgrade 指出如果有較新版本的延伸模組可用,平臺是否應該自動升級延伸模組。 bool
forceUpdateTag 如果提供值,且與先前的值不同,即使延伸模組組態尚未變更,擴充處理程式仍會強制更新。 字串
protectedSettings 延伸模組可以包含 protectedSettings 或 protectedSettingsFromKeyVault 或完全沒有受保護的設定。 任何
protectedSettingsFromKeyVault 以傳址方式傳遞的延伸模組受保護設定,並從金鑰保存庫取用 KeyVaultSecretReference
provisionAfterExtensions 必須布建此延伸模組之後的延伸模組名稱集合。 string[]
發行人 擴充處理程序發行者的名稱。 字串
設置 擴充功能的 Json 格式化公用設定。 任何
suppressFailures 指出延伸模組產生的失敗是否會隱藏(不論此值為何,無法連線到 VM 等作業失敗)。 默認值為 false。 bool
類型 指定延伸模組的類型;例如“CustomScriptExtension”。 字串
typeHandlerVersion 指定文稿處理程式的版本。 字串

VirtualMachineScaleSetHardwareProfile

名字 描述 價值
vmSizeProperties 指定自定義虛擬機大小的屬性。 API 版本下限:2021-11-01。

如需詳細資訊,請遵循 VM 自定義 中的指示。
VMSizeProperties

VirtualMachineScaleSetIdentity

名字 描述 價值
類型 用於虛擬機擴展集的身分識別類型。 類型 'SystemAssigned, UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。 類型 『None』 會從虛擬機擴展集移除任何身分識別。 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities 與虛擬機擴展集相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 UserAssignedIdentities

VirtualMachineScaleSetIPConfiguration

名字 描述 價值
名字 IP 組態名稱。 字串 (必要)
性能 描述虛擬機擴展集網路配置檔的IP組態屬性。 VirtualMachineScaleSetIPConfigurationProperties

VirtualMachineScaleSetIPConfigurationProperties

名字 描述 價值
applicationGatewayBackendAddressPools 指定應用程式閘道後端位址池的參考數位。 擴展集可以參考多個應用程式閘道的後端位址池。 多個擴展集無法使用相同的應用程式閘道。 SubResource[]
applicationSecurityGroups 指定應用程式安全組參考的陣列。 SubResource[]
loadBalancerBackendAddressPools 指定負載平衡器後端位址池的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的後端位址池。 多個擴展集無法使用相同的基本 SKU 負載平衡器。 SubResource[]
loadBalancerInboundNatPools 指定負載平衡器輸入 Nat 集區的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的輸入 nat 集區。 多個擴展集無法使用相同的基本 SKU 負載平衡器。 SubResource[]
主要 指定虛擬機有1個以上的網路介面時的主要網路介面。 bool
privateIPAddressVersion 從 Api-Version 2017-03-30 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 'IPv4'
'IPv6'
publicIPAddressConfiguration publicIPAddressConfiguration。 VirtualMachineScaleSetPublicIPAddressConfiguration
指定子網的識別碼。 ApiEntityReference

VirtualMachineScaleSetIpTag

名字 描述 價值
ipTagType IP 標籤類型。 範例:FirstPartyUsage。 字串
標記 與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 字串

VirtualMachineScaleSetManagedDiskParameters

名字 描述 價值
diskEncryptionSet 指定受控磁碟的客戶受控磁碟加密集資源標識符。 DiskEncryptionSetParameters
securityProfile 指定受控磁碟的安全性配置檔。 VMDiskSecurityProfile
storageAccountType 指定受控磁碟的記憶體帳戶類型。 注意:UltraSSD_LRS只能與數據磁碟搭配使用,因此無法與OS磁碟搭配使用。 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

VirtualMachineScaleSetNetworkConfiguration

名字 描述 價值
名字 網路組態名稱。 字串 (必要)
性能 描述虛擬機擴展集網路配置檔的IP組態。 VirtualMachineScaleSetNetworkConfigurationProperties

VirtualMachineScaleSetNetworkConfigurationDnsSettings

名字 描述 價值
dnsServers DNS 伺服器 IP 位址清單 string[]

VirtualMachineScaleSetNetworkConfigurationProperties

名字 描述 價值
deleteOption 指定刪除 VM 時網路介面會發生什麼事 'Delete'
'Detach'
disableTcpStateTracking 指定是否停用 tcp 狀態追蹤的網路介面。 bool
dnsSettings 要套用在網路介面上的 DNS 設定。 VirtualMachineScaleSetNetworkConfigurationDnsSettings
enableAcceleratedNetworking 指定網路介面是否已啟用加速網路功能。 bool
enableFpga 指定網路介面是否已啟用 FPGA 網路功能。 bool
enableIPForwarding 是否在此 NIC 上啟用 IP 轉送。 bool
ipConfigurations 指定網路介面的IP組態。 VirtualMachineScaleSetIPConfiguration[] (必要)
networkSecurityGroup 網路安全組。 SubResource
主要 指定虛擬機有1個以上的網路介面時的主要網路介面。 bool

VirtualMachineScaleSetNetworkProfile

名字 描述 價值
healthProbe 負載平衡器探查的參考,用來判斷虛擬機擴展集中實例的健康情況。 參考的格式為:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}'。 ApiEntityReference
networkApiVersion 會指定在具有協調流程模式 「彈性」的虛擬機擴展集網路介面組態中建立網路資源時所使用的Microsoft.Network API 版本 '2020-11-01'
networkInterfaceConfigurations 網路組態的清單。 VirtualMachineScaleSetNetworkConfiguration[]

VirtualMachineScaleSetOSDisk

名字 描述 價值
緩存 指定快取需求。

可能的值為:



ReadOnly

ReadWrite

預設值:標準記憶體 None。進階記憶體的 ReadOnly
'None'
'ReadOnly'
'ReadWrite'
createOption 指定應該如何建立擴展集中的虛擬機。

唯一允許的值是:FromImage \u2013 當您使用映像來建立虛擬機時,會使用此值。 如果您使用平臺映像,則也會使用上述的 imageReference 元素。 如果您使用市集映像,則也會使用先前所述的 plan 元素。
'Attach'
'Empty'
'FromImage' (必要)
deleteOption 指定 VMSS Flex 刪除時是否應該刪除或中斷連結 OS 磁碟(此功能僅適用於具有彈性 OrchestrationMode 的 VMSS)。

可能的值:

刪除 如果使用此值,刪除 VMSS Flex VM 時會刪除 OS 磁碟。

卸離 如果使用此值,則會在刪除 VMSS Flex VM 之後保留 OS 磁碟。

預設值設定為 Delete。 針對暫時 OS 磁碟,預設值會設定為 [刪除]。 使用者無法變更暫時 OS 磁碟的刪除選項。
'Delete'
'Detach'
diffDiskSettings 指定虛擬機擴展集所使用作業系統磁碟的暫時磁碟設定。 DiffDiskSettings
diskSizeGB 指定以 GB 為單位的空白資料磁碟大小。 這個元素可用來覆寫虛擬機映像中的磁碟大小。

diskSizeGB 是磁碟的位元組數 x 1024^3,值不能大於 1023
int
圖像 指定要以擴展集為基礎之 Unmanaged 使用者映像的相關信息。 VirtualHardDisk
managedDisk 受控磁碟參數。 VirtualMachineScaleSetManagedDiskParameters
名字 磁碟名稱。 字串
osType 此屬性可讓您指定從使用者映像或特製化 VHD 建立 VM 時,磁碟包含的 OS 類型。

可能的值為:

Windows

Linux
'Linux'
'Windows'
vhdContainers 指定用來儲存擴展集作業系統磁碟的容器 URL。 string[]
writeAcceleratorEnabled 指定是否應該在磁碟上啟用或停用 writeAccelerator。 bool

VirtualMachineScaleSetOSProfile

名字 描述 價值
adminPassword 指定系統管理員帳戶的密碼。

最小長度 (Windows): 8 個字元

最小長度 (Linux): 6 個字元

長度上限 (Windows): 123 個字元

長度上限(Linux): 72 個字元

複雜性需求:需要滿足下列 4 個條件中的 3 個
字元較低
具有大字元
具有數位
具有特殊字元 (Regex match [\W_])

不允許的值: “abc@123”、“P@$$w 0rd”、“P@ssw0rd”、“P@ssword123”、“Pa$$word”、“pass@word1”、“Password!”、“Password1”、“Password22”、“iloveyou!”

如需重設密碼,請參閱 如何在 Windows VM 中重設遠端桌面服務或其登入密碼

如需重設根密碼,請參閱 使用 VMAccess 擴充功能 管理使用者、SSH 及檢查或修復 Azure Linux VM 上的磁碟
字串

約束:
敏感性值。 以安全參數的形式傳入。
adminUsername 指定系統管理員帳戶的名稱。

僅限 Windows 的限制: 不能以 “” 結尾。

不允許的值: “administrator”、“admin”、“user”、“user1”、“test”、“user2”、“test1”、“user3”、“admin1”、“1” “123”、“a”、“actuser”、“adm”、“admin2”、“aspnet”、“backup”、“console”、“david”、“guest”、“john”、“owner”、“root”、“server”、“sql”、“support”、“support_388945a0”、“sys”、“test2”、“test3”、“user4”、“user5”。

最小長度 (Linux): 1 個字元

最大長度 (Linux): 64 個字元

長度上限 (Windows): 20 個字元
字串
allowExtensionOperations 指定虛擬機擴展集上是否應該允許擴充功能作業。

只有在虛擬機擴展集上沒有擴充功能時,才會將此選項設定為 False。
bool
computerNamePrefix 指定擴展集中所有虛擬機的計算機名稱前置詞。 計算機名稱前置詞長度必須為1到15個字元。 字串
customData 指定自訂數據的base-64編碼字串。 base-64 編碼字串會譯碼為儲存為虛擬機上檔案的二進位數組。 二進位陣列的最大長度為65535個字節。

如需針對 VM 使用 cloud-init,請參閱在建立期間使用 cloud-init 自定義 Linux VM
字串
linuxConfiguration 指定虛擬機上的Linux作業系統設定。

如需支援的 Linux 發行版清單,請參閱 Azure-Endorsed 發行版上的 Linux
LinuxConfiguration
requireGuestProvisionSignal 必須設定為 True 或省略的選擇性屬性。 bool
秘密 指定應該安裝在擴展集中虛擬機上的憑證集。 若要在虛擬機上安裝憑證,建議使用適用於Linux 的 Azure Key Vault 虛擬機擴充功能,或適用於Windows的 Azure Key Vault 虛擬機擴充功能。 VaultSecretGroup[]
windowsConfiguration 指定虛擬機上的 Windows 作業系統設定。 WindowsConfiguration

VirtualMachineScaleSetProperties

名字 描述 價值
additionalCapabilities 指定在虛擬機擴展集的虛擬機上啟用或停用的其他功能。 例如:虛擬機是否能夠支援使用UltraSSD_LRS記憶體帳戶類型鏈接受控數據磁碟。 AdditionalCapabilities
automaticRepairsPolicy 自動修復的原則。 AutomaticRepairsPolicy
constrainedMaximumCapacity 必須設定為 True 或省略的選擇性屬性。 bool
doNotRunExtensionsOnOverprovisionedVMs 啟用 Overprovision 時,只會在最後保留的要求 VM 數目上啟動擴充功能。 因此,這個屬性可確保延伸模組不會在額外的過度布建 VM 上執行。 bool
hostGroup 指定虛擬機擴展集所在專用主機群組的相關信息。

API 版本下限:2020-06-01。
SubResource
orchestrationMode 指定虛擬機擴展集的協調流程模式。 '彈性'
'Uniform'
overprovision 指定虛擬機擴展集是否應該過度布建。 bool
platformFaultDomainCount 每個放置群組的容錯網域計數。 int
priorityMixPolicy 指定在相同 VMSS Flex 實例內混合 Spot 和一般優先順序 VM 所需的目標。 PriorityMixPolicy
proximityPlacementGroup 指定應該指派虛擬機擴展集之鄰近放置群組的相關信息。

API 版本下限:2018-04-01。
SubResource
scaleInPolicy 指定在虛擬機擴展集中調整虛擬機時所套用的原則。 ScaleInPolicy
singlePlacementGroup 若為 true,這會將擴展集限制為單一放置群組,大小上限為 100 部虛擬機。 注意:如果 singlePlacementGroup 為 true,它可能會修改為 false。 不過,如果 singlePlacementGroup 為 false,它可能不會修改為 true。 bool
spotRestorePolicy 指定虛擬機擴展集的Spot Restore 屬性。 SpotRestorePolicy
upgradePolicy 升級原則。 UpgradePolicy
virtualMachineProfile 虛擬機器配置檔。 VirtualMachineScaleSetVMProfile
zoneBalance 如果發生區域中斷,是否要強制甚至虛擬機散發跨 x 區域。 只有在擴展集的區域屬性包含多個區域時,才能設定 zoneBalance 屬性。 如果沒有區域或只有一個指定區域,則不應該設定 zoneBalance 屬性。 bool

VirtualMachineScaleSetPublicIPAddressConfiguration

名字 描述 價值
名字 publicIP 位址組態名稱。 字串 (必要)
性能 描述虛擬機擴展集IP組態的PublicIPAddress組態 VirtualMachineScaleSetPublicIPAddressConfigurationProperties
sku 描述公用IP Sku。 它只能將 OrchestrationMode 設定為彈性。 PublicIPAddressSku

VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings

名字 描述 價值
domainNameLabel 功能變數名稱標籤。功能變數名稱標籤和 VM 索引的串連將是將要建立之 PublicIPAddress 資源的功能變數名稱標籤 字串 (必要)

VirtualMachineScaleSetPublicIPAddressConfigurationProperties

名字 描述 價值
deleteOption 指定刪除 VM 時,公用 IP 會發生什麼事 'Delete'
'Detach'
dnsSettings 要套用至 publicIP 位址的 DNS 設定。 VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings
idleTimeoutInMinutes 公用IP位址的閒置逾時。 int
ipTags 與公用IP位址相關聯的IP標籤清單。 VirtualMachineScaleSetIpTag[]
publicIPAddressVersion 從 Api-Version 2019-07-01 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 'IPv4'
'IPv6'
publicIPPrefix 要從中配置 publicIP 位址的 PublicIPPrefix。 SubResource

VirtualMachineScaleSetStorageProfile

名字 描述 價值
dataDisks 指定參數,用來將數據磁碟新增至擴展集中的虛擬機。

如需磁碟的詳細資訊,請參閱 關於 Azure 虛擬機器的磁碟和 VHD
VirtualMachineScaleSetDataDisk[]
diskControllerType 字串
imageReference 指定要使用之映像的相關信息。 您可以指定平臺映像、市集映像或虛擬機映像的相關信息。 當您想要使用平臺映像、市集映像或虛擬機映像,但未用於其他建立作業時,則需要此元素。 ImageReference
osDisk 指定擴展集中虛擬機所使用的操作系統磁碟相關信息。

如需磁碟的詳細資訊,請參閱 關於 Azure 虛擬機器的磁碟和 VHD
VirtualMachineScaleSetOSDisk

VirtualMachineScaleSetVMProfile

名字 描述 價值
applicationProfile 指定應該提供給 VM/VMSS 的資源庫應用程式 ApplicationProfile
billingProfile 指定 Azure Spot VMSS 的計費相關詳細數據。

API 版本下限:2019-03-01。
BillingProfile
capacityReservation 指定擴展集的容量保留相關詳細數據。

API 版本下限:2021-04-01。
CapacityReservationProfile
diagnosticsProfile 指定開機診斷設定狀態。

API 版本下限:2015-06-15。
DiagnosticsProfile
evictionPolicy 指定 Azure Spot 虛擬機和 Azure Spot 擴展集的收回原則。

針對 Azure Spot 虛擬機,支援「解除分配」和「刪除」,且最低 API 版本為 2019-03-01。

針對 Azure Spot 擴展集,支援「解除分配」和「刪除」,且最低 API 版本為 2017-10-30-preview。
'Deallocate'
'Delete'
extensionProfile 指定擴展集中虛擬機上所安裝延伸模組的設定集合。 VirtualMachineScaleSetExtensionProfile
hardwareProfile 指定擴展集的硬體配置檔相關詳細數據。

API 版本下限:2021-11-01。
VirtualMachineScaleSetHardwareProfile
licenseType 指定所使用的映像或磁碟已獲內部部署授權。

Windows Server 操作系統的可能值為:

Windows_Client

Windows_Server

Linux Server 操作系統的可能值為:

RHEL_BYOS (RHEL)

SLES_BYOS (適用於 SUSE)

如需詳細資訊,請參閱 適用於 Windows Server 的 Azure Hybrid Use Benefit

適用於Linux Server的 Azure Hybrid Use Benefit

API 版本下限:2015-06-15
字串
networkProfile 指定擴展集中虛擬機網路介面的屬性。 VirtualMachineScaleSetNetworkProfile
osProfile 指定擴展集中虛擬機的作業系統設定。 VirtualMachineScaleSetOSProfile
優先權 指定擴展集中虛擬機的優先順序。

最低 api-version:2017-10-30-preview
'Low'
'Regular'
'Spot'
scheduledEventsProfile 指定排程的事件相關組態。 ScheduledEventsProfile
securityProfile 指定擴展集中虛擬機的安全性相關配置檔設定。 SecurityProfile
serviceArtifactReference 指定使用 'latest' 映射版本時,用來為擴展集中所有虛擬機設定相同映像版本的服務成品參考標識符。 API 版本下限:2022-11-01 ServiceArtifactReference
storageProfile 指定虛擬機磁碟的記憶體設定。 VirtualMachineScaleSetStorageProfile
userData 擴展集中虛擬機的UserData,其必須是base-64編碼。 客戶不應在此傳遞任何秘密。

API 版本下限:2021-03-01
字串

VMDiskSecurityProfile

名字 描述 價值
diskEncryptionSet 針對客戶受控密鑰加密的機密VM OS 磁碟和 VMGuest Blob 所使用的受控磁碟,指定客戶受控磁碟加密集資源識別碼。 DiskEncryptionSetParameters
securityEncryptionType 指定受控磁碟的 EncryptionType。
它設定為 DiskWithVMGuestState 以加密受控磁碟以及 VMGuestState Blob,而 VMGuestStateOnly 則只會加密 VMGuestState Blob。

注意:只能針對機密 VM 進行設定。
'DiskWithVMGuestState'
'VMGuestStateOnly'

VMGalleryApplication

名字 描述 價值
configurationReference 選擇性,指定 Azure Blob 的 URI,如果提供的話,將會取代套件的預設組態 字串
enableAutomaticUpgrade 如果設定為 true,當 PIR/SIG 中提供新的資源庫應用程式版本時,VM/VMSS 會自動更新它 bool
次序 選擇性,指定必須安裝套件的順序 int
packageReferenceId 指定 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/applications/{application}/versions/{version} 形式的 GalleryApplicationVersion 資源標識符 字串 (必要)
標籤 選擇性,指定更多泛型內容的傳遞值。 字串
treatFailureAsDeploymentFailure 選擇性,如果為 true,VmApplication 中任何作業的任何失敗都會使部署失敗 bool

VMSizeProperties

名字 描述 價值
vCPUUsAvailable 指定 VM 可用的 vCPU 數目。

當要求本文中未指定此屬性時,預設行為是將它設定為 api 回應中公開的 vCPU 值,列出區域中所有可用的虛擬機大小
int
vCPUUsPerCore 指定 vCPU 與實體核心比率。

當要求本文中未指定此屬性時,預設行為會針對 api 回應中公開的 VM 大小設定為 vCPUUsPerCore 的值,列出區域中所有可用的虛擬機大小

將此屬性設定為 1 也表示已停用超線程處理。
int

WindowsConfiguration

名字 描述 價值
additionalUnattendContent 指定其他base-64編碼的 XML 格式資訊,這些資訊可以包含在 Windows 安裝程式所使用的 Unattend.xml 檔案中。 AdditionalUnattendContent[]
enableAutomaticUpdates 指出是否為 Windows 虛擬機啟用自動更新。 默認值為 true。

針對虛擬機擴展集,此屬性可以更新,更新將會在OS重新佈建上生效。
bool
enableVMAgentPlatformUpdates 指出是否為 Windows 虛擬機啟用 VMAgent 平臺更新。 默認值為 false。 bool
patchSettings [預覽功能]指定與 Windows 上的 VM 客體修補相關的設定。 PatchSettings
provisionVMAgent 指出虛擬機器代理程式是否應該佈建在虛擬機上。

當要求本文中未指定此屬性時,預設行為是將它設定為 true。 這可確保 VM 代理程式已安裝在 VM 上,以便稍後將擴充功能新增至 VM。
bool
timeZone 指定虛擬機的時區。 例如「太平洋標準時間」。

可能的值可以從 TimeZoneInfo.GetSystemTimeZones傳回的時區 TimeZoneInfo.Id 值。
字串
winRM 指定 Windows 遠端管理接聽程式。 這可啟用遠端 Windows PowerShell。 WinRMConfiguration

WindowsVMGuestPatchAutomaticByPlatformSettings

名字 描述 價值
rebootSetting 指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。 'Always'
'IfRequired'
'Never'
'Unknown'

WinRMConfiguration

名字 描述 價值
聽眾 Windows 遠端管理接聽程式清單 WinRMListener[]

WinRMListener

名字 描述 價值
certificateUrl 這是已上傳至 Key Vault 做為秘密之憑證的 URL。 如需將秘密新增至 Key Vault,請參閱 將金鑰或秘密新增至金鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼,其編碼方式為 UTF-8:

{
“data”:“<Base64 編碼憑證>”,
“dataType”:“pfx”,
“password”:“<pfx-file-password>”
}
若要在虛擬機上安裝憑證,建議使用適用於Linux 的 Azure Key Vault 虛擬機擴充功能,或適用於Windows的 Azure Key Vault 虛擬機擴充功能。
字串
協定 指定 WinRM 接聽程式的通訊協定。

可能的值為:
http

https
'Http'
'Https'

快速入門範本

下列快速入門範本會部署此資源類型。

範本 描述
將多個 VM 新增至虛擬機擴展集

部署至 Azure
此範本會建立具有受控磁碟、公用IP和網路介面的VM數目。 它會以彈性協調流程模式,在虛擬機擴展集中建立 VM。 它們將會佈建在虛擬網路中,此虛擬網路也會建立為部署的一部分
使用 Azure SQL Database 自動調整 LANSA Windows VM ScaleSet

部署至 Azure
此範本會部署具有擴展集中所需 VM 計數和 LANSA MSI 的 Windows VMSS,以安裝到每個 VM 中。 部署 VM 擴展集之後,會使用自訂腳本擴充功能來安裝 LANSA MSI)
Azure Container Service Engine (acs-engine) - 群集模式

部署至 Azure
Azure Container Service Engine (acs-engine) 會使用您選擇的 DC/OS、Kubernetes、Swarm 模式或 Swarm 協調器,為 Microsoft azure 上啟用 Docker 的叢集產生 ARM (Azure Resource Manager) 範本。 工具的輸入是叢集定義。 叢集定義非常類似(在許多情況下與 相同)用來部署 azure Container Service 叢集Microsoft ARM 範本語法。
Azure Game 開發人員虛擬機擴展集

部署至 Azure
Azure 遊戲開發人員虛擬機擴展集包含 Unreal 等授權引擎。
Azure VM 擴展集作為 Intel Lustre 的用戶端

部署至 Azure
此範本會使用 Azure VM 擴展集和 Azure 資源庫 OpenLogic CentOS 6.6 或 7.0 映射建立一組 Intel Lustre 2.7 用戶端,並掛接現有的 Intel Lustre 文件系統
機密 VM 擴展集與機密磁碟加密

部署至 Azure
此範本可讓您使用數個 Windows 和 Linux 映射版本的最新修補版本,部署已啟用機密 OS 磁碟加密的機密 VM 擴展集。
Couchbase Enterprise

部署至 Azure
用來安裝 Couchbase Enterprise 的 Azure Resource Manager (ARM) 範本
使用 jumpbox 建立和加密新的 Linux VMSS

部署至 Azure
此範本會使用最新的 Linux 映像來部署 Linux VMSS、新增數據磁碟區,然後加密每個 Linux VMSS 實例的數據磁碟區。 它也會在與具有私人IP位址的Linux VMSS實例相同的虛擬網路中,部署具有公用IP位址的 Jumpbox。 這允許透過其公用IP位址連線到 jumpbox,然後透過私人IP位址連線到Linux VMSS 實例。
使用 jumpbox 建立和加密新的 Windows VMSS

部署至 Azure
此範本可讓您使用最新修補版本的伺服器 Windows 版本來部署簡單的 Windows VM 擴展集。 此範本也會在相同的虛擬網路中部署具有公用IP位址的 Jumpbox。 您可以透過此公用IP位址連線到 jumpbox,然後透過私人IP位址從該處連線到擴展集中的 VM。此範本會在 WINDOWS VM 的 VM 擴展集上啟用加密。
部署已啟用 NSG 的 3 Nodetype 安全叢集

部署至 Azure
此範本可讓您在Standard_D2大小 VM 上部署執行 Windows Server 2016 資料中心的安全 3 節點類型 Service Fabric 叢集。 使用此範本可讓您使用網路安全組控制輸入和輸出網路流量。
部署5節點安全叢集

部署至 Azure
此範本可讓您在Standard_D2_v2大小 VMSS 上部署執行 Windows Server 2019 Datacenter 的安全 5 節點 Service Fabric 叢集。
部署 5 節點 Ubuntu Service Fabric 叢集

部署至 Azure
此範本可讓您在Standard_D2_V2大小 VMSS 上部署執行 Ubuntu 的安全 5 節點 Service Fabric 叢集。
部署Linux VMSS wth主要/次要架構

部署至 Azure
此範本可讓您在主要次要架構中使用自定義腳本擴充功能來部署Linux VMSS
部署 Nextflow genomics 叢集

部署至 Azure
此範本會部署具有 Jumpbox、n 叢集節點、Docker 支援和共用記憶體的可調整 Nextflow 叢集。
將擴展集部署到現有的 vnet

部署至 Azure
此範本會將 VM 擴展集部署到外延的 vnet。
將擴展集部署到 Windows 上的現有 vnet

部署至 Azure
此範本會將 Windows 2016 Datacenter VM 擴展集部署到資源群組、vnet 和子網。
使用Linux VM部署簡單的 VM 擴展集

部署至 Azure
此範本可讓您使用最新修補版本的 Ubuntu Linux 14.04.4-LTS 或 16.04-LTS 部署簡單的 Linux VM 擴展集。 這些 VM 位於負載平衡器後方,具有 SSH 連線的 NAT 規則。
使用Linux VM部署簡單的 VM 擴展集和 Jumpbox

部署至 Azure
此範本可讓您使用最新修補版本的UbuntuLinux 15.10或14.04.4-LTS來部署簡單的Linux VM擴展集。 另外還有一個 Jumpbox,可從 VM 位於 VNet 外部啟用連線。
使用 Windows VM 部署簡單的 VM 擴展集

部署至 Azure
此範本可讓您使用各種 Windows 版本的最新修補版本,部署簡單的 Windows VM 擴展集。 這些 VM 位於具有 RDP 連線 NAT 規則的負載平衡器後方。
使用 Windows VM 部署簡單的 VM 擴展集和 Jumpbox

部署至 Azure
此範本可讓您使用最新修補版本的伺服器 Windows 版本來部署簡單的 Windows VM 擴展集。 此範本也會在相同的虛擬網路中部署具有公用IP位址的 Jumpbox。 您可以透過此公用IP位址連線到 jumpbox,然後透過私人IP位址從該處連線到擴展集中的 VM。
部署支援受信任啟動的 Windows VM 擴展集

部署至 Azure
此範本可讓您使用最新修補版本的 Windows Server 2016、Windows Server 2019 或 Windows Server 2022 Azure Edition,部署支援信任啟動的 Windows VM 擴展集。 這些 VM 位於具有 RDP 連線 NAT 規則的負載平衡器後方。 如果您啟用 Secureboot 和 vTPM,客體證明擴充功能將會安裝在您的 VMSS 上。 此延伸模組會執行雲端的遠端 證明
從 Azure 數據科學 VM 部署 VM 擴展集

部署至 Azure
這些範本會使用 Azure 資料科學 VM 作為來源映像來部署 VM 擴展集。
使用Linux自定義映像部署 VM 擴展集

部署至 Azure
此範本可讓您在擴展集內部署自訂 VM Linux 映像。 這些 VM 位於具有 HTTP 負載平衡的負載平衡器後方(根據預設在埠 80 上)。 此範例會使用自定義腳本來執行應用程式部署和更新,您可能必須為自己的更新程式提供自定義腳本。 您必須在建立 VMSS 的相同訂用帳戶和區域中,提供 VM 的一般化映像。
使用 Windows 自定義映像部署 VM 擴展集

部署至 Azure
此範本可讓您部署簡單的 VM 擴展集,以使用自訂 Windows 映像。 這些 VM 位於具有 HTTP 負載平衡的負載平衡器後方(根據預設埠 80)
使用 Linux VM 部署 VM 擴展集和自動調整

部署至 Azure
此範本可讓您使用最新修補版本的 Ubuntu Linux 15.04 或 14.04.4-LTS 來部署簡單的 Linux VM 擴展集。 這些 VM 位於負載平衡器後方,具有 SSH 連線的 NAT 規則。它們也有自動調整整合
在 ILB 後部署具有 Linux VM 的 VM 擴展集

部署至 Azure
此範本可讓您使用最新修補版本的 Ubuntu Linux 15.10 或 14.04.4-LTS 來部署 Linux VM 的 VM 擴展集。 這些 VM 位於內部負載平衡器後方,具有 SSH 連線的 NAT 規則。
在可用性區域中部署具有Linux VM的VM擴展集

部署至 Azure
此範本可讓您使用最新修補版本的 Ubuntu Linux 14.04.4-LTS 或 16.04-LTS 部署簡單的 Linux VM 擴展集。 這些 VM 位於負載平衡器後方,具有 SSH 連線的 NAT 規則。
使用 Windows VM 部署 VM 擴展集和自動調整

部署至 Azure
此範本可讓您使用最新修補版本的 Windows 2008-R2-SP1、2012-Datacenter 或 2012-R2-Datacenter 部署簡單的 Windows VM 擴展集。 這些 VM 位於具有 RDP 連線 NAT 規則的負載平衡器後方。 它們也有自動調整整合
在可用性區域中部署具有 Windows VM 的 VM 擴展集

部署至 Azure
此範本可讓您使用各種 Windows 版本的最新修補版本來部署 Windows VM 的 VM 擴展集。 這些 VM 位於具有 RDP 連線 NAT 規則的負載平衡器後方。
部署 VMSS,將每個 VM 連線到 Azure 檔案記憶體共用

部署至 Azure
此範本會部署 Ubuntu 虛擬機擴展集,並使用自定義腳本擴充功能將每個 VM 連線到 Azure 檔案記憶體共用
使用自定義腳本擴充功能部署 Windows VM 擴展集

部署至 Azure
此範本可讓您使用各種 Windows 版本的最新修補版本來部署 Windows VM 的 VM 擴展集。 這些 VM 具有自定義腳本擴充功能,且位於負載平衡器後方,具有 RDP 連線的 NAT 規則。
使用 Azure 應用程式閘道部署 Windows VM 擴展集

部署至 Azure
此範本可讓您部署與 Azure 應用程式閘道整合的簡單 Windows VM 擴展集,並支援最多 1000 部 VM
部署虛擬機 ScaleSet 的自動調整設定

部署至 Azure
此範本可讓您部署虛擬機 ScaleSet 資源的自動調整原則。
使用 Azure 應用程式閘道部署 Ubuntu VM 擴展集

部署至 Azure
此範本可讓您部署與 Azure 應用程式閘道整合的簡單 Ubuntu VM 擴展集,並支援最多 1000 部 VM
部署深色追蹤自動調整 vSensors

部署至 Azure
此範本可讓您部署 Darktrace vSensors 的自動自動調整部署
使用 VM 擴展集、Azure 檔案和 Mysql 部署 Drupal

部署至 Azure
在負載平衡器/NAT 後方部署 VM 擴展集,& 執行 Drupal 的每個 VM(Apache / PHP)。 所有節點都會共用已建立的 Azure 檔案共用記憶體和 MySQL 資料庫
使用 LB 探查和自動修復部署 VM 擴展集

部署至 Azure
此範本可讓您在已設定健康情況探查的負載平衡器後方部署Linux VM的VM擴展集。 擴展集也有自動實例修復原則,且寬限期為 30 分鐘。
使用 Python Bottle 伺服器部署 VM 擴展集 & 自動調整

部署至 Azure
在負載平衡器/NAT 後方部署 VM 擴展集,& 執行可運作的簡單 Python Bottle 應用程式的每個 VM。 設定自動調整擴展集時,會視需要相應放大 &
部署 Windows VMSS 設定具有 SSL DSC

部署至 Azure
此範本可讓您部署兩個 Windows VMSS、設定 WINDOWS 功能,例如 IIS/Web 角色、.Net Framework 4.5、windows 驗證、應用程式初始化、下載應用程式部署套件、URL 重寫 & 使用 DSC 和 Azure Key Vault 的 SSL 設定
停用現有 Linux VMSS 上的加密

部署至 Azure
停用現有Linux VMSS上的加密
在執行中的Linux VMSS 上啟用資料磁碟區加密

部署至 Azure
在執行中的Linux VMSS上啟用數據磁碟區加密
在虛擬機擴展集上安裝 Elasticsearch 叢集

部署至 Azure
此範本會在虛擬機擴展集上部署 Elasticsearch 叢集。 範本會布建 3 個專用主要節點,其中包含選擇性數目的數據節點,這些節點會在受控磁碟上執行。
RHEL 上的 JBoss EAP

部署至 Azure
此範本可讓您建立執行 JBoss EAP 7.4 叢集的 RHEL 8.6 VMSS 實例,並部署名為 eap-session-replication 的 Web 應用程式,您可以使用部署時設定的 JBoss EAP 使用者名稱和密碼來登入管理控制台。
使用 VMSS 叢集自動調整程式 Kubernetes 叢集

部署至 Azure
此範本會部署使用 kubeadm 初始化的 vanilla kubernetes 叢集。 它會使用叢集自動調整程式部署已設定的主要節點。 預先設定的虛擬機擴展集 (VMSS) 也會部署並自動連結至叢集。 接著,叢集自動調整程式可以根據叢集的工作負載自動相應增加/減少叢集。
使用 Linux VM 和每個 VM 的公用 IPv4 簡單 VM 擴展集

部署至 Azure
此範本示範如何使用負載平衡器、輸入 NAT 規則和每個 VM 的公用 IP 來部署簡單的擴充集。
已啟用 SSL 的 VM 擴展集

部署至 Azure
部署 Web 伺服器以安全方式部署的 SSL 憑證來設定 Azure Key Vault
使用可用性區域 虛擬機擴展集範例

部署至 Azure
此範本會使用負載平衡器,建立位於個別可用性區域中的 VMSS。
執行 IIS WebApp 的自動調整 VM 擴展集

部署至 Azure
部署執行 IIS 的 Windows VM 擴展集和非常基本的 .NET MVC Web 應用程式。 VMSS PowerShell DSC 擴充功能可用來執行 IIS 安裝和 WebDeploy 套件部署。
在 Azure 虛擬網路 (VNET) 中部署 IPv6 的 VMSS

部署至 Azure
使用雙堆棧 IPv4/IPv6 VNET 和 Std Load Balancer 建立 VM 擴展集。
VMSS 彈性協調流程模式快速入門 Linux

部署至 Azure
此範本會部署具有 Azure Load Balancer 後方實例的簡單 VM 擴展集。 VM 擴展集處於彈性協調流程模式。 使用 os 參數來選擇 Linux (Ubuntu) 或 Windows (Windows Server Datacenter 2019) 部署。 注意:本快速入門範本可讓您從任何因特網位址存取 VM 管理埠(SSH、RDP),而且不應該用於生產部署。
具有公用IP前置詞的VMSS

部署至 Azure
使用公用IP前綴部署VMSS的範本

Terraform (AzAPI 提供者) 資源定義

virtualMachineScaleSets 資源類型可以使用目標作業來部署:

  • 資源群組

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔

資源格式

若要建立 Microsoft.Compute/virtualMachineScaleSets 資源,請將下列 Terraform 新增至範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/virtualMachineScaleSets@2022-11-01"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  plan = {
    name = "string"
    product = "string"
    promotionCode = "string"
    publisher = "string"
  }
  sku = {
    capacity = int
    name = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  zones = [
    "string"
  ]
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      additionalCapabilities = {
        hibernationEnabled = bool
        ultraSSDEnabled = bool
      }
      automaticRepairsPolicy = {
        enabled = bool
        gracePeriod = "string"
        repairAction = "string"
      }
      constrainedMaximumCapacity = bool
      doNotRunExtensionsOnOverprovisionedVMs = bool
      hostGroup = {
        id = "string"
      }
      orchestrationMode = "string"
      overprovision = bool
      platformFaultDomainCount = int
      priorityMixPolicy = {
        baseRegularPriorityCount = int
        regularPriorityPercentageAboveBase = int
      }
      proximityPlacementGroup = {
        id = "string"
      }
      scaleInPolicy = {
        forceDeletion = bool
        rules = [
          "string"
        ]
      }
      singlePlacementGroup = bool
      spotRestorePolicy = {
        enabled = bool
        restoreTimeout = "string"
      }
      upgradePolicy = {
        automaticOSUpgradePolicy = {
          disableAutomaticRollback = bool
          enableAutomaticOSUpgrade = bool
          useRollingUpgradePolicy = bool
        }
        mode = "string"
        rollingUpgradePolicy = {
          enableCrossZoneUpgrade = bool
          maxBatchInstancePercent = int
          maxSurge = bool
          maxUnhealthyInstancePercent = int
          maxUnhealthyUpgradedInstancePercent = int
          pauseTimeBetweenBatches = "string"
          prioritizeUnhealthyInstances = bool
          rollbackFailedInstancesOnPolicyBreach = bool
        }
      }
      virtualMachineProfile = {
        applicationProfile = {
          galleryApplications = [
            {
              configurationReference = "string"
              enableAutomaticUpgrade = bool
              order = int
              packageReferenceId = "string"
              tags = "string"
              treatFailureAsDeploymentFailure = bool
            }
          ]
        }
        billingProfile = {
          maxPrice = int
        }
        capacityReservation = {
          capacityReservationGroup = {
            id = "string"
          }
        }
        diagnosticsProfile = {
          bootDiagnostics = {
            enabled = bool
            storageUri = "string"
          }
        }
        evictionPolicy = "string"
        extensionProfile = {
          extensions = [
            {
              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"
              }
            }
          ]
          extensionsTimeBudget = "string"
        }
        hardwareProfile = {
          vmSizeProperties = {
            vCPUsAvailable = int
            vCPUsPerCore = int
          }
        }
        licenseType = "string"
        networkProfile = {
          healthProbe = {
            id = "string"
          }
          networkApiVersion = "string"
          networkInterfaceConfigurations = [
            {
              name = "string"
              properties = {
                deleteOption = "string"
                disableTcpStateTracking = bool
                dnsSettings = {
                  dnsServers = [
                    "string"
                  ]
                }
                enableAcceleratedNetworking = bool
                enableFpga = bool
                enableIPForwarding = bool
                ipConfigurations = [
                  {
                    name = "string"
                    properties = {
                      applicationGatewayBackendAddressPools = [
                        {
                          id = "string"
                        }
                      ]
                      applicationSecurityGroups = [
                        {
                          id = "string"
                        }
                      ]
                      loadBalancerBackendAddressPools = [
                        {
                          id = "string"
                        }
                      ]
                      loadBalancerInboundNatPools = [
                        {
                          id = "string"
                        }
                      ]
                      primary = bool
                      privateIPAddressVersion = "string"
                      publicIPAddressConfiguration = {
                        name = "string"
                        properties = {
                          deleteOption = "string"
                          dnsSettings = {
                            domainNameLabel = "string"
                          }
                          idleTimeoutInMinutes = int
                          ipTags = [
                            {
                              ipTagType = "string"
                              tag = "string"
                            }
                          ]
                          publicIPAddressVersion = "string"
                          publicIPPrefix = {
                            id = "string"
                          }
                        }
                        sku = {
                          name = "string"
                          tier = "string"
                        }
                      }
                      subnet = {
                        id = "string"
                      }
                    }
                  }
                ]
                networkSecurityGroup = {
                  id = "string"
                }
                primary = bool
              }
            }
          ]
        }
        osProfile = {
          adminPassword = "string"
          adminUsername = "string"
          allowExtensionOperations = bool
          computerNamePrefix = "string"
          customData = "string"
          linuxConfiguration = {
            disablePasswordAuthentication = bool
            enableVMAgentPlatformUpdates = bool
            patchSettings = {
              assessmentMode = "string"
              automaticByPlatformSettings = {
                rebootSetting = "string"
              }
              patchMode = "string"
            }
            provisionVMAgent = bool
            ssh = {
              publicKeys = [
                {
                  keyData = "string"
                  path = "string"
                }
              ]
            }
          }
          requireGuestProvisionSignal = bool
          secrets = [
            {
              sourceVault = {
                id = "string"
              }
              vaultCertificates = [
                {
                  certificateStore = "string"
                  certificateUrl = "string"
                }
              ]
            }
          ]
          windowsConfiguration = {
            additionalUnattendContent = [
              {
                componentName = "Microsoft-Windows-Shell-Setup"
                content = "string"
                passName = "OobeSystem"
                settingName = "string"
              }
            ]
            enableAutomaticUpdates = bool
            enableVMAgentPlatformUpdates = bool
            patchSettings = {
              assessmentMode = "string"
              automaticByPlatformSettings = {
                rebootSetting = "string"
              }
              enableHotpatching = bool
              patchMode = "string"
            }
            provisionVMAgent = bool
            timeZone = "string"
            winRM = {
              listeners = [
                {
                  certificateUrl = "string"
                  protocol = "string"
                }
              ]
            }
          }
        }
        priority = "string"
        scheduledEventsProfile = {
          osImageNotificationProfile = {
            enable = bool
            notBeforeTimeout = "string"
          }
          terminateNotificationProfile = {
            enable = bool
            notBeforeTimeout = "string"
          }
        }
        securityProfile = {
          encryptionAtHost = bool
          securityType = "string"
          uefiSettings = {
            secureBootEnabled = bool
            vTpmEnabled = bool
          }
        }
        serviceArtifactReference = {
          id = "string"
        }
        storageProfile = {
          dataDisks = [
            {
              caching = "string"
              createOption = "string"
              deleteOption = "string"
              diskIOPSReadWrite = int
              diskMBpsReadWrite = int
              diskSizeGB = int
              lun = int
              managedDisk = {
                diskEncryptionSet = {
                  id = "string"
                }
                securityProfile = {
                  diskEncryptionSet = {
                    id = "string"
                  }
                  securityEncryptionType = "string"
                }
                storageAccountType = "string"
              }
              name = "string"
              writeAcceleratorEnabled = bool
            }
          ]
          diskControllerType = "string"
          imageReference = {
            communityGalleryImageId = "string"
            id = "string"
            offer = "string"
            publisher = "string"
            sharedGalleryImageId = "string"
            sku = "string"
            version = "string"
          }
          osDisk = {
            caching = "string"
            createOption = "string"
            deleteOption = "string"
            diffDiskSettings = {
              option = "string"
              placement = "string"
            }
            diskSizeGB = int
            image = {
              uri = "string"
            }
            managedDisk = {
              diskEncryptionSet = {
                id = "string"
              }
              securityProfile = {
                diskEncryptionSet = {
                  id = "string"
                }
                securityEncryptionType = "string"
              }
              storageAccountType = "string"
            }
            name = "string"
            osType = "string"
            vhdContainers = [
              "string"
            ]
            writeAcceleratorEnabled = bool
          }
        }
        userData = "string"
      }
      zoneBalance = bool
    }
  })
}

屬性值

AdditionalCapabilities

名字 描述 價值
hibernationEnabled 啟用或停用 VM 上休眠功能的旗標。 bool
ultraSSDEnabled 旗標,可讓或停用在 VM 或 VMSS 上具有一或多個具有 UltraSSD_LRS記憶體帳戶類型的受控數據磁碟。 只有啟用此屬性,才能將具有記憶體帳戶類型的受控磁碟UltraSSD_LRS新增至虛擬機或虛擬機擴展集。 bool

AdditionalUnattendContent

名字 描述 價值
componentName 元件名稱。 目前,唯一允許的值是 Microsoft-Windows-Shell-Setup。 'Microsoft-Windows-Shell-Setup'
內容 指定新增至指定路徑和元件之 unattend.xml 檔案的 XML 格式化內容。 XML 必須小於 4KB,而且必須包含要插入之設定或功能的根元素。 字串
passName 傳遞名稱。 目前唯一允許的值是 OobeSystem。 'OobeSystem'
settingName 指定套用內容之設定的名稱。 可能的值為:FirstLogonCommands 和 AutoLogon。 'AutoLogon'
'FirstLogonCommands'

ApiEntityReference

名字 描述 價值
id 以 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... 格式的 ARM 資源標識符 字串

ApplicationProfile

名字 描述 價值
galleryApplications 指定應該提供給 VM/VMSS 的資源庫應用程式 VMGalleryApplication[]

AutomaticOSUpgradePolicy

名字 描述 價值
disableAutomaticRollback 是否應停用OS映像復原功能。 默認值為 false。 bool
enableAutomaticOSUpgrade 指出當較新版本的OS映像可用時,是否應該以滾動方式自動套用作業系統升級至擴展集實例。 默認值為 false。

如果 Windows 擴展集設為 true,enableAutomaticUpdates 會自動設定為 false,且無法設定為 true。
bool
useRollingUpgradePolicy 指出是否應在自動OS升級期間使用滾動升級原則。 默認值為 false。 如果未在 VMSS 上定義任何原則,自動 OS 升級將會回復為默認原則。 bool

AutomaticRepairsPolicy

名字 描述 價值
啟用 指定是否應在虛擬機擴展集上啟用自動修復。 默認值為 false。 bool
gracePeriod 由於 VM 上的狀態變更,自動修復暫停的時間量。 寬限時間會在狀態變更完成之後開始。 這有助於避免過早或意外修復。 持續時間應以 ISO 8601 格式指定。 允許的最小寬限期為 10 分鐘(PT10M),這也是預設值。 允許的寬限期上限為 90 分鐘(PT90M)。 字串
repairAction 將用於修復擴展集中狀況不良虛擬機的修復動作類型(取代、重新啟動、重新安裝映像)。 預設值為 replace。 'Reimage'
'Replace'
'Restart'

BillingProfile

名字 描述 價值
maxPrice 指定您願意為 Azure Spot VM/VMSS 付費的最高價格。 這個價格以美元為單位。

此價格會與 VM 大小的目前 Azure Spot 價格進行比較。 此外,價格會在建立/更新 Azure Spot VM/VMSS 時進行比較,只有在 maxPrice 大於目前的 Azure Spot 價格時,作業才會成功。

如果目前的 Azure Spot 價格超出建立 VM/VMSS 之後的 maxPrice,maxPrice 也會用於收回 Azure Spot VM/VMSS。

可能的值為:

- 任何大於零的十進位值。 範例:0.01538

-1 – 表示預設價格 up-to 隨選。

您可以將 maxPrice 設定為 -1,表示基於價格原因,不應收回 Azure Spot VM/VMSS。 此外,如果預設的最大價格不是由您提供,則為 -1。

API 版本下限:2019-03-01。
int

BootDiagnostics

名字 描述 價值
啟用 是否應在虛擬機上啟用開機診斷。 bool
storageUri 用來放置主控台輸出和螢幕快照的記憶體帳戶 URI。

如果在啟用開機診斷時未指定 storageUri,則會使用受控記憶體。
字串

CapacityReservationProfile

名字 描述 價值
capacityReservationGroup 指定容量保留群組資源標識符,該標識元應該用於配置已保留足夠容量的虛擬機或擴展集 VM 實例。 如需詳細資訊, https://aka.ms/CapacityReservation 請參閱 。 SubResource

DiagnosticsProfile

名字 描述 價值
bootDiagnostics 開機診斷是一項偵錯功能,可讓您檢視控制台輸出和螢幕快照來診斷 VM 狀態。
NOTE:如果指定 storageUri,請確定記憶體帳戶位於與 VM 相同的區域和訂用帳戶中。

您可以輕鬆地檢視主控台記錄的輸出。

Azure 也可讓您從 Hypervisor 查看 VM 的螢幕快照。
BootDiagnostics

DiffDiskSettings

名字 描述 價值
選擇 指定作業系統磁碟的暫時磁碟設定。 'Local'
放置 指定作業系統磁碟的暫時磁碟位置。

可能的值為:

CacheDisk

ResourceDisk

默認值:如果已針對 VM 大小設定快取Disk ,否則會使用 resourceDisk

請參閱 /azure/virtual-machines/windows/size 和 Linux VM 在 /azure/virtual-machines/linux/size 上 Windows VM 的 VM 大小檔,以檢查哪些 VM 大小會公開快取磁碟。
'CacheDisk'
'ResourceDisk'

DiskEncryptionSetParameters

名字 描述 價值
id 資源標識碼 字串

ExtendedLocation

名字 描述 價值
名字 擴充位置的名稱。 字串
類型 擴充位置的類型。 'EdgeZone'

ImageReference

名字 描述 價值
communityGalleryImageId 指定 vm 部署的社群資源庫映像唯一標識碼。 這可以從社群資源庫映像 GET 呼叫擷取。 字串
id 資源標識碼 字串
提供 指定用來建立虛擬機的平臺映像或市集映像供應專案。 字串
發行人 映像發行者。 字串
sharedGalleryImageId 指定 vm 部署的共享資源庫映像唯一標識碼。 這可以從共用資源庫映像 GET 呼叫擷取。 字串
sku 映像 SKU。 字串
版本 指定用來建立虛擬機的平臺映像或市集映像版本。 允許的格式為 Major.Minor.Build 或 'latest'。 主要、次要和組建是十進位數。 指定 'latest' 以在部署時間使用可用映像的最新版本。 即使您使用「最新」,即使有新版本可用,VM 映像也不會在部署時間之後自動更新。 請勿使用欄位 'version' 進行資源庫映射部署,資源庫映射應一律使用 'id' 字段進行部署,若要使用資源庫映射的 'latest' 版本,只要設定 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}' 字段,即可不使用版本輸入。 字串

KeyVaultSecretReference

名字 描述 價值
secretUrl 參考 Key Vault 中秘密的 URL。 字串 (必要)
sourceVault 包含秘密之 Key Vault 的相對 URL。 SubResource (必要)

LinuxConfiguration

名字 描述 價值
disablePasswordAuthentication 指定是否應停用密碼驗證。 bool
enableVMAgentPlatformUpdates 指出是否為Linux虛擬機啟用VMAgent平臺更新。 默認值為 false。 bool
patchSettings [預覽功能]指定與Linux上的VM客體修補相關的設定。 LinuxPatchSettings
provisionVMAgent 指出虛擬機器代理程式是否應該佈建在虛擬機上。

當要求本文中未指定此屬性時,預設行為是將它設定為 true。 這可確保 VM 代理程式已安裝在 VM 上,以便稍後將擴充功能新增至 VM。
bool
ssh 指定 Linux OS 的 SSH 金鑰組態。 SshConfiguration

LinuxPatchSettings

名字 描述 價值
assessmentMode 指定 IaaS 虛擬機的 VM 客體修補評估模式。

可能的值為:

ImageDefault - 您可以在虛擬機上控制修補程式評估的時間。

AutomaticByPlatform - 平台將觸發定期修補程序評估。 屬性 provisionVMAgent 必須為 true。
'AutomaticByPlatform'
'ImageDefault'
automaticByPlatformSettings 在 Linux 上的 VM 客體修補中,指定修補程式模式 AutomaticByPlatform 的其他設定。 LinuxVMGuestPatchAutomaticByPlatformSettings
patchMode 將 VM 客體修補模式指定為彈性的 IaaS 虛擬機或與虛擬機擴展集相關聯的虛擬機。

可能的值為:

ImageDefault - 會使用虛擬機的預設修補組態。

AutomaticByPlatform - 虛擬機將由平台自動更新。 屬性 provisionVMAgent 必須為 true
'AutomaticByPlatform'
'ImageDefault'

LinuxVMGuestPatchAutomaticByPlatformSettings

名字 描述 價值
rebootSetting 指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。 'Always'
'IfRequired'
'Never'
'Unknown'

Microsoft.Compute/virtualMachineScaleSets

名字 描述 價值
extendedLocation 虛擬機擴展集的擴充位置。 ExtendedLocation
身份 如果已設定,則為虛擬機擴展集的身分識別。 VirtualMachineScaleSetIdentity
位置 資源位置 字串 (必要)
名字 資源名稱 字串 (必要)
計劃 指定用來建立虛擬機之 Marketplace 映像的相關信息。 此元素僅用於市集映像。 您必須先啟用映像以程序設計方式使用,才能從 API 使用市集映射。 在 Azure 入口網站中,尋找您想要使用的市集映像,然後按兩下 [想要以程序設計方式部署]、[開始使用] ->。 輸入任何必要資訊,然後按下 [儲存] 計劃
性能 描述虛擬機擴展集的屬性。 VirtualMachineScaleSetProperties
sku 虛擬機擴展集 SKU。 Sku
標籤 資源標籤 標記名稱和值的字典。
類型 資源類型 “Microsoft.Compute/virtualMachineScaleSets@2022-11-01”
虛擬機擴展集區域。 注意:只有在建立擴展集時,才能設定可用性區域 string[]

OSImageNotificationProfile

名字 描述 價值
使 指定是否啟用或停用OS映像排程事件。 bool
notBeforeTimeout 虛擬機重新映像或升級其操作系統的時間長度,在事件自動核准之前,必須核准OS映射排程事件(逾時)。 設定是以 ISO 8601 格式指定,且值必須是 15 分鐘(PT15M) 字串

PatchSettings

名字 描述 價值
assessmentMode 指定 IaaS 虛擬機的 VM 客體修補評估模式。

可能的值為:

ImageDefault - 您可以在虛擬機上控制修補程式評估的時間。

AutomaticByPlatform - 平台將觸發定期修補程序評估。 屬性 provisionVMAgent 必須為 true。
'AutomaticByPlatform'
'ImageDefault'
automaticByPlatformSettings 指定 Windows 上 VM 客體修補中的 Patch 模式 AutomaticByPlatform 的其他設定。 WindowsVMGuestPatchAutomaticByPlatformSettings
enableHotpatching 可讓客戶修補其 Azure VM,而不需要重新啟動。 針對 enableHotpatching,'provisionVMAgent' 必須設定為 true,且 'patchMode' 必須設定為 'AutomaticByPlatform'。 bool
patchMode 將 VM 客體修補模式指定為彈性的 IaaS 虛擬機或與虛擬機擴展集相關聯的虛擬機。

可能的值為:

手動 - 您可以控制將修補程式的應用程式套用至虛擬機。 您可以手動在 VM 內套用修補程式來執行此動作。 在此模式中,會停用自動更新;屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 false

AutomaticByOS - 作業系統會自動更新虛擬機。 屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 true。

AutomaticByPlatform - 虛擬機會由平台自動更新。 provisionVMAgent 和 WindowsConfiguration.enableAutomaticUpdates 的屬性必須是 true
'AutomaticByOS'
'AutomaticByPlatform'
'Manual'

計劃

名字 描述 價值
名字 方案標識碼。 字串
產品 指定來自市集的映像產品。 這個值與 imageReference 元素下的 Offer 值相同。 字串
promotionCode 促銷碼。 字串
發行人 發行者標識碼。 字串

PriorityMixPolicy

名字 描述 價值
baseRegularPriorityCount 將在此擴展集中建立之一般優先順序 VM 的基數,因為它會相應放大。 int

約束:
最小值 = 0
regularPriorityPercentageAboveBase 達到基底一般優先順序計數之後,VM 實例的百分比預期會使用一般優先順序。 int

約束:
最小值 = 0
最大值 = 100

PublicIPAddressSku

名字 描述 價值
名字 指定公用IP SKU 名稱 'Basic'
'Standard'
指定公用IP SKU層 'Global'
'地區'

ResourceTags

名字 描述 價值

RollingUpgradePolicy

名字 描述 價值
enableCrossZoneUpgrade 允許 VMSS 在建構升級批次時忽略 AZ 界限。 將 Update 網域和 maxBatchInstancePercent 納入考慮,以判斷批次大小。 bool
maxBatchInstancePercent 一個批次中滾動升級同時升級的虛擬機實例總數上限百分比。 由於這是最大值,先前或未來批次中狀況不良的實例可能會導致批次中的實例百分比降低,以確保更高的可靠性。 此參數預設值為 20%。 int

約束:
最小值 = 5
最大值 = 100
maxSurge 建立新的虛擬機來升級擴展集,而不是更新現有的虛擬機。 建立每個批次的新虛擬機之後,將會刪除現有的虛擬機。 bool
maxUnhealthyInstancePercent 擴展集中可同時狀況不良的虛擬機實例總數百分比上限,可能是因為升級而造成狀況不良,或在滾動升級中止之前,在虛擬機健康情況檢查中發現狀況不良狀態。 啟動任何批次之前,會先檢查此條件約束。 此參數預設值為 20%。 int

約束:
最小值 = 5
最大值 = 100
maxUnhealthyUpgradedInstancePercent 可發現處於狀況不良狀態的已升級虛擬機實例百分比上限。 升級每個批次之後,就會進行這項檢查。 如果超過這個百分比,滾動更新就會中止。 此參數預設值為 20%。 int

約束:
最小值 = 0
最大值 = 100
pauseTimeBetweenBatches 完成一個批次中所有虛擬機的更新,以及開始下一個批次之間的等候時間。 持續時間應以 ISO 8601 格式指定。 預設值為 0 秒(PT0S)。 字串
prioritizeUnhealthyInstances 在任何狀況良好的實例之前,升級擴展集中所有狀況不良的實例。 bool
rollbackFailedInstancesOnPolicyBreach 如果違反滾動升級原則,回復實例至先前的模型。 bool

ScaleInPolicy

名字 描述 價值
forceDeletion 此屬性可讓您指定在虛擬機擴展集相應縮小時,是否必須強制刪除選擇移除的虛擬機。(預覽中的功能) bool
規則 調整虛擬機擴展集時要遵循的規則。

可能的值為:

預設 當虛擬機擴展集相應縮小時,如果擴展集是區域性擴展集,則擴展集會先跨區域平衡。 然後,它會盡可能跨容錯網域進行平衡。 在每個容錯網域內,選擇移除的虛擬機將會是不受相應縮小保護的最新虛擬機。

OldestVM 當虛擬機擴展集相應縮小時,將會選擇未受相應縮小保護的最舊虛擬機進行移除。 針對區域性虛擬機擴展集,擴展集會先跨區域進行平衡。 在每個區域內,將會選擇未受保護的最舊虛擬機來移除。

NewestVM 當虛擬機擴展集相應縮小時,將會選擇未受相應縮小保護的最新虛擬機來移除。 針對區域性虛擬機擴展集,擴展集會先跨區域進行平衡。 在每個區域內,將會選擇未受保護的最新虛擬機來移除。

包含任何的字串數組:
'Default'
'NewestVM'
'OldestVM'

ScheduledEventsProfile

名字 描述 價值
osImageNotificationProfile 指定OS映像排程事件相關組態。 OSImageNotificationProfile
terminateNotificationProfile 指定終止已排程的事件相關組態。 TerminateNotificationProfile

SecurityProfile

名字 描述 價值
encryptionAtHost 用戶可以在要求中使用這個屬性來啟用或停用虛擬機或虛擬機擴展集的主機加密。 這會啟用所有磁碟的加密,包括主機本身的資源/暫存磁碟。

默認值:除非資源將此屬性設定為 true,否則將會停用主機的加密。
bool
securityType 指定虛擬機的 SecurityType。 它必須設定為任何指定的值,才能啟用 UefiSettings。

默認值:除非設定此屬性,否則不會啟用 UefiSettings。
'ConfidentialVM'
'TrustedLaunch'
uefiSettings 指定建立虛擬機時所使用的安全開機和 vTPM 等安全性設定。

API 版本下限:2020-12-01
UefiSettings

ServiceArtifactReference

名字 描述 價值
id 服務成品參考標識符的格式為 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} 字串

Sku

名字 描述 價值
能力 指定擴展集中的虛擬機數目。 int
名字 SKU 名稱。 字串
指定擴展集中虛擬機的層級。

可能的值:

Standard

基本
字串

SpotRestorePolicy

名字 描述 價值
啟用 啟用 Spot-Try-Restore 功能,其中將嘗試根據容量可用性和定價限制,以機會方式還原收回的 VMSS SPOT 實例 bool
restoreTimeout 以 ISO 8601 時間持續時間表示的逾時值,之後平臺不會嘗試還原 VMSS SPOT 實例 字串

SshConfiguration

名字 描述 價值
publicKeys 用來向Linux型VM進行驗證的SSH公鑰清單。 SshPublicKey[]

SshPublicKey

名字 描述 價值
keyData 用來透過 ssh 向 VM 進行驗證的 SSH 公鑰憑證。 密鑰至少必須是 2048 位,且格式為 ssh-rsa。

如需建立 ssh 金鑰,請參閱 [在 Azure 中建立 Linux 和 Mac 上的 SSH 密鑰]/azure/virtual-machines/linux/create-ssh-keys-detailed。
字串
路徑 指定已建立 VM 上儲存 SSH 公鑰的完整路徑。 如果檔案已經存在,指定的索引鍵會附加至檔案。 範例:/home/user/.ssh/authorized_keys 字串

SubResource

名字 描述 價值
id 資源標識碼 字串

TerminateNotificationProfile

名字 描述 價值
使 指定是否啟用或停用終止排程事件。 bool
notBeforeTimeout 刪除虛擬機的可設定時間長度,在事件自動核准之前,必須先核准終止排程事件(逾時)。 設定必須以 ISO 8601 格式指定,預設值為 5 分鐘(PT5M) 字串

UefiSettings

名字 描述 價值
secureBootEnabled 指定是否應在虛擬機上啟用安全開機。

API 版本下限:2020-12-01
bool
vTpmEnabled 指定是否應在虛擬機上啟用 vTPM。

API 版本下限:2020-12-01
bool

UpgradePolicy

名字 描述 價值
automaticOSUpgradePolicy 用於執行自動OS升級的組態參數。 AutomaticOSUpgradePolicy
模式 指定升級至擴展集中虛擬機的模式。

可能的值為:

手動 - 您可以控制擴充集中虛擬機的更新應用程式。 您可以使用 manualUpgrade 動作來執行此動作。

自動 - 擴展集中的所有虛擬機都會同時自動更新。
'Automatic'
'Manual'
'滾動'
rollingUpgradePolicy 執行滾動升級時所使用的組態參數。 RollingUpgradePolicy

UserAssignedIdentities

名字 描述 價值

UserAssignedIdentitiesValue

名字 描述 價值

VaultCertificate

名字 描述 價值
certificateStore 針對 Windows VM,指定應新增憑證之虛擬機上的證書存儲。 指定的證書存儲隱含在 LocalMachine 帳戶中。

針對 Linux VM,憑證檔案會放在 /var/lib/waagent 目錄底下,檔名 <X509 憑證檔案的大寫Thumbprint>.crt,並針對私鑰 <大寫Thumbprint>.prv。 這兩個檔案都是 .pem 格式。
字串
certificateUrl 這是已上傳至 Key Vault 做為秘密之憑證的 URL。 如需將秘密新增至 Key Vault,請參閱 將金鑰或秘密新增至金鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼,其編碼方式為 UTF-8:

{
“data”:“<Base64 編碼憑證>”,
“dataType”:“pfx”,
“password”:“<pfx-file-password>”
}
若要在虛擬機上安裝憑證,建議使用適用於Linux 的 Azure Key Vault 虛擬機擴充功能,或適用於Windows的 Azure Key Vault 虛擬機擴充功能。
字串

VaultSecretGroup

名字 描述 價值
sourceVault Key Vault 的相對 URL,其中包含 VaultCertificates 中的所有憑證。 SubResource
vaultCertificates SourceVault 中包含憑證的金鑰保存庫參考清單。 VaultCertificate[]

VirtualHardDisk

名字 描述 價值
uri 指定虛擬硬碟的 URI。 字串

VirtualMachineScaleSetDataDisk

名字 描述 價值
緩存 指定快取需求。

可能的值為:



ReadOnly

ReadWrite

預設值:標準記憶體 None。進階記憶體的 ReadOnly
'None'
'ReadOnly'
'ReadWrite'
createOption create 選項。 'Attach'
'Empty'
'FromImage' (必要)
deleteOption 指定數據磁碟應該在 VMSS Flex 刪除時刪除或中斷連結(此功能僅適用於具有彈性 OrchestrationMode 的 VMSS)。

可能的值:

刪除 如果使用此值,則會在刪除 VMSS Flex VM 時刪除資料磁碟。

卸離 如果使用此值,則會在刪除 VMSS Flex VM 之後保留數據磁碟。

預設值設定為 Delete
'Delete'
'Detach'
diskIOPSReadWrite 指定受控磁碟 Read-Write IOPS。 只有當 StorageAccountType UltraSSD_LRS時,才應該使用。 如果未指定,則會根據diskSizeGB指派預設值。 int
diskMBpsReadWrite 指定受控磁碟每秒 MB 的頻寬。 只有當 StorageAccountType UltraSSD_LRS時,才應該使用。 如果未指定,則會根據diskSizeGB指派預設值。 int
diskSizeGB 指定以 GB 為單位的空白資料磁碟大小。 這個元素可用來覆寫虛擬機映像中的磁碟大小。

diskSizeGB 是磁碟的位元組數 x 1024^3,值不能大於 1023
int
指定數據磁碟的邏輯單元編號。 這個值是用來識別 VM 內的數據磁碟,因此對於連結至 VM 的每個數據磁碟而言都必須是唯一的。 int (必要)
managedDisk 受控磁碟參數。 VirtualMachineScaleSetManagedDiskParameters
名字 磁碟名稱。 字串
writeAcceleratorEnabled 指定是否應該在磁碟上啟用或停用 writeAccelerator。 bool

VirtualMachineScaleSetExtension

名字 描述 價值
名字 延伸模組的名稱。 字串
性能 描述虛擬機擴展集擴充功能的屬性。 VirtualMachineScaleSetExtensionProperties

VirtualMachineScaleSetExtensionProfile

名字 描述 價值
擴展 虛擬機擴展集子擴充功能資源。 VirtualMachineScaleSetExtension[]
extensionsTimeBudget 指定所有延伸模組要啟動的時間。 持續時間應介於 15 分鐘到 120 分鐘之間(含),且應以 ISO 8601 格式指定。 預設值為90分鐘(PT1H30M)。

API 版本下限:2020-06-01
字串

VirtualMachineScaleSetExtensionProperties

名字 描述 價值
autoUpgradeMinorVersion 指出如果部署期間有新的次要版本,擴充功能是否應該使用較新的次要版本。 不過,部署之後,除非重新部署,否則擴充功能不會升級次要版本,即使此屬性設定為 true 也一定會升級。 bool
enableAutomaticUpgrade 指出如果有較新版本的延伸模組可用,平臺是否應該自動升級延伸模組。 bool
forceUpdateTag 如果提供值,且與先前的值不同,即使延伸模組組態尚未變更,擴充處理程式仍會強制更新。 字串
protectedSettings 延伸模組可以包含 protectedSettings 或 protectedSettingsFromKeyVault 或完全沒有受保護的設定。 任何
protectedSettingsFromKeyVault 以傳址方式傳遞的延伸模組受保護設定,並從金鑰保存庫取用 KeyVaultSecretReference
provisionAfterExtensions 必須布建此延伸模組之後的延伸模組名稱集合。 string[]
發行人 擴充處理程序發行者的名稱。 字串
設置 擴充功能的 Json 格式化公用設定。 任何
suppressFailures 指出延伸模組產生的失敗是否會隱藏(不論此值為何,無法連線到 VM 等作業失敗)。 默認值為 false。 bool
類型 指定延伸模組的類型;例如“CustomScriptExtension”。 字串
typeHandlerVersion 指定文稿處理程式的版本。 字串

VirtualMachineScaleSetHardwareProfile

名字 描述 價值
vmSizeProperties 指定自定義虛擬機大小的屬性。 API 版本下限:2021-11-01。

如需詳細資訊,請遵循 VM 自定義 中的指示。
VMSizeProperties

VirtualMachineScaleSetIdentity

名字 描述 價值
類型 用於虛擬機擴展集的身分識別類型。 類型 'SystemAssigned, UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。 類型 『None』 會從虛擬機擴展集移除任何身分識別。 'None'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities 與虛擬機擴展集相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 UserAssignedIdentities

VirtualMachineScaleSetIPConfiguration

名字 描述 價值
名字 IP 組態名稱。 字串 (必要)
性能 描述虛擬機擴展集網路配置檔的IP組態屬性。 VirtualMachineScaleSetIPConfigurationProperties

VirtualMachineScaleSetIPConfigurationProperties

名字 描述 價值
applicationGatewayBackendAddressPools 指定應用程式閘道後端位址池的參考數位。 擴展集可以參考多個應用程式閘道的後端位址池。 多個擴展集無法使用相同的應用程式閘道。 SubResource[]
applicationSecurityGroups 指定應用程式安全組參考的陣列。 SubResource[]
loadBalancerBackendAddressPools 指定負載平衡器後端位址池的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的後端位址池。 多個擴展集無法使用相同的基本 SKU 負載平衡器。 SubResource[]
loadBalancerInboundNatPools 指定負載平衡器輸入 Nat 集區的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的輸入 nat 集區。 多個擴展集無法使用相同的基本 SKU 負載平衡器。 SubResource[]
主要 指定虛擬機有1個以上的網路介面時的主要網路介面。 bool
privateIPAddressVersion 從 Api-Version 2017-03-30 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 'IPv4'
'IPv6'
publicIPAddressConfiguration publicIPAddressConfiguration。 VirtualMachineScaleSetPublicIPAddressConfiguration
指定子網的識別碼。 ApiEntityReference

VirtualMachineScaleSetIpTag

名字 描述 價值
ipTagType IP 標籤類型。 範例:FirstPartyUsage。 字串
標記 與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 字串

VirtualMachineScaleSetManagedDiskParameters

名字 描述 價值
diskEncryptionSet 指定受控磁碟的客戶受控磁碟加密集資源標識符。 DiskEncryptionSetParameters
securityProfile 指定受控磁碟的安全性配置檔。 VMDiskSecurityProfile
storageAccountType 指定受控磁碟的記憶體帳戶類型。 注意:UltraSSD_LRS只能與數據磁碟搭配使用,因此無法與OS磁碟搭配使用。 'PremiumV2_LRS'
'Premium_LRS'
'Premium_ZRS'
'StandardSSD_LRS'
'StandardSSD_ZRS'
'Standard_LRS'
'UltraSSD_LRS'

VirtualMachineScaleSetNetworkConfiguration

名字 描述 價值
名字 網路組態名稱。 字串 (必要)
性能 描述虛擬機擴展集網路配置檔的IP組態。 VirtualMachineScaleSetNetworkConfigurationProperties

VirtualMachineScaleSetNetworkConfigurationDnsSettings

名字 描述 價值
dnsServers DNS 伺服器 IP 位址清單 string[]

VirtualMachineScaleSetNetworkConfigurationProperties

名字 描述 價值
deleteOption 指定刪除 VM 時網路介面會發生什麼事 'Delete'
'Detach'
disableTcpStateTracking 指定是否停用 tcp 狀態追蹤的網路介面。 bool
dnsSettings 要套用在網路介面上的 DNS 設定。 VirtualMachineScaleSetNetworkConfigurationDnsSettings
enableAcceleratedNetworking 指定網路介面是否已啟用加速網路功能。 bool
enableFpga 指定網路介面是否已啟用 FPGA 網路功能。 bool
enableIPForwarding 是否在此 NIC 上啟用 IP 轉送。 bool
ipConfigurations 指定網路介面的IP組態。 VirtualMachineScaleSetIPConfiguration[] (必要)
networkSecurityGroup 網路安全組。 SubResource
主要 指定虛擬機有1個以上的網路介面時的主要網路介面。 bool

VirtualMachineScaleSetNetworkProfile

名字 描述 價值
healthProbe 負載平衡器探查的參考,用來判斷虛擬機擴展集中實例的健康情況。 參考的格式為:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}'。 ApiEntityReference
networkApiVersion 會指定在具有協調流程模式 「彈性」的虛擬機擴展集網路介面組態中建立網路資源時所使用的Microsoft.Network API 版本 '2020-11-01'
networkInterfaceConfigurations 網路組態的清單。 VirtualMachineScaleSetNetworkConfiguration[]

VirtualMachineScaleSetOSDisk

名字 描述 價值
緩存 指定快取需求。

可能的值為:



ReadOnly

ReadWrite

預設值:標準記憶體 None。進階記憶體的 ReadOnly
'None'
'ReadOnly'
'ReadWrite'
createOption 指定應該如何建立擴展集中的虛擬機。

唯一允許的值是:FromImage \u2013 當您使用映像來建立虛擬機時,會使用此值。 如果您使用平臺映像,則也會使用上述的 imageReference 元素。 如果您使用市集映像,則也會使用先前所述的 plan 元素。
'Attach'
'Empty'
'FromImage' (必要)
deleteOption 指定 VMSS Flex 刪除時是否應該刪除或中斷連結 OS 磁碟(此功能僅適用於具有彈性 OrchestrationMode 的 VMSS)。

可能的值:

刪除 如果使用此值,刪除 VMSS Flex VM 時會刪除 OS 磁碟。

卸離 如果使用此值,則會在刪除 VMSS Flex VM 之後保留 OS 磁碟。

預設值設定為 Delete。 針對暫時 OS 磁碟,預設值會設定為 [刪除]。 使用者無法變更暫時 OS 磁碟的刪除選項。
'Delete'
'Detach'
diffDiskSettings 指定虛擬機擴展集所使用作業系統磁碟的暫時磁碟設定。 DiffDiskSettings
diskSizeGB 指定以 GB 為單位的空白資料磁碟大小。 這個元素可用來覆寫虛擬機映像中的磁碟大小。

diskSizeGB 是磁碟的位元組數 x 1024^3,值不能大於 1023
int
圖像 指定要以擴展集為基礎之 Unmanaged 使用者映像的相關信息。 VirtualHardDisk
managedDisk 受控磁碟參數。 VirtualMachineScaleSetManagedDiskParameters
名字 磁碟名稱。 字串
osType 此屬性可讓您指定從使用者映像或特製化 VHD 建立 VM 時,磁碟包含的 OS 類型。

可能的值為:

Windows

Linux
'Linux'
'Windows'
vhdContainers 指定用來儲存擴展集作業系統磁碟的容器 URL。 string[]
writeAcceleratorEnabled 指定是否應該在磁碟上啟用或停用 writeAccelerator。 bool

VirtualMachineScaleSetOSProfile

名字 描述 價值
adminPassword 指定系統管理員帳戶的密碼。

最小長度 (Windows): 8 個字元

最小長度 (Linux): 6 個字元

長度上限 (Windows): 123 個字元

長度上限(Linux): 72 個字元

複雜性需求:需要滿足下列 4 個條件中的 3 個
字元較低
具有大字元
具有數位
具有特殊字元 (Regex match [\W_])

不允許的值: “abc@123”、“P@$$w 0rd”、“P@ssw0rd”、“P@ssword123”、“Pa$$word”、“pass@word1”、“Password!”、“Password1”、“Password22”、“iloveyou!”

如需重設密碼,請參閱 如何在 Windows VM 中重設遠端桌面服務或其登入密碼

如需重設根密碼,請參閱 使用 VMAccess 擴充功能 管理使用者、SSH 及檢查或修復 Azure Linux VM 上的磁碟
字串

約束:
敏感性值。 以安全參數的形式傳入。
adminUsername 指定系統管理員帳戶的名稱。

僅限 Windows 的限制: 不能以 “” 結尾。

不允許的值: “administrator”、“admin”、“user”、“user1”、“test”、“user2”、“test1”、“user3”、“admin1”、“1” “123”、“a”、“actuser”、“adm”、“admin2”、“aspnet”、“backup”、“console”、“david”、“guest”、“john”、“owner”、“root”、“server”、“sql”、“support”、“support_388945a0”、“sys”、“test2”、“test3”、“user4”、“user5”。

最小長度 (Linux): 1 個字元

最大長度 (Linux): 64 個字元

長度上限 (Windows): 20 個字元
字串
allowExtensionOperations 指定虛擬機擴展集上是否應該允許擴充功能作業。

只有在虛擬機擴展集上沒有擴充功能時,才會將此選項設定為 False。
bool
computerNamePrefix 指定擴展集中所有虛擬機的計算機名稱前置詞。 計算機名稱前置詞長度必須為1到15個字元。 字串
customData 指定自訂數據的base-64編碼字串。 base-64 編碼字串會譯碼為儲存為虛擬機上檔案的二進位數組。 二進位陣列的最大長度為65535個字節。

如需針對 VM 使用 cloud-init,請參閱在建立期間使用 cloud-init 自定義 Linux VM
字串
linuxConfiguration 指定虛擬機上的Linux作業系統設定。

如需支援的 Linux 發行版清單,請參閱 Azure-Endorsed 發行版上的 Linux
LinuxConfiguration
requireGuestProvisionSignal 必須設定為 True 或省略的選擇性屬性。 bool
秘密 指定應該安裝在擴展集中虛擬機上的憑證集。 若要在虛擬機上安裝憑證,建議使用適用於Linux 的 Azure Key Vault 虛擬機擴充功能,或適用於Windows的 Azure Key Vault 虛擬機擴充功能。 VaultSecretGroup[]
windowsConfiguration 指定虛擬機上的 Windows 作業系統設定。 WindowsConfiguration

VirtualMachineScaleSetProperties

名字 描述 價值
additionalCapabilities 指定在虛擬機擴展集的虛擬機上啟用或停用的其他功能。 例如:虛擬機是否能夠支援使用UltraSSD_LRS記憶體帳戶類型鏈接受控數據磁碟。 AdditionalCapabilities
automaticRepairsPolicy 自動修復的原則。 AutomaticRepairsPolicy
constrainedMaximumCapacity 必須設定為 True 或省略的選擇性屬性。 bool
doNotRunExtensionsOnOverprovisionedVMs 啟用 Overprovision 時,只會在最後保留的要求 VM 數目上啟動擴充功能。 因此,這個屬性可確保延伸模組不會在額外的過度布建 VM 上執行。 bool
hostGroup 指定虛擬機擴展集所在專用主機群組的相關信息。

API 版本下限:2020-06-01。
SubResource
orchestrationMode 指定虛擬機擴展集的協調流程模式。 '彈性'
'Uniform'
overprovision 指定虛擬機擴展集是否應該過度布建。 bool
platformFaultDomainCount 每個放置群組的容錯網域計數。 int
priorityMixPolicy 指定在相同 VMSS Flex 實例內混合 Spot 和一般優先順序 VM 所需的目標。 PriorityMixPolicy
proximityPlacementGroup 指定應該指派虛擬機擴展集之鄰近放置群組的相關信息。

API 版本下限:2018-04-01。
SubResource
scaleInPolicy 指定在虛擬機擴展集中調整虛擬機時所套用的原則。 ScaleInPolicy
singlePlacementGroup 若為 true,這會將擴展集限制為單一放置群組,大小上限為 100 部虛擬機。 注意:如果 singlePlacementGroup 為 true,它可能會修改為 false。 不過,如果 singlePlacementGroup 為 false,它可能不會修改為 true。 bool
spotRestorePolicy 指定虛擬機擴展集的Spot Restore 屬性。 SpotRestorePolicy
upgradePolicy 升級原則。 UpgradePolicy
virtualMachineProfile 虛擬機器配置檔。 VirtualMachineScaleSetVMProfile
zoneBalance 如果發生區域中斷,是否要強制甚至虛擬機散發跨 x 區域。 只有在擴展集的區域屬性包含多個區域時,才能設定 zoneBalance 屬性。 如果沒有區域或只有一個指定區域,則不應該設定 zoneBalance 屬性。 bool

VirtualMachineScaleSetPublicIPAddressConfiguration

名字 描述 價值
名字 publicIP 位址組態名稱。 字串 (必要)
性能 描述虛擬機擴展集IP組態的PublicIPAddress組態 VirtualMachineScaleSetPublicIPAddressConfigurationProperties
sku 描述公用IP Sku。 它只能將 OrchestrationMode 設定為彈性。 PublicIPAddressSku

VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings

名字 描述 價值
domainNameLabel 功能變數名稱標籤。功能變數名稱標籤和 VM 索引的串連將是將要建立之 PublicIPAddress 資源的功能變數名稱標籤 字串 (必要)

VirtualMachineScaleSetPublicIPAddressConfigurationProperties

名字 描述 價值
deleteOption 指定刪除 VM 時,公用 IP 會發生什麼事 'Delete'
'Detach'
dnsSettings 要套用至 publicIP 位址的 DNS 設定。 VirtualMachineScaleSetPublicIPAddressConfigurationDnsSettings
idleTimeoutInMinutes 公用IP位址的閒置逾時。 int
ipTags 與公用IP位址相關聯的IP標籤清單。 VirtualMachineScaleSetIpTag[]
publicIPAddressVersion 從 Api-Version 2019-07-01 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 'IPv4'
'IPv6'
publicIPPrefix 要從中配置 publicIP 位址的 PublicIPPrefix。 SubResource

VirtualMachineScaleSetStorageProfile

名字 描述 價值
dataDisks 指定參數,用來將數據磁碟新增至擴展集中的虛擬機。

如需磁碟的詳細資訊,請參閱 關於 Azure 虛擬機器的磁碟和 VHD
VirtualMachineScaleSetDataDisk[]
diskControllerType 字串
imageReference 指定要使用之映像的相關信息。 您可以指定平臺映像、市集映像或虛擬機映像的相關信息。 當您想要使用平臺映像、市集映像或虛擬機映像,但未用於其他建立作業時,則需要此元素。 ImageReference
osDisk 指定擴展集中虛擬機所使用的操作系統磁碟相關信息。

如需磁碟的詳細資訊,請參閱 關於 Azure 虛擬機器的磁碟和 VHD
VirtualMachineScaleSetOSDisk

VirtualMachineScaleSetVMProfile

名字 描述 價值
applicationProfile 指定應該提供給 VM/VMSS 的資源庫應用程式 ApplicationProfile
billingProfile 指定 Azure Spot VMSS 的計費相關詳細數據。

API 版本下限:2019-03-01。
BillingProfile
capacityReservation 指定擴展集的容量保留相關詳細數據。

API 版本下限:2021-04-01。
CapacityReservationProfile
diagnosticsProfile 指定開機診斷設定狀態。

API 版本下限:2015-06-15。
DiagnosticsProfile
evictionPolicy 指定 Azure Spot 虛擬機和 Azure Spot 擴展集的收回原則。

針對 Azure Spot 虛擬機,支援「解除分配」和「刪除」,且最低 API 版本為 2019-03-01。

針對 Azure Spot 擴展集,支援「解除分配」和「刪除」,且最低 API 版本為 2017-10-30-preview。
'Deallocate'
'Delete'
extensionProfile 指定擴展集中虛擬機上所安裝延伸模組的設定集合。 VirtualMachineScaleSetExtensionProfile
hardwareProfile 指定擴展集的硬體配置檔相關詳細數據。

API 版本下限:2021-11-01。
VirtualMachineScaleSetHardwareProfile
licenseType 指定所使用的映像或磁碟已獲內部部署授權。

Windows Server 操作系統的可能值為:

Windows_Client

Windows_Server

Linux Server 操作系統的可能值為:

RHEL_BYOS (RHEL)

SLES_BYOS (適用於 SUSE)

如需詳細資訊,請參閱 適用於 Windows Server 的 Azure Hybrid Use Benefit

適用於Linux Server的 Azure Hybrid Use Benefit

API 版本下限:2015-06-15
字串
networkProfile 指定擴展集中虛擬機網路介面的屬性。 VirtualMachineScaleSetNetworkProfile
osProfile 指定擴展集中虛擬機的作業系統設定。 VirtualMachineScaleSetOSProfile
優先權 指定擴展集中虛擬機的優先順序。

最低 api-version:2017-10-30-preview
'Low'
'Regular'
'Spot'
scheduledEventsProfile 指定排程的事件相關組態。 ScheduledEventsProfile
securityProfile 指定擴展集中虛擬機的安全性相關配置檔設定。 SecurityProfile
serviceArtifactReference 指定使用 'latest' 映射版本時,用來為擴展集中所有虛擬機設定相同映像版本的服務成品參考標識符。 API 版本下限:2022-11-01 ServiceArtifactReference
storageProfile 指定虛擬機磁碟的記憶體設定。 VirtualMachineScaleSetStorageProfile
userData 擴展集中虛擬機的UserData,其必須是base-64編碼。 客戶不應在此傳遞任何秘密。

API 版本下限:2021-03-01
字串

VMDiskSecurityProfile

名字 描述 價值
diskEncryptionSet 針對客戶受控密鑰加密的機密VM OS 磁碟和 VMGuest Blob 所使用的受控磁碟,指定客戶受控磁碟加密集資源識別碼。 DiskEncryptionSetParameters
securityEncryptionType 指定受控磁碟的 EncryptionType。
它設定為 DiskWithVMGuestState 以加密受控磁碟以及 VMGuestState Blob,而 VMGuestStateOnly 則只會加密 VMGuestState Blob。

注意:只能針對機密 VM 進行設定。
'DiskWithVMGuestState'
'VMGuestStateOnly'

VMGalleryApplication

名字 描述 價值
configurationReference 選擇性,指定 Azure Blob 的 URI,如果提供的話,將會取代套件的預設組態 字串
enableAutomaticUpgrade 如果設定為 true,當 PIR/SIG 中提供新的資源庫應用程式版本時,VM/VMSS 會自動更新它 bool
次序 選擇性,指定必須安裝套件的順序 int
packageReferenceId 指定 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/applications/{application}/versions/{version} 形式的 GalleryApplicationVersion 資源標識符 字串 (必要)
標籤 選擇性,指定更多泛型內容的傳遞值。 字串
treatFailureAsDeploymentFailure 選擇性,如果為 true,VmApplication 中任何作業的任何失敗都會使部署失敗 bool

VMSizeProperties

名字 描述 價值
vCPUUsAvailable 指定 VM 可用的 vCPU 數目。

當要求本文中未指定此屬性時,預設行為是將它設定為 api 回應中公開的 vCPU 值,列出區域中所有可用的虛擬機大小
int
vCPUUsPerCore 指定 vCPU 與實體核心比率。

當要求本文中未指定此屬性時,預設行為會針對 api 回應中公開的 VM 大小設定為 vCPUUsPerCore 的值,列出區域中所有可用的虛擬機大小

將此屬性設定為 1 也表示已停用超線程處理。
int

WindowsConfiguration

名字 描述 價值
additionalUnattendContent 指定其他base-64編碼的 XML 格式資訊,這些資訊可以包含在 Windows 安裝程式所使用的 Unattend.xml 檔案中。 AdditionalUnattendContent[]
enableAutomaticUpdates 指出是否為 Windows 虛擬機啟用自動更新。 默認值為 true。

針對虛擬機擴展集,此屬性可以更新,更新將會在OS重新佈建上生效。
bool
enableVMAgentPlatformUpdates 指出是否為 Windows 虛擬機啟用 VMAgent 平臺更新。 默認值為 false。 bool
patchSettings [預覽功能]指定與 Windows 上的 VM 客體修補相關的設定。 PatchSettings
provisionVMAgent 指出虛擬機器代理程式是否應該佈建在虛擬機上。

當要求本文中未指定此屬性時,預設行為是將它設定為 true。 這可確保 VM 代理程式已安裝在 VM 上,以便稍後將擴充功能新增至 VM。
bool
timeZone 指定虛擬機的時區。 例如「太平洋標準時間」。

可能的值可以從 TimeZoneInfo.GetSystemTimeZones傳回的時區 TimeZoneInfo.Id 值。
字串
winRM 指定 Windows 遠端管理接聽程式。 這可啟用遠端 Windows PowerShell。 WinRMConfiguration

WindowsVMGuestPatchAutomaticByPlatformSettings

名字 描述 價值
rebootSetting 指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。 'Always'
'IfRequired'
'Never'
'Unknown'

WinRMConfiguration

名字 描述 價值
聽眾 Windows 遠端管理接聽程式清單 WinRMListener[]

WinRMListener

名字 描述 價值
certificateUrl 這是已上傳至 Key Vault 做為秘密之憑證的 URL。 如需將秘密新增至 Key Vault,請參閱 將金鑰或秘密新增至金鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼,其編碼方式為 UTF-8:

{
“data”:“<Base64 編碼憑證>”,
“dataType”:“pfx”,
“password”:“<pfx-file-password>”
}
若要在虛擬機上安裝憑證,建議使用適用於Linux 的 Azure Key Vault 虛擬機擴充功能,或適用於Windows的 Azure Key Vault 虛擬機擴充功能。
字串
協定 指定 WinRM 接聽程式的通訊協定。

可能的值為:
http

https
'Http'
'Https'