Microsoft.Compute virtualMachines 2023-09-01
Bicep 資源定義
virtualMachines 資源類型可以使用目標作業來部署:
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄。
資源格式
若要建立 Microsoft.Compute/virtualMachines 資源,請將下列 Bicep 新增至您的範本。
resource symbolicname 'Microsoft.Compute/virtualMachines@2023-09-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
extendedLocation: {
name: 'string'
type: 'EdgeZone'
}
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
{customized property}: {}
}
}
plan: {
name: 'string'
product: 'string'
promotionCode: 'string'
publisher: 'string'
}
properties: {
additionalCapabilities: {
hibernationEnabled: bool
ultraSSDEnabled: bool
}
applicationProfile: {
galleryApplications: [
{
configurationReference: 'string'
enableAutomaticUpgrade: bool
order: int
packageReferenceId: 'string'
tags: 'string'
treatFailureAsDeploymentFailure: bool
}
]
}
availabilitySet: {
id: 'string'
}
billingProfile: {
maxPrice: json('decimal-as-string')
}
capacityReservation: {
capacityReservationGroup: {
id: 'string'
}
}
diagnosticsProfile: {
bootDiagnostics: {
enabled: bool
storageUri: 'string'
}
}
evictionPolicy: 'string'
extensionsTimeBudget: 'string'
hardwareProfile: {
vmSize: 'string'
vmSizeProperties: {
vCPUsAvailable: int
vCPUsPerCore: int
}
}
host: {
id: 'string'
}
hostGroup: {
id: 'string'
}
licenseType: 'string'
networkProfile: {
networkApiVersion: '2020-11-01'
networkInterfaceConfigurations: [
{
name: 'string'
properties: {
auxiliaryMode: 'string'
auxiliarySku: 'string'
deleteOption: 'string'
disableTcpStateTracking: bool
dnsSettings: {
dnsServers: [
'string'
]
}
dscpConfiguration: {
id: 'string'
}
enableAcceleratedNetworking: bool
enableFpga: bool
enableIPForwarding: bool
ipConfigurations: [
{
name: 'string'
properties: {
applicationGatewayBackendAddressPools: [
{
id: 'string'
}
]
applicationSecurityGroups: [
{
id: 'string'
}
]
loadBalancerBackendAddressPools: [
{
id: 'string'
}
]
primary: bool
privateIPAddressVersion: 'string'
publicIPAddressConfiguration: {
name: 'string'
properties: {
deleteOption: 'string'
dnsSettings: {
domainNameLabel: 'string'
domainNameLabelScope: 'string'
}
idleTimeoutInMinutes: int
ipTags: [
{
ipTagType: 'string'
tag: 'string'
}
]
publicIPAddressVersion: 'string'
publicIPAllocationMethod: 'string'
publicIPPrefix: {
id: 'string'
}
}
sku: {
name: 'string'
tier: 'string'
}
}
subnet: {
id: 'string'
}
}
}
]
networkSecurityGroup: {
id: 'string'
}
primary: bool
}
}
]
networkInterfaces: [
{
id: 'string'
properties: {
deleteOption: 'string'
primary: bool
}
}
]
}
osProfile: {
adminPassword: 'string'
adminUsername: 'string'
allowExtensionOperations: bool
computerName: 'string'
customData: 'string'
linuxConfiguration: {
disablePasswordAuthentication: bool
enableVMAgentPlatformUpdates: bool
patchSettings: {
assessmentMode: 'string'
automaticByPlatformSettings: {
bypassPlatformSafetyChecksOnUserSchedule: bool
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: {
bypassPlatformSafetyChecksOnUserSchedule: bool
rebootSetting: 'string'
}
enableHotpatching: bool
patchMode: 'string'
}
provisionVMAgent: bool
timeZone: 'string'
winRM: {
listeners: [
{
certificateUrl: 'string'
protocol: 'string'
}
]
}
}
}
platformFaultDomain: int
priority: 'string'
proximityPlacementGroup: {
id: 'string'
}
scheduledEventsProfile: {
osImageNotificationProfile: {
enable: bool
notBeforeTimeout: 'string'
}
terminateNotificationProfile: {
enable: bool
notBeforeTimeout: 'string'
}
}
securityProfile: {
encryptionAtHost: bool
encryptionIdentity: {
userAssignedIdentityResourceId: 'string'
}
proxyAgentSettings: {
enabled: bool
keyIncarnationId: int
mode: 'string'
}
securityType: 'string'
uefiSettings: {
secureBootEnabled: bool
vTpmEnabled: bool
}
}
storageProfile: {
dataDisks: [
{
caching: 'string'
createOption: 'string'
deleteOption: 'string'
detachOption: 'ForceDetach'
diskSizeGB: int
image: {
uri: 'string'
}
lun: int
managedDisk: {
diskEncryptionSet: {
id: 'string'
}
id: 'string'
securityProfile: {
diskEncryptionSet: {
id: 'string'
}
securityEncryptionType: 'string'
}
storageAccountType: 'string'
}
name: 'string'
toBeDetached: bool
vhd: {
uri: '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: 'Local'
placement: 'string'
}
diskSizeGB: int
encryptionSettings: {
diskEncryptionKey: {
secretUrl: 'string'
sourceVault: {
id: 'string'
}
}
enabled: bool
keyEncryptionKey: {
keyUrl: 'string'
sourceVault: {
id: 'string'
}
}
}
image: {
uri: 'string'
}
managedDisk: {
diskEncryptionSet: {
id: 'string'
}
id: 'string'
securityProfile: {
diskEncryptionSet: {
id: 'string'
}
securityEncryptionType: 'string'
}
storageAccountType: 'string'
}
name: 'string'
osType: 'string'
vhd: {
uri: 'string'
}
writeAcceleratorEnabled: bool
}
}
userData: 'string'
virtualMachineScaleSet: {
id: 'string'
}
}
zones: [
'string'
]
}
屬性值
virtualMachines
名稱 | 描述 | 值 |
---|---|---|
NAME | 資源名稱 | 字串 (必要) 字元限制:1-15 (Windows) 1-64 (Linux) 合法字元: 不能使用空格、控制字元或下列字元: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ? Windows VM 不能包含句號或以連字號結尾。 Linux VM 不能以句號或連字號結尾。 |
location | 資源位置 | 字串 (必要) |
tags | 資源標籤 | 標記名稱和值的字典。 請參閱 範本中的標記 |
extendedLocation | 虛擬機的擴充位置。 | ExtendedLocation |
身分識別 | 如果已設定,則為虛擬機的身分識別。 | VirtualMachineIdentity |
方案 | 指定用來建立虛擬機之 Marketplace 映像的相關信息。 此元素僅用於市集映像。 您必須先啟用映像以程序設計方式使用,才能從 API 使用市集映射。 在 Azure 入口網站 中,尋找您想要使用的市集映像,然後按兩下 [想要以程序設計方式部署][開始使用] ->。 輸入任何必要資訊,然後按兩下 [ 儲存]。 | 方案 |
properties | 描述虛擬機的屬性。 | VirtualMachineProperties |
zones (區域) | 虛擬機區域。 | string[] |
ExtendedLocation
名稱 | 描述 | 值 |
---|---|---|
NAME | 擴充位置的名稱。 | 字串 |
type | 擴充位置的類型。 | 'EdgeZone' |
VirtualMachineIdentity
名稱 | 描述 | 值 |
---|---|---|
類型 | 用於虛擬機的身分識別類型。 「SystemAssigned、UserAssigned」類型同時包含隱含建立的身分識別,和一組使用者指派的身分識別。 類型 『None』 會從虛擬機中移除任何身分識別。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | 與虛擬機相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 | UserAssignedIdentities |
UserAssignedIdentities
名稱 | 描述 | 值 |
---|---|---|
{自定義屬性} | UserAssignedIdentitiesValue | |
{自定義屬性} | UserAssignedIdentitiesValue |
UserAssignedIdentitiesValue
此物件不包含部署期間要設定的任何屬性。 所有屬性都是 ReadOnly。
計畫
名稱 | 描述 | 值 |
---|---|---|
NAME | 方案標識碼。 | 字串 |
產品 | 指定市集中映像的產品。 這與 imageReference 元素下的 Offer 值相同。 | 字串 |
promotionCode | 促銷碼。 | 字串 |
publisher | 發行者標識碼。 | 字串 |
VirtualMachineProperties
名稱 | 描述 | 值 |
---|---|---|
additionalCapabilities | 指定在虛擬機上啟用或停用的其他功能。 | AdditionalCapabilities |
applicationProfile | 指定應該提供給 VM/VMSS 的資源庫應用程式。 | ApplicationProfile |
availabilitySet | 指定虛擬機應指派給的可用性設定組相關信息。 在相同可用性設定組中指定的虛擬機器會配置到不同的節點,以便將可用性最大化。 如需可用性設定組的詳細資訊,請參閱 可用性設定組概觀。 如需 Azure 計劃性維護的詳細資訊,請參閱 Azure 中 虛擬機器 的維護和更新。 目前,VM 只能在建立時新增至可用性設定組。 要新增 VM 的可用性設定組應該位於與可用性設定組資源相同的資源群組之下。 現有的 VM 無法新增至可用性設定組。 此屬性不能與非 Null 屬性一起存在。virtualMachineScaleSet 參考。 | SubResource |
billingProfile | 指定 Azure Spot 虛擬機的計費相關詳細數據。 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 擴展集,同時支援 'Deallocate' 和 'Delete',而最低 API 版本為 2017-10-30-preview。 | 'Deallocate' 'Delete' |
extensionsTimeBudget | 指定要啟動之所有延伸模組加上批注的時間。 持續時間應介於 15 分鐘到 120 分鐘之間, (包含) ,且應以 ISO 8601 格式指定。 預設值為90分鐘 (PT1H30M) 。 API 版本下限:2020-06-01。 | 字串 |
hardwareProfile | 指定虛擬機器的硬體設定。 | HardwareProfile |
主機 | 指定虛擬機所在專用主機的相關信息。 API 版本下限:2018-10-01。 | SubResource |
hostGroup | 指定虛擬機所在專用主機群組的相關信息。 注意: 用戶無法同時指定 host 和 hostGroup 屬性。 API 版本下限:2020-06-01。 | SubResource |
licenseType | 指定正在使用的映像或磁碟是在內部部署授權。 Windows Server 操作系統的可能值為: Windows_Client Windows_Server Linux Server 操作系統的可能值為: RHEL) 的RHEL_BYOS ( SUSE) 的SLES_BYOS ( 如需詳細資訊,請參閱 適用於 Windows Server 的 Azure Hybrid Use Benefit 適用於Linux伺服器的 Azure Hybrid Use Benefit 最低 api-version:2015-06-15 |
字串 |
networkProfile | 指定虛擬機器的網路介面。 | NetworkProfile |
osProfile | 指定建立虛擬機時所使用的作業系統設定。 布建 VM 之後,就無法變更部分設定。 | OSProfile |
platformFaultDomain | 指定要在其中建立虛擬機的擴展集邏輯容錯網域。 根據預設,虛擬機會自動指派給容錯網域,以在可用的容錯網域之間維持平衡。 只有在設定此虛擬機的 'virtualMachineScaleSet' 屬性時,才適用這個屬性。 所參考的虛擬機擴展集必須具有大於 1 的 『platformFaultDomainCount』。 建立虛擬機之後,就無法更新此屬性。 容錯網域指派可以在虛擬機實例檢視中檢視。 最低 api-version:2020?12?01。 | int |
priority | 指定虛擬機的優先順序。 API 版本下限:2019-03-01 | 'Low' 'Regular' 'Spot' |
proximityPlacementGroup | 指定虛擬機應該指派的鄰近放置群組相關信息。 API 版本下限:2018-04-01。 | SubResource |
scheduledEventsProfile | 指定排程的事件相關組態。 | ScheduledEventsProfile |
securityProfile | 指定虛擬機的安全性相關配置檔設定。 | SecurityProfile |
storageProfile | 指定虛擬機器磁碟的儲存體設定。 | StorageProfile |
userData | VM 的 UserData,必須是base-64 編碼。 客戶不應在此傳遞任何秘密。 API 版本下限:2021-03-01。 | 字串 |
virtualMachineScaleSet | 指定虛擬機應指派給之虛擬機擴展集的相關信息。 相同虛擬機擴展集中指定的虛擬機會配置給不同的節點,以最大化可用性。 目前,VM 只能在建立時新增至虛擬機擴展集。 現有的 VM 無法新增至虛擬機擴展集。 這個屬性不能與非 Null properties.availabilitySet 參考一起存在。 最低 api?version:2019?03?01。 | SubResource |
AdditionalCapabilities
名稱 | 描述 | 值 |
---|---|---|
休眠Enabled | 啟用或停用 VM 上休眠功能的旗標。 | bool |
ultraSSDEnabled | 旗標,可啟用或停用在 VM 或 VMSS 上具有一或多個具有 UltraSSD_LRS記憶體帳戶類型的受控數據磁碟。 只有啟用此屬性時,才能將具有記憶體帳戶類型的受控磁碟UltraSSD_LRS新增至虛擬機或虛擬機擴展集。 | bool |
ApplicationProfile
名稱 | 描述 | 值 |
---|---|---|
galleryApplications | 指定應該提供給 VM/VMSS 的資源庫應用程式 | VMGalleryApplication[] |
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 資源標識符 | 字串 (必要) |
tags | 選擇性,指定更多泛型內容的傳遞值。 | 字串 |
treatFailureAsDeploymentFailure | 選擇性,如果為 true,VmApplication 中任何作業的任何失敗都會失敗部署 | bool |
SubResource
名稱 | 描述 | 值 |
---|---|---|
id | 資源標識碼 | 字串 |
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 – 表示預設價格為隨選。 您可以將 maxPrice 設定為 -1,以指出基於價格考慮,不應收回 Azure Spot VM/VMSS。 此外,如果默認價格不是由您提供,則為 -1。 API 版本下限:2019-03-01。 若要指定十進位值,請使用 json () 函式。 |
int 或 json decimal |
CapacityReservationProfile
名稱 | 描述 | 值 |
---|---|---|
capacityReservationGroup | 指定容量保留群組資源標識符,此標識元應該用於配置虛擬機或擴展集 VM 實例,前提是已保留足夠的容量。 如需詳細資訊, https://aka.ms/CapacityReservation 請參閱 。 |
SubResource |
DiagnosticsProfile
名稱 | 描述 | 值 |
---|---|---|
bootDiagnostics | 開機診斷是一項偵錯功能,可讓您檢視控制台輸出和螢幕快照來診斷 VM 狀態。 注意:如果指定 storageUri,請確定記憶體帳戶位於與 VM 相同的區域和訂用帳戶中。 您可以輕鬆地檢視主控台記錄的輸出。 Azure 也可讓您從 Hypervisor 查看 VM 的螢幕快照。 | BootDiagnostics |
BootDiagnostics
名稱 | 描述 | 值 |
---|---|---|
已啟用 | 虛擬機上是否應該啟用開機診斷。 | bool |
storageUri | 用來放置主控台輸出和螢幕快照的記憶體帳戶 URI。 如果在啟用開機診斷時未指定 storageUri,則會使用受控記憶體。 | 字串 |
HardwareProfile
名稱 | 描述 | 值 |
---|---|---|
vmSize | 指定虛擬機器的大小。 列舉數據類型目前已被取代,將於 2023 年 12 月 23 日移除。 取得可用大小清單的建議方式是使用這些 API: 列出可用性設定組中的所有可用虛擬機器大小、 列出區域中的所有可用虛擬機大小、 列出所有可用的虛擬機大小以進行重設大小。 如需虛擬機大小的詳細資訊,請參閱 虛擬機的大小。 可用的 VM 大小取決於區域和可用性設定組。 | 'Basic_A0' 'Basic_A1' 'Basic_A2' 'Basic_A3' 'Basic_A4' 'Standard_A0' 'Standard_A1' 'Standard_A10' 'Standard_A11' 'Standard_A1_v2' 'Standard_A2' 'Standard_A2_v2' 'Standard_A2m_v2' 'Standard_A3' 'Standard_A4' 'Standard_A4_v2' 'Standard_A4m_v2' 'Standard_A5' 'Standard_A6' 'Standard_A7' 'Standard_A8' 'Standard_A8_v2' 'Standard_A8m_v2' 'Standard_A9' 'Standard_B1ms' 'Standard_B1s' 'Standard_B2ms' 'Standard_B2s' 'Standard_B4ms' 'Standard_B8ms' 'Standard_D1' 'Standard_D11' 'Standard_D11_v2' 'Standard_D12' 'Standard_D12_v2' 'Standard_D13' 'Standard_D13_v2' 'Standard_D14' 'Standard_D14_v2' 'Standard_D15_v2' 'Standard_D16_v3' 'Standard_D16s_v3' 'Standard_D1_v2' 'Standard_D2' 'Standard_D2_v2' 'Standard_D2_v3' 'Standard_D2s_v3' 'Standard_D3' 'Standard_D32_v3' 'Standard_D32s_v3' 'Standard_D3_v2' 'Standard_D4' 'Standard_D4_v2' 'Standard_D4_v3' 'Standard_D4s_v3' 'Standard_D5_v2' 'Standard_D64_v3' 'Standard_D64s_v3' 'Standard_D8_v3' 'Standard_D8s_v3' 'Standard_DS1' 'Standard_DS11' 'Standard_DS11_v2' 'Standard_DS12' 'Standard_DS12_v2' 'Standard_DS13' 'Standard_DS13-2_v2' 'Standard_DS13-4_v2' 'Standard_DS13_v2' 'Standard_DS14' 'Standard_DS14-4_v2' 'Standard_DS14-8_v2' 'Standard_DS14_v2' 'Standard_DS15_v2' 'Standard_DS1_v2' 'Standard_DS2' 'Standard_DS2_v2' 'Standard_DS3' 'Standard_DS3_v2' 'Standard_DS4' 'Standard_DS4_v2' 'Standard_DS5_v2' 'Standard_E16_v3' 'Standard_E16s_v3' 'Standard_E2_v3' 'Standard_E2s_v3' 'Standard_E32-16_v3' 'Standard_E32-8s_v3' 'Standard_E32_v3' 'Standard_E32s_v3' 'Standard_E4_v3' 'Standard_E4s_v3' 'Standard_E64-16s_v3' 'Standard_E64-32s_v3' 'Standard_E64_v3' 'Standard_E64s_v3' 'Standard_E8_v3' 'Standard_E8s_v3' 'Standard_F1' 'Standard_F16' 'Standard_F16s' 'Standard_F16s_v2' 'Standard_F1s' 'Standard_F2' 'Standard_F2s' 'Standard_F2s_v2' 'Standard_F32s_v2' 'Standard_F4' 'Standard_F4s' 'Standard_F4s_v2' 'Standard_F64s_v2' 'Standard_F72s_v2' 'Standard_F8' 'Standard_F8s' 'Standard_F8s_v2' 'Standard_G1' 'Standard_G2' 'Standard_G3' 'Standard_G4' 'Standard_G5' 'Standard_GS1' 'Standard_GS2' 'Standard_GS3' 'Standard_GS4' 'Standard_GS4-4' 'Standard_GS4-8' 'Standard_GS5' 'Standard_GS5-16' 'Standard_GS5-8' 'Standard_H16' 'Standard_H16m' 'Standard_H16mr' 'Standard_H16r' 'Standard_H8' 'Standard_H8m' 'Standard_L16s' 'Standard_L32s' 'Standard_L4s' 'Standard_L8s' 'Standard_M128-32ms' 'Standard_M128-64ms' 'Standard_M128ms' 'Standard_M128s' 'Standard_M64-16ms' 'Standard_M64-32ms' 'Standard_M64ms' 'Standard_M64s' 'Standard_NC12' 'Standard_NC12s_v2' 'Standard_NC12s_v3' 'Standard_NC24' 'Standard_NC24r' 'Standard_NC24rs_v2' 'Standard_NC24rs_v3' 'Standard_NC24s_v2' 'Standard_NC24s_v3' 'Standard_NC6' 'Standard_NC6s_v2' 'Standard_NC6s_v3' 'Standard_ND12s' 'Standard_ND24rs' 'Standard_ND24s' 'Standard_ND6s' 'Standard_NV12' 'Standard_NV24' 'Standard_NV6' |
vmSizeProperties | 指定自定義虛擬機大小的屬性。 API 版本下限:2021-07-01。 此功能仍在預覽模式中,且 VirtualMachineScaleSet 不支援此功能。 如需詳細資訊,請遵循 VM 自定義 中的指示。 | VMSizeProperties |
VMSizeProperties
名稱 | 描述 | 值 |
---|---|---|
vCPUAvailable | 指定 VM 可用的 vCPU 數目。 在要求本文中未指定這個屬性時,預設行為是將它設定為 API 回應中公開該 VM 大小的 vCPU 值, 以列出區域中所有可用的虛擬機大小。 | int |
vCPUPerCore | 指定 vCPU 與實體核心比率。 在要求本文中未指定這個屬性時,預設行為會針對在 API 回應中公開的 VM 大小設定為 vCPUPerCore 的值,以 列出區域中所有可用的虛擬機大小。 將此屬性設定為 1 也表示超線程已停用。 | int |
NetworkProfile
名稱 | 描述 | 值 |
---|---|---|
networkApiVersion | 指定在網路介面組態中建立網路資源時所使用的 Microsoft.Network API 版本 | '2020-11-01' |
networkInterfaceConfigurations | 指定將用來建立虛擬機網路資源的網路設定。 | VirtualMachineNetworkInterfaceConfiguration[] |
networkInterfaces | 指定與虛擬機相關聯之網路介面的資源標識符清單。 | NetworkInterfaceReference[] |
VirtualMachineNetworkInterfaceConfiguration
名稱 | 描述 | 值 |
---|---|---|
NAME | 網路介面組態名稱。 | 字串 (必要) |
properties | 描述虛擬機網路配置檔的IP組態。 | VirtualMachineNetworkInterfaceConfigurationPropertie... |
VirtualMachineNetworkInterfaceConfigurationPropertie...
名稱 | 描述 | 值 |
---|---|---|
auxiliaryMode | 指定是否為網路介面資源啟用輔助模式。 | 'AcceleratedConnections' 'Floating' 'None' |
auxiliarySku | 指定是否為網路介面資源啟用輔助 SKU。 | 'A1' 'A2' 'A4' 'A8' 'None' |
deleteOption | 指定刪除 VM 時網路介面會發生什麼事 | 'Delete' 'Detach' |
disableTcpStateTracking | 指定是否停用 tcp 狀態追蹤的網路介面。 | bool |
dnsSettings | 要套用在網路介面上的 DNS 設定。 | VirtualMachineNetworkInterfaceDnsSettingsConfigurati... |
dscpConfiguration | SubResource | |
enableAcceleratedNetworking | 指定網路介面是否已啟用加速網路功能。 | bool |
enableFpga | 指定網路介面是否已啟用 FPGA 網路功能。 | bool |
enableIPForwarding | 是否在此 NIC 上啟用 IP 轉送。 | bool |
ipConfigurations | 指定網路介面的IP組態。 | VirtualMachineNetworkInterfaceIPConfiguration[] (必要) |
networkSecurityGroup | 網路安全組。 | SubResource |
primary | 指定虛擬機有1個以上的網路介面時的主要網路介面。 | bool |
VirtualMachineNetworkInterfaceDnsSettingsConfigurati...
名稱 | 描述 | 值 |
---|---|---|
dnsServers | DNS 伺服器 IP 位址清單 | string[] |
VirtualMachineNetworkInterfaceIPConfiguration
名稱 | 描述 | 值 |
---|---|---|
NAME | IP 組態名稱。 | 字串 (必要) |
properties | 描述虛擬機網路介面IP組態屬性。 | VirtualMachineNetworkInterfaceIPConfigurationPropert... |
VirtualMachineNetworkInterfaceIPConfigurationPropert...
名稱 | 描述 | 值 |
---|---|---|
applicationGatewayBackendAddressPools | 指定應用程式閘道後端位址池的參考數位。 虛擬機可以參考多個應用程式閘道的後端位址池。 多部虛擬機無法使用相同的應用程式閘道。 | SubResource[] |
applicationSecurityGroups | 指定應用程式安全組的參考陣列。 | SubResource[] |
loadBalancerBackendAddressPools | 指定負載平衡器後端位址池參考的陣列。 虛擬機可以參考一個公用和一個內部負載平衡器的後端位址池。 [多部虛擬機無法使用相同的基本 SKU 負載平衡器]。 | SubResource[] |
primary | 指定虛擬機有1個以上的網路介面時的主要網路介面。 | bool |
privateIPAddressVersion | 從 Api-Version 2017-03-30 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 | 'IPv4' 'IPv6' |
publicIPAddressConfiguration | publicIPAddressConfiguration。 | VirtualMachinePublicIPAddressConfiguration |
子網路 | 指定子網的識別碼。 | SubResource |
VirtualMachinePublicIPAddressConfiguration
名稱 | 描述 | 值 |
---|---|---|
NAME | publicIP 位址組態名稱。 | 字串 (必要) |
properties | 描述虛擬機IP組態的PublicIPAddress設定 | VirtualMachinePublicIPAddressConfigurationProperties |
sku | 描述公用IP Sku。 它只能使用 OrchestrationMode 設定為彈性。 | PublicIPAddressSku |
VirtualMachinePublicIPAddressConfigurationProperties
名稱 | 描述 | 值 |
---|---|---|
deleteOption | 指定刪除 VM 時,公用 IP 位址會發生什麼情況 | 'Delete' 'Detach' |
dnsSettings | 要套用至 publicIP 位址的 DNS 設定。 | VirtualMachinePublicIPAddressDnsSettingsConfiguratio... |
idleTimeoutInMinutes | 公用IP位址的閒置逾時。 | int |
ipTags | 與公用IP位址相關聯的IP標籤清單。 | VirtualMachineIpTag[] |
publicIPAddressVersion | 從 Api-Version 2019-07-01 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 | 'IPv4' 'IPv6' |
publicIPAllocationMethod | 指定公用IP配置類型 | 'Dynamic' 'Static' |
publicIPPrefix | 要從中配置 publicIP 位址的 PublicIPPrefix。 | SubResource |
VirtualMachinePublicIPAddressDnsSettingsConfiguratio...
名稱 | 描述 | 值 |
---|---|---|
domainNameLabel | 將建立之 PublicIPAddress 資源的功能變數名稱標籤前置詞。 產生的名稱標籤是功能變數名稱標籤和 vm 網路設定檔唯一識別碼的串連。 | 字串 (必要) |
domainNameLabelScope | 將建立之 PublicIPAddress 資源的功能變數名稱標籤範圍。 產生的名稱標籤是根據功能變數名稱標籤範圍和 vm 網路配置檔唯一識別碼,以原則串連哈希功能變數名稱標籤。 | 'NoReuse' 'ResourceGroupReuse' 'SubscriptionReuse' 'TenantReuse' |
VirtualMachineIpTag
名稱 | 描述 | 值 |
---|---|---|
ipTagType | IP 標籤類型。 範例:FirstPartyUsage。 | 字串 |
標籤 | 與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 | 字串 |
PublicIPAddressSku
名稱 | 描述 | 值 |
---|---|---|
NAME | 指定公用IP SKU 名稱 | 'Basic' 'Standard' |
tier | 指定公用IP SKU層 | 'Global' 'Regional' |
NetworkInterfaceReference
名稱 | 描述 | 值 |
---|---|---|
id | 資源標識碼 | 字串 |
properties | 描述網路介面參考屬性。 | NetworkInterfaceReferenceProperties |
NetworkInterfaceReferenceProperties
名稱 | 描述 | 值 |
---|---|---|
deleteOption | 指定刪除 VM 時網路介面會發生什麼事 | 'Delete' 'Detach' |
primary | 指定虛擬機有1個以上的網路介面時的主要網路介面。 | bool |
OSProfile
名稱 | 描述 | 值 |
---|---|---|
adminPassword | 指定系統管理員帳戶的密碼。 Windows) 長度下限 (: 8 個字元 Linux) 長度下限 (: 6 個字元 Windows) 長度上限 (: 123 個字元 Linux) 長度上限 (: 72 個字元 複雜度需求: 需要滿足下列 4 個條件中的 3 個 字元較低 具有大字元 具有數位 具有特殊字元 (Regex 比對 [\W_]) 不允許的值: “abc@123”、“P@$$w 0rd”、“P@ssw0rd”、“P@ssword123”、“Pa$$word”、“pass@word1”、“Password!”、“Password1”、“Password22”、“iveyou!” 如需重設密碼,請參閱 如何在 Windows VM 中重設遠端桌面服務或其登入密碼 如需重設根密碼,請參閱 使用 VMAccess 擴充功能管理使用者、SSH 及檢查或修復 Azure Linux VM 上的磁碟 |
字串 約束: 敏感性值。 以安全參數的形式傳入。 |
adminUsername | 指定系統管理員帳戶的名稱。 建立 VM 之後,就無法更新此屬性。 僅限 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 |
computerName | 指定虛擬機的主機OS名稱。 建立 VM 之後,就無法更新此名稱。 Windows) 長度上限 (: 15 個字元。 Linux) 長度上限 (: 64 個字元。 如需命名慣例和限制,請參閱 Azure 基礎結構服務實作指導方針。 | 字串 |
customData | 指定自訂資料的 Base-64 編碼字串。 Base-64 編碼字串會解碼成二進位陣列而儲存為虛擬機器上的檔案。 二進位陣列的長度上限是 65535 個位元組。 注意:請勿在 customData 屬性中傳遞任何秘密或密碼。 建立 VM 之後,就無法更新此屬性。 屬性 'customData' 會傳遞至要儲存為檔案的 VM,如需詳細資訊,請參閱 Azure VM 上的自定義數據。 如需針對Linux VM 使用cloud-init,請參閱在建立期間使用cloud-init 自定義Linux VM。 | 字串 |
linuxConfiguration | 指定虛擬機上的Linux作業系統設定。 如需支援的Linux發行版清單,請參閱 Azure-Endorsed 發行版上的Linux。 | LinuxConfiguration |
requireGuestProvisionSignal | 必須設定為 True 或省略的選擇性屬性。 | bool |
密碼 | 指定應該安裝到虛擬機器的憑證集。 若要在虛擬機上安裝憑證,建議您使用適用於Linux的 Azure 金鑰保存庫 虛擬機擴充功能,或適用於Windows的 Azure 金鑰保存庫 虛擬機擴充功能。 | VaultSecretGroup[] |
windowsConfiguration | 指定虛擬機器上的 Windows 作業系統設定。 | WindowsConfiguration |
LinuxConfiguration
名稱 | 描述 | 值 |
---|---|---|
disablePasswordAuthentication | 指定是否應該停用密碼驗證。 | bool |
enableVMAgentPlatformUpdates | 指出是否已針對Linux虛擬機啟用VMAgent Platform 匯報。 預設值為 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 客體修補中指定 Patch 模式 AutomaticByPlatform 的其他設定。 | LinuxVMGuestPatchAutomaticByPlatformSettings |
patchMode | 指定 VM 客體修補至 IaaS 虛擬機的模式,或與 OrchestraMode 為彈性的虛擬機擴展集相關聯的虛擬機。 可能的值包括: ImageDefault - 會使用虛擬機的默認修補組態。 AutomaticByPlatform - 虛擬機將會由平台自動更新。 provisionVMAgent 屬性必須是 true |
'AutomaticByPlatform' 'ImageDefault' |
LinuxVMGuestPatchAutomaticByPlatformSettings
名稱 | 描述 | 值 |
---|---|---|
bypassPlatformSafetyChecksOnUserSchedule | 讓客戶排程修補而不意外升級 | bool |
rebootSetting | 指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。 | 'Always' 'IfRequired' 'Never' 'Unknown' |
SshConfiguration
名稱 | 描述 | 值 |
---|---|---|
publicKeys | 用來向Linux型VM進行驗證的SSH公鑰清單。 | SshPublicKey[] |
SshPublicKey
名稱 | 描述 | 值 |
---|---|---|
keyData | 用來透過 ssh 向 VM 進行驗證的 SSH 公鑰憑證。 密鑰至少必須是 2048 位,且以 ssh-rsa 格式表示。 如需建立 ssh 金鑰,請參閱 [在 Azure 中的 Linux 和 Mac 上建立 Linux VM 的 SSH 金鑰]/azure/virtual-machines/linux/create-ssh-keys-detailed) 。 | 字串 |
path | 指定儲存 ssh 公鑰之已建立 VM 上的完整路徑。 如果檔案已經存在,指定的金鑰就會附加至該檔案。 範例:/home/user/.ssh/authorized_keys | 字串 |
VaultSecretGroup
名稱 | 描述 | 值 |
---|---|---|
sourceVault | 包含 VaultCertificates 中所有憑證之 金鑰保存庫 的相對 URL。 | SubResource |
vaultCertificates | SourceVault 中包含憑證的金鑰保存庫參考清單。 | VaultCertificate[] |
VaultCertificate
名稱 | 描述 | 值 |
---|---|---|
certificateStore | 針對 Windows VM,指定應該新增憑證之虛擬機上的證書存儲。 指定的證書存儲隱含地位於LocalMachine帳戶中。 針對Linux VM,憑證檔案會放在 /var/lib/waagent 目錄底下,而 X509 憑證檔案的檔名<為 UppercaseThumbprint.crt,而<私鑰則為 UppercaseThumbprint.prv>>。 這兩個檔案都是 .pem 格式。 | 字串 |
certificateUrl | 這是已上傳至 金鑰保存庫 做為秘密之憑證的 URL。 如需將秘密新增至 金鑰保存庫,請參閱將密鑰或秘密新增至密鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼,其編碼方式為 UTF-8: { “data”:“{Base64-encoded-certificate}”, “dataType”:“pfx”, “password”:“{pfx-file-password}” } 若要在虛擬機上安裝憑證,建議您使用適用於Linux的 Azure 金鑰保存庫 虛擬機擴充功能或適用於 Windows 的 Azure 金鑰保存庫 虛擬機擴充功能。 |
字串 |
WindowsConfiguration
名稱 | 描述 | 值 |
---|---|---|
additionalUnattendContent | 指定可併入 Unattend.xml 檔案 (由 Windows 安裝程式使用) 的額外 Base-64 編碼 XML 格式資訊。 | AdditionalUnattendContent[] |
enableAutomaticUpdates | 指出是否為 Windows 虛擬機啟用自動 匯報。 預設值為 true。 對於虛擬機擴展集,此屬性可以更新,且更新會在OS重新佈建上生效。 | bool |
enableVMAgentPlatformUpdates | 指出是否已針對 Windows 虛擬機啟用 VMAgent Platform 匯報。 預設值為 False。 | bool |
patchSettings | [預覽功能]指定與 Windows 上的 VM 客體修補相關的設定。 | PatchSettings |
provisionVMAgent | 指出是否應該在虛擬機器上佈建虛擬機器代理程式。 當要求本文中未指定這個屬性時,預設會設定為 true。 這可確保 VM 代理程式已安裝在 VM 上,以便稍後將擴充功能新增至 VM。 | bool |
timeZone | 指定虛擬機的時區。 例如“Pacific Standard Time”。 可能的值可以從 TimeZoneInfo.GetSystemTimeZones 傳回的時區 TimeZoneInfo.Id 值。 | 字串 |
winRM | 指定 Windows 遠端管理接聽程式。 藉此將啟用遠端 Windows PowerShell。 | WinRMConfiguration |
AdditionalUnattendContent
名稱 | 描述 | 值 |
---|---|---|
componentName | 元件名稱。 目前唯一允許的值是 Microsoft-Windows-Shell-Setup。 | 'Microsoft-Windows-Shell-Setup' |
內容 | 針對指定的路徑和元件,指定新增至 unattend.xml 檔案的 XML 格式內容。 XML 必須小於 4KB,而且必須包含要插入之設定或功能的根元素。 | 字串 |
passName | 傳遞名稱。 目前唯一允許的值是 OobeSystem。 | 'OobeSystem' |
settingName | 指定要套用內容之設定的名稱。 可能的值為:FirstLogonCommands 和 AutoLogon。 | 'AutoLogon' 'FirstLogonCommands' |
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 虛擬機的模式,或與 OrchestraMode 為彈性的虛擬機擴展集相關聯的虛擬機。 可能的值包括: 手動 - 您可以控制將修補程式應用程式套用至虛擬機。 您可以在 VM 內手動套用修補程式來執行此動作。 在此模式中,自動更新會停用;屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 false AutomaticByOS - 作業系統會自動更新虛擬機。 WindowsConfiguration.enableAutomaticUpdates 屬性必須是 true。 AutomaticByPlatform - 虛擬機將會由平台自動更新。 provisionVMAgent 和 WindowsConfiguration.enableAutomaticUpdates 屬性必須是 true |
'AutomaticByOS' 'AutomaticByPlatform' 'Manual' |
WindowsVMGuestPatchAutomaticByPlatformSettings
名稱 | 描述 | 值 |
---|---|---|
bypassPlatformSafetyChecksOnUserSchedule | 讓客戶排程修補而不意外升級 | bool |
rebootSetting | 指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。 | 'Always' 'IfRequired' 'Never' 'Unknown' |
WinRMConfiguration
名稱 | 描述 | 值 |
---|---|---|
接聽程式 | Windows 遠端管理接聽程式清單 | WinRMListener[] |
WinRMListener
名稱 | 描述 | 值 |
---|---|---|
certificateUrl | 這是已上傳至 金鑰保存庫 做為秘密之憑證的 URL。 如需將秘密新增至 金鑰保存庫,請參閱將密鑰或秘密新增至密鑰保存庫。 在此情況下,您的憑證必須是以UTF-8編碼的下列 JSON 物件的Base64編碼: { “data”:“{Base64-encoded-certificate}”, “dataType”:“pfx”, “password”:“{pfx-file-password}” } 若要在虛擬機上安裝憑證,建議您使用適用於Linux的 Azure 金鑰保存庫 虛擬機擴充功能,或適用於Windows的 Azure 金鑰保存庫 虛擬機擴充功能。 |
字串 |
protocol | 指定 WinRM 接聽程式的通訊協定。 可能的值為: HTTP、https。 | 'Http' 'Https' |
ScheduledEventsProfile
名稱 | 描述 | 值 |
---|---|---|
osImageNotificationProfile | 指定OS映像排程事件相關組態。 | OSImageNotificationProfile |
terminateNotificationProfile | 指定終止排程事件相關組態。 | TerminateNotificationProfile |
OSImageNotificationProfile
名稱 | 描述 | 值 |
---|---|---|
enable | 指定是否啟用或停用OS映像排程事件。 | bool |
notBeforeTimeout | 虛擬機重新映像或升級操作系統的時間長度,在事件自動核准之前,必須先核准OS映射排程事件, (逾時) 。 組態是以 ISO 8601 格式指定,值必須是 15 分鐘 (PT15M) | 字串 |
TerminateNotificationProfile
名稱 | 描述 | 值 |
---|---|---|
enable | 指定是否啟用或停用 Terminate Scheduled 事件。 | bool |
notBeforeTimeout | 刪除虛擬機的可設定時間長度,在事件自動核准之前,虛擬機必須核准終止排程事件, (逾時) 。 設定必須以 ISO 8601 格式指定,預設值為 5 分鐘, (PT5M) | 字串 |
SecurityProfile
名稱 | 描述 | 值 |
---|---|---|
encryptionAtHost | 這個屬性可由要求中的使用者用來啟用或停用虛擬機或虛擬機擴展集的主機加密。 這會啟用所有磁碟的加密,包括主機本身的資源/暫存磁碟。 默認行為為:除非資源的此屬性設定為 true,否則將會停用主機的加密。 | bool |
encryptionIdentity | 指定 ADE 用來取得 Keyvault 作業存取令牌的受控識別。 | EncryptionIdentity |
proxyAgentSettings | 指定建立虛擬機時的 ProxyAgent 設定。 API 版本下限:2023-09-01。 | ProxyAgentSettings |
securityType | 指定虛擬機的 SecurityType。 它必須設定為任何指定的值,才能啟用 UefiSettings。 默認行為為:除非設定此屬性,否則不會啟用 UefiSettings。 | 'ConfidentialVM' 'TrustedLaunch' |
uefiSettings | 指定建立虛擬機時所使用的安全開機和 vTPM 等安全性設定。 API 版本下限:2020-12-01。 | UefiSettings |
EncryptionIdentity
名稱 | 描述 | 值 |
---|---|---|
userAssignedIdentityResourceId | 指定與 VM 相關聯的其中一個使用者身分識別的 ARM 資源識別碼。 | 字串 |
ProxyAgentSettings
名稱 | 描述 | 值 |
---|---|---|
已啟用 | 指定是否應在虛擬機或虛擬機擴展集上啟用 ProxyAgent 功能。 | bool |
keyIncarnationId | 增加此屬性的值可讓使用者重設用來保護客體與主機之間通道的密鑰。 | int |
mode | 指定啟用此功能時,ProxyAgent 將會在 上執行的模式。 ProxyAgent 會開始稽核或監視,但不會在稽核模式中對主機端點的要求強制執行訪問控制,而在 [強制執行] 模式中,則會強制執行訪問控制。 默認值為 [強制模式]。 | 'Audit' 'Enforce' |
UefiSettings
名稱 | 描述 | 值 |
---|---|---|
secureBootEnabled | 指定是否應在虛擬機上啟用安全開機。 API 版本下限:2020-12-01。 | bool |
vTpmEnabled | 指定是否應在虛擬機上啟用 vTPM。 API 版本下限:2020-12-01。 | bool |
StorageProfile
名稱 | 描述 | 值 |
---|---|---|
dataDisks | 指定用來將資料磁碟加入至虛擬機器的參數。 如需磁碟的詳細資訊,請參閱 關於 Azure 虛擬機的磁碟和 VHD。 | DataDisk[] |
diskControllerType | 指定為 VM 設定的磁碟控制器類型。 注意: 如果未指定,則會使用 『hyperVGeneration』 設定為 V2,根據指定之最低 API 版本之作業系統磁碟和 VM 大小的功能,將此屬性設定為預設磁碟控制器類型。 除非您更新 VM 組態中的 VM 大小,以隱含地解除分配和重新配置 VM,否則您必須在更新其磁碟控制器類型之前解除分配 VM。 API 版本下限:2022-08-01。 | 'NVMe' 'SCSI' |
imageReference | 指定要使用之映像的相關信息。 您可以指定平臺映像、Marketplace 映像或虛擬機映射的相關信息。 當您想要使用平臺映像、市集映像或虛擬機映像,但不會用於其他建立作業時,需要此元素。 | ImageReference |
osDisk | 指定虛擬機所使用的作業系統磁碟相關信息。 如需磁碟的詳細資訊,請參閱 關於 Azure 虛擬機的磁碟和 VHD。 | OSDisk |
DataDisk
名稱 | 描述 | 值 |
---|---|---|
快取 | 指定快取需求。 可能的值為: None、ReadOnly、ReadWrite。 默認行為為: 標準記憶體的 None。進階記憶體的 ReadOnly。 | 'None' 'ReadOnly' 'ReadWrite' |
createOption | 指定應如何建立虛擬機。 可能的值為: Attach。 當您使用特製化磁碟來建立虛擬機時,會使用此值。 FromImage。 當您使用映像來建立虛擬機時,會使用此值。 如果您使用平臺映像,則也應該使用上述的 imageReference 元素。 如果您使用 Marketplace 映射,則也應該使用先前所述的方案元素。 | 'Attach' 'Empty' 需要 『FromImage』 () |
deleteOption | 指定在 VM 刪除時應該刪除或中斷連結資料磁碟。 可能的值為: Delete。 如果使用此值,則會在刪除 VM 時刪除資料磁碟。 分離。 如果使用此值,則會在刪除 VM 之後保留資料磁碟。 默認值設定為 [卸離]。 | 'Delete' 'Detach' |
detachOption | 指定卸離磁碟時所要使用的卸離行為,或已在從虛擬機中斷鏈接的過程中使用。 支援的值: ForceDetach。 detachOption: ForceDetach 僅適用於受控數據磁碟。 如果先前的數據磁碟斷連結嘗試因為虛擬機發生非預期的失敗而未完成,但磁碟仍然未釋放,請使用強制中斷連結作為最後一個從 VM 中斷連結磁碟的最後一個選項。 使用此卸離行為時,可能不會排清所有寫入。 此功能仍處於預覽 模式,且 VirtualMachineScaleSet 不支援此功能。 若要強制中斷數據磁碟更新至BeDetached 為 『true』,以及設定 detachOption: 'ForceDetach'。 | 'ForceDetach' |
diskSizeGB | 指定以 GB 為單位的空白資料磁碟大小。 此元素可用來覆寫虛擬機映像中的磁碟大小。 屬性 'diskSizeGB' 是磁碟的位元組 x 1024^3 數目,且值不能大於 1023。 | int |
image | 來源使用者映像虛擬硬碟。 虛擬硬碟將會先複製,再連結至虛擬機。 如果提供SourceImage,目的地虛擬硬碟不得存在。 | VirtualHardDisk |
lun | 指定數據磁碟的邏輯單元編號。 這個值是用來識別 VM 內的數據磁碟,因此對於連結至 VM 的每個數據磁碟都必須是唯一的。 | 需要 int () |
ManagedDisk | 受控磁碟參數。 | ManagedDiskParameters |
NAME | 磁碟名稱。 | 字串 |
toBeDetached | 指定數據磁碟是否正在從 VirtualMachine/VirtualMachineScaleset 中斷連結 | bool |
vhd | 虛擬硬碟。 | VirtualHardDisk |
writeAcceleratorEnabled | 指定是否應該在磁碟上啟用或停用 writeAccelerator。 | bool |
VirtualHardDisk
名稱 | 描述 | 值 |
---|---|---|
uri | 指定虛擬硬碟的 URI。 | 字串 |
ManagedDiskParameters
名稱 | 描述 | 值 |
---|---|---|
diskEncryptionSet | 指定受控磁碟的客戶受控磁碟加密集資源標識符。 | DiskEncryptionSetParameters |
id | 資源標識碼 | 字串 |
securityProfile | 指定受控磁碟的安全性配置檔。 | VMDiskSecurityProfile |
storageAccountType | 指定受控磁碟的記憶體帳戶類型。 注意:UltraSSD_LRS只能與數據磁碟搭配使用,因此無法與OS磁碟搭配使用。 | 'PremiumV2_LRS' 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' 'UltraSSD_LRS' |
DiskEncryptionSetParameters
名稱 | 描述 | 值 |
---|---|---|
id | 資源標識碼 | 字串 |
VMDiskSecurityProfile
名稱 | 描述 | 值 |
---|---|---|
diskEncryptionSet | 針對客戶受控密鑰加密的機密VM OS 磁碟和 VMGuest Blob 所使用的受控磁碟,指定客戶受控磁碟加密集資源識別碼。 | DiskEncryptionSetParameters |
securityEncryptionType | 指定受控磁碟的 EncryptionType。 它設定為 DiskWithVMGuestState 以加密受控磁碟以及 VMGuestState Blob、VMGuestStateOnly 只加密 VMGuestState Blob,以及 NonPersistedTPM 表示未在 VMGuestState Blob 中保存韌體狀態。 注意: 它只能設定為機密 VM。 | 'DiskWithVMGuestState' 'NonPersistedTPM' 'VMGuestStateOnly' |
ImageReference
名稱 | 描述 | 值 |
---|---|---|
communityGalleryImageId | 指定 VM 部署的社群資源庫映像唯一標識碼。 這可以從社群資源庫映像 GET 呼叫擷取。 | 字串 |
id | 資源標識碼 | 字串 |
供應項目 | 指定用來建立虛擬機的平臺映像或市集映像供應專案。 | 字串 |
publisher | 映像發行者。 | 字串 |
sharedGalleryImageId | 指定 VM 部署的共享資源庫映像唯一識別碼。 這可以從共用資源庫映像 GET 呼叫擷取。 | 字串 |
sku | 映像 SKU。 | 字串 |
version | 指定用來建立虛擬機的平臺映像或 Marketplace 映像版本。 允許的格式為 Major.Minor.Build 或 'latest'。 主要、次要和組建是十進位數。 指定「最新」以使用部署階段可用的最新映像版本。 即使您使用「最新」,即使有新版本可供使用,VM 映像也不會在部署時間之後自動更新。 請勿針對資源庫映射部署使用字段 'version',資源庫映射應該一律使用 'id' 字段進行部署,若要使用資源庫映射的 'latest' 版本,只要設定 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}' 字段,就不需要輸入版本。 | 字串 |
OSDisk
名稱 | 描述 | 值 |
---|---|---|
快取 | 指定快取需求。 可能的值為: None、ReadOnly、ReadWrite。 默認行為為: 標準記憶體無。進階記憶體的 ReadOnly。 | 'None' 'ReadOnly' 'ReadWrite' |
createOption | 指定虛擬機的建立方式。 可能的值為: 附加。 當您使用特製化磁碟來建立虛擬機時,會使用此值。 FromImage。 當您使用映像來建立虛擬機時,會使用此值。 如果您使用平臺映像,則也應該使用上述的 imageReference 元素。 如果您使用市集映像,您也應該使用先前所述的方案元素。 | 'Attach' 'Empty' 'FromImage' (必要) |
deleteOption | 指定在 VM 刪除時,是否應該刪除或中斷連結 OS 磁碟。 可能的值為: Delete。 如果使用此值,則會在刪除 VM 時刪除 OS 磁碟。 分離。 如果使用此值,則會在刪除 VM 之後保留 os 磁碟。 默認值設定為 [卸離]。 對於暫時 OS 磁碟,預設值會設定為 [刪除]。 使用者無法變更暫時 OS 磁碟的刪除選項。 | 'Delete' 'Detach' |
diffDiskSettings | 指定虛擬機所使用作業系統磁碟的暫時磁碟設定。 | DiffDiskSettings |
diskSizeGB | 指定以 GB 為單位的空白資料磁碟大小。 此元素可用來覆寫虛擬機映像中的磁碟大小。 屬性 'diskSizeGB' 是磁碟的位元組 x 1024^3 數目,值不能大於 1023。 | int |
encryptionSettings | 指定 OS 磁碟的加密設定。 API 版本下限:2015-06-15。 | DiskEncryptionSettings |
image | 來源使用者映像虛擬硬碟。 在連接至虛擬機之前,將會先複製虛擬硬碟。 如果提供SourceImage,目的地虛擬硬碟不得存在。 | VirtualHardDisk |
ManagedDisk | 受控磁碟參數。 | ManagedDiskParameters |
NAME | 磁碟名稱。 | 字串 |
osType | 此屬性可讓您指定從使用者映像或特製化 VHD 建立 VM 時,磁碟包含的 OS 類型。 可能的值為: Windows、Linux。 | 'Linux' 'Windows' |
vhd | 虛擬硬碟。 | VirtualHardDisk |
writeAcceleratorEnabled | 指定是否應該在磁碟上啟用或停用 writeAccelerator。 | bool |
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' |
DiskEncryptionSettings
名稱 | 描述 | 值 |
---|---|---|
diskEncryptionKey | 指定磁碟加密金鑰的位置,這是 金鑰保存庫 秘密。 | KeyVaultSecretReference |
已啟用 | 指定是否應在虛擬機上啟用磁碟加密。 | bool |
keyEncryptionKey | 指定 金鑰保存庫 中金鑰加密金鑰的位置。 | KeyVaultKeyReference |
KeyVaultSecretReference
名稱 | 描述 | 值 |
---|---|---|
secretUrl | 參考 金鑰保存庫 中秘密的URL。 | 需要字串 () |
sourceVault | 包含秘密之 金鑰保存庫的相對 URL。 | 必要子資源 () |
KeyVaultKeyReference
名稱 | 描述 | 值 |
---|---|---|
keyUrl | 在 金鑰保存庫 中參考金鑰加密金鑰的 URL。 | 需要字串 () |
sourceVault | 包含金鑰之 金鑰保存庫 的相對 URL。 | 必要子資源 () |
快速入門範本
下列快速入門範本會部署此資源類型。
範本 | 描述 |
---|---|
部署簡單的Linux VM,並將私人IP更新為靜態 |
此範本可讓您從市集使用Ubuntu部署簡單的Linux VM。 這會使用動態指派的IP位址,在資源群組位置中部署 VNET、子網和 A1 大小 VM,然後將它轉換成靜態IP。 |
使用資源迴圈在可用性設定組中建立 VM |
使用資源迴圈在可用性設定組中建立 2-5 部 VM。 VM 可以是 Unbuntu 或 Windows,最多 5 部 VM,因為此範例使用單一 storageAccount |
具有受控磁碟的多重 VM 範本 |
此範本會建立具有受控磁碟、公用IP和網路介面的N個VM數目。 它會在單一可用性設定組中建立 VM。 它們將會布建在 虛擬網路 中,也會建立為部署的一部分 |
在 Windows VM 上安裝檔案 |
此範本可讓您部署 Windows VM 並執行自定義 PowerShell 腳本,以在該 VM 上安裝檔案。 |
使用自定義數據部署虛擬機 |
此範本可讓您建立虛擬機,並將自定義數據傳遞至 VM。 此範本也會部署記憶體帳戶、虛擬網路、公用IP位址和網路介面。 |
使用診斷部署進階 Windows VM |
此範本可讓您使用 Windows 版本的幾個不同選項,使用最新的修補版本來部署進階 Windows VM。 |
在不同的資源群組的 VNET 中建立 VM |
此範本會在位於不同資源群組的 VNET 中建立 VM |
將 VM 加入現有的網域 |
此範本示範在雲端中加入私人 AD 網域的網域。 |
建立具有動態選取數據磁碟的 VM |
此範本可讓用戶選取想要新增至 VM 的數據磁碟數目。 |
從 EfficientIP VHD 建立 VM |
此範本會從 EfficientIP VHD 建立 VM,並讓您將其連線到位於另一個資源群組中的現有 VNET,然後虛擬機 |
從使用者映像建立 VM |
此範本可讓您從使用者映像建立 虛擬機器。 此範本也會部署 虛擬網路、公用IP位址和網路介面。 |
從一般化 VHD 在新的或現有的 vnet 中建立 VM |
此範本會從一般化 VHD 建立 VM,並讓您將其連線到新的或現有的 VNET,該 VNET 可以位於虛擬機以外的另一個資源群組中 |
CentOS/UbuntuServer 自動動態磁碟 & Docker 1.12 (cs) |
這是建立單一實例 CentOS 7.2/7.1/6.5 或 Ubuntu Server 16.04.0-LTS 的常見範本,其中包含可設定的數據磁碟數目, (可設定的大小) 。 入口網站參數中可以提及最多 16 個磁碟,而且每個磁碟的大小上限應小於 1023 GB。 MDADM RAID0 Array 會自動掛接,並存留於重新啟動。 最新的 Docker 1.12 (cs3) (Swarm) ,docker-compose 1.9.0 & docker-machine 0.8.2 可從使用者 azure-cli 自動以 docker 容器的形式執行。 這個單一實例範本是 HPC/GPU 叢集範本的異地 |
具有序列輸出的Linux VM |
此範本會建立簡單的 Linux VM,並將參數和序列/主控台設定為輸出至記憶體 |
使用監視和診斷部署簡單的 Windows VM |
此範本可讓您部署簡單的 Windows VM 以及可啟用 VM 監視和診斷的診斷擴充功能 |
使用 MSI 部署 Linux 或 Windows VM |
此範本可讓您使用受控服務識別來部署Linux或Windows VM。 |
Azure 上的 Terraform |
此範本可讓您將 Terraform 工作站部署為具有 MSI 的 Linux VM。 |
具有 MSI 存取記憶體的 Linux VM |
此範本會部署 Linux VM,其中包含系統指派的受控識別,可存取不同資源群組中的記憶體帳戶。 |
從具有 4 個空白數據磁碟的 Windows 映射建立 VM |
此範本可讓您從指定的映像建立 Windows 虛擬機。 它也會連結 4 個空的數據磁碟。 請注意,您可以指定空白數據磁碟的大小。 |
部署具有多個IP的 VM |
此範本可讓您部署具有 3 個 IP 組態的 VM。 此範本會分別部署名為 myVM1 且具有 3 個 IP 組態的 Linux/Windows VM: IPConfig-1、 IPConfig-2 和 IPConfig-3。 |
使用多個UBUNTU部署Linux VM (Ubuntu) |
此範本會建立具有多個子網的 VNet,並部署具有多個 NIC 的 Ubuntu VM |
具有條件式資源的虛擬機 |
此範本允許使用 虛擬網路、記憶體和公用IP位址的新或現有資源來部署Linux VM。 它也允許在 SSH 和密碼驗證之間進行選擇。 範本會使用條件和邏輯函式來移除巢狀部署的需求。 |
從現有的 VHD 建立 VM,並將其連線至現有的VNET |
此範本會從 VHD 建立 VM (OS + 資料磁碟) ,並讓您將其連線到位於另一個資源群組的現有 VNET,然後虛擬機 |
將憑證推送至 Windows VM |
將憑證推送至 Windows VM。 |
使用 金鑰保存庫保護 VM 密碼 |
此範本可讓您擷取儲存在 金鑰保存庫 中的密碼,以部署簡單的 Windows VM。 因此,密碼永遠不會在範本參數檔案中放入純文本 |
在資源群組位置中部署簡單的FreeBSD VM |
此範本可讓您使用最新修補的版本,使用FreeBSD版本的幾個不同選項來部署簡單的FreeBSD VM。 這會部署在 D1 VM 大小的資源群組位置中。 |
部署簡單的UbuntuLinux VM 18.04-LTS |
此範本會部署具有一些 VM 選項的 Ubuntu Server。 您可以提供 VM 名稱、OS 版本、VM 大小、系統管理員使用者名稱和密碼。 VM 大小預設為 Standard_B2s,而 O.S 版本為 18.04-LTS。 |
使用加速網路部署簡單的Linux VM |
此範本可讓您使用Ubuntu 18.04-LTS 18.04-LTS搭配最新修補版本來部署具有加速網路的簡單Linux VM。 這會在資源群組位置中部署D3_v2大小 VM,並傳回 VM 的 FQDN。 |
Red Hat Enterprise Linux VM (RHEL 7.8) |
此範本會部署 Red Hat Enterprise Linux VM (RHEL 7.8) ,使用標準 D1 VM 上所選版本的隨用隨付 RHEL VM 映射,並將額外 100 GiB 數據磁碟連結至 VM 的資源群組位置。 此映像會產生額外費用 - 如需詳細資訊,請參閱 Azure VM 定價頁面。 |
Red Hat Enterprise Linux VM (RHEL 7.8 Unmanaged) |
此範本會部署 Red Hat Enterprise Linux VM (RHEL 7.8) ,使用隨用隨付 RHEL VM 映射,在所選資源群組的位置,將所選 A1_v2版本的隨用隨付 RHEL VM 映射部署至您所選資源群組的位置,並附加額外的 100 GiB 數據磁碟至 VM。 此映像會產生額外費用 - 如需詳細資訊,請參閱 Azure VM 定價頁面。 |
SUSE Linux Enterprise Server VM (SLES 12) |
此範本可讓您使用標準 D1 VM 上所選版本的隨用隨付 SLES VM 映射,在所選資源群組的位置部署 SUSE Linux Enterprise Server VM (SLES 12) 。 此映像會產生額外費用 - 如需詳細資訊,請參閱 Azure VM 定價頁面。 |
部署簡單的 Windows VM |
此範本可讓您使用 Windows 版本的幾個不同選項,使用最新的修補版本來部署簡單的 Windows VM。 這會在資源群組位置中部署 A2 大小 VM,並傳回 VM 的 FQDN。 |
使用 Visual Studio 部署 Windows Server VM |
此範本會部署具有 Visual Code Studio Community 2019 的 Windows Server VM,以及 VM 的幾個選項。 您可以提供 VM 的名稱、系統管理員使用者名稱和系統管理員密碼。 |
將 VM 部署到可用性區域 |
此範本可讓您使用最新的修補版本,在 Windows 或 Ubuntu) 部署簡單的 VM (。 這會在指定的位置部署A2_v2大小 VM,並傳回 VM 的 FQDN。 |
從自定義 VHD 在新的或現有的 vnet 中建立 VM |
此範本會從特製化 VHD 建立 VM,並讓您將其連線到新的或現有的 VNET,該 VNET 可以位於虛擬機以外的另一個資源群組中 |
SQL Server 2014 SP2 Enterprise 與自動備份 |
此範本會建立已啟用自動備份功能的 SQL Server 2014 SP2 Enterprise 版 |
SQL Server 2014 SP1 Enterprise 與自動修補 |
此範本會建立已啟用自動修補功能的 SQL Server 2014 SP1 Enterprise 版本。 |
SQL Server 2014 SP1 Enterprise 與 Azure 金鑰保存庫 |
此範本會建立已啟用 Azure 金鑰保存庫 Integration 功能的 SQL Server 2014 SP1 Enterprise 版本。 |
使用 SSH rsa 公鑰部署虛擬機 |
此範本可讓您建立具有 SSH rsa 公鑰的虛擬機 |
使用標籤部署簡單的 Windows VM |
此範本會部署D2_v3 Windows VM、NIC、記憶體帳戶、虛擬網路、公用IP位址和網路安全組。 卷標物件會在變數中建立,並在適用的情況下套用至所有資源。 |
部署支援受信任啟動的Linux虛擬機 |
此範本可讓您使用 Linux 版本的幾個不同選項,使用最新的修補版本,部署具有受信任啟動功能的 Linux 虛擬機。 如果您啟用 Secureboot 和 vTPM,客體證明擴充功能將會安裝在您的 VM 上。 此延伸模組將會由雲端執行遠程 證明 。 根據預設,這會在資源群組位置中部署Standard_D2_v3大小的虛擬機,並傳回虛擬機的 FQDN。 |
部署支援受信任啟動的 Windows 虛擬機 |
此範本可讓您使用 Windows 版本的幾個不同選項,使用最新的修補版本,部署具有受信任啟動功能的 Windows 虛擬機。 如果您啟用 Secureboot 和 vTPM,客體證明擴充功能將會安裝在您的 VM 上。 此延伸模組將會由雲端執行遠程 證明 。 根據預設,這會在資源群組位置中部署Standard_D2_v3大小的虛擬機,並傳回虛擬機的 FQDN。 |
使用用戶數據部署虛擬機 |
此範本可讓您建立虛擬機,並將用戶數據傳遞至 VM。 此範本也會部署 虛擬網路、公用IP位址和網路介面。 |
使用 Windows Admin Center 擴充功能部署 Windows VM |
此範本可讓您部署具有 Windows Admin Center 擴充功能的 Windows VM,以便直接從 Azure 入口網站管理 VM。 |
具有 Azure 安全基準的 Windows VM |
此範本會在具有公用IP位址的新虛擬網路中建立執行 Windows Server 的虛擬機。 部署機器之後,就會安裝客體設定擴充功能,並套用適用於 Windows Server 的 Azure 安全基準。 如果機器的設定漂移,您可以再次部署範本來重新套用設定。 |
部署具有可變數據磁碟數目的 Windows VM |
此範本可讓您部署簡單的 VM,並使用 參數指定部署時的數據磁碟數目。 請注意,數據磁碟的數目和大小是由 VM 大小所系結。 此範例的 VM 大小Standard_DS4_v2預設為 16 個數據磁碟。 |
具有 SSH 的 Windows Server VM |
部署已啟用Open SSH 的單一 Windows VM,讓您可以使用金鑰型驗證透過 SSH 連線。 |
建立數據管理閘道並在 Azure VM 上安裝 |
此範本會部署虛擬機,並建立可運作的數據管理閘道 |
具有 RDP 連接埠的虛擬機 |
建立虛擬機,併為負載平衡器中的 VM 建立 RDP 的 NAT 規則 |
建立具有多個空白 StandardSSD_LRS 資料磁碟的 VM |
此範本可讓您從指定的映像建立 Windows 虛擬機。 它預設也會連結多個空的 StandardSSD 數據磁碟。 請注意,您可以指定空白數據磁碟的大小和記憶體類型 (Standard_LRS、StandardSSD_LRS和Premium_LRS) 。 |
Azure VM 上的自我裝載 Integration Runtime |
此範本會建立自我裝載整合運行時間,並在 Azure 虛擬機上註冊它 |
將多個 VM 新增至虛擬機擴展集 |
此範本會使用受控磁碟、公用IP和網路介面建立 N 個 VM 數目。 它會在彈性協調流程模式的虛擬機擴展集中建立 VM。 它們將會在部署過程中建立的 虛擬網路 中布建 |
在 ILB 後方部署具有 Linux VM 的 VM 擴展集 |
此範本可讓您使用最新修補版本的 Ubuntu Linux 15.10 或 14.04.4-LTS 來部署 Linux VM 的 VM 擴展集。 這些 VM 位於內部負載平衡器後方,具有 SSH 連線的 NAT 規則。 |
ARM 範本資源定義
virtualMachines 資源類型可以使用目標作業來部署:
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄。
資源格式
若要建立 Microsoft.Compute/virtualMachines 資源,請將下列 JSON 新增至範本。
{
"type": "Microsoft.Compute/virtualMachines",
"apiVersion": "2023-09-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"extendedLocation": {
"name": "string",
"type": "EdgeZone"
},
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {},
"{customized property}": {}
}
},
"plan": {
"name": "string",
"product": "string",
"promotionCode": "string",
"publisher": "string"
},
"properties": {
"additionalCapabilities": {
"hibernationEnabled": "bool",
"ultraSSDEnabled": "bool"
},
"applicationProfile": {
"galleryApplications": [
{
"configurationReference": "string",
"enableAutomaticUpgrade": "bool",
"order": "int",
"packageReferenceId": "string",
"tags": "string",
"treatFailureAsDeploymentFailure": "bool"
}
]
},
"availabilitySet": {
"id": "string"
},
"billingProfile": {
"maxPrice": "[json('decimal-as-string')]"
},
"capacityReservation": {
"capacityReservationGroup": {
"id": "string"
}
},
"diagnosticsProfile": {
"bootDiagnostics": {
"enabled": "bool",
"storageUri": "string"
}
},
"evictionPolicy": "string",
"extensionsTimeBudget": "string",
"hardwareProfile": {
"vmSize": "string",
"vmSizeProperties": {
"vCPUsAvailable": "int",
"vCPUsPerCore": "int"
}
},
"host": {
"id": "string"
},
"hostGroup": {
"id": "string"
},
"licenseType": "string",
"networkProfile": {
"networkApiVersion": "2020-11-01",
"networkInterfaceConfigurations": [
{
"name": "string",
"properties": {
"auxiliaryMode": "string",
"auxiliarySku": "string",
"deleteOption": "string",
"disableTcpStateTracking": "bool",
"dnsSettings": {
"dnsServers": [ "string" ]
},
"dscpConfiguration": {
"id": "string"
},
"enableAcceleratedNetworking": "bool",
"enableFpga": "bool",
"enableIPForwarding": "bool",
"ipConfigurations": [
{
"name": "string",
"properties": {
"applicationGatewayBackendAddressPools": [
{
"id": "string"
}
],
"applicationSecurityGroups": [
{
"id": "string"
}
],
"loadBalancerBackendAddressPools": [
{
"id": "string"
}
],
"primary": "bool",
"privateIPAddressVersion": "string",
"publicIPAddressConfiguration": {
"name": "string",
"properties": {
"deleteOption": "string",
"dnsSettings": {
"domainNameLabel": "string",
"domainNameLabelScope": "string"
},
"idleTimeoutInMinutes": "int",
"ipTags": [
{
"ipTagType": "string",
"tag": "string"
}
],
"publicIPAddressVersion": "string",
"publicIPAllocationMethod": "string",
"publicIPPrefix": {
"id": "string"
}
},
"sku": {
"name": "string",
"tier": "string"
}
},
"subnet": {
"id": "string"
}
}
}
],
"networkSecurityGroup": {
"id": "string"
},
"primary": "bool"
}
}
],
"networkInterfaces": [
{
"id": "string",
"properties": {
"deleteOption": "string",
"primary": "bool"
}
}
]
},
"osProfile": {
"adminPassword": "string",
"adminUsername": "string",
"allowExtensionOperations": "bool",
"computerName": "string",
"customData": "string",
"linuxConfiguration": {
"disablePasswordAuthentication": "bool",
"enableVMAgentPlatformUpdates": "bool",
"patchSettings": {
"assessmentMode": "string",
"automaticByPlatformSettings": {
"bypassPlatformSafetyChecksOnUserSchedule": "bool",
"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": {
"bypassPlatformSafetyChecksOnUserSchedule": "bool",
"rebootSetting": "string"
},
"enableHotpatching": "bool",
"patchMode": "string"
},
"provisionVMAgent": "bool",
"timeZone": "string",
"winRM": {
"listeners": [
{
"certificateUrl": "string",
"protocol": "string"
}
]
}
}
},
"platformFaultDomain": "int",
"priority": "string",
"proximityPlacementGroup": {
"id": "string"
},
"scheduledEventsProfile": {
"osImageNotificationProfile": {
"enable": "bool",
"notBeforeTimeout": "string"
},
"terminateNotificationProfile": {
"enable": "bool",
"notBeforeTimeout": "string"
}
},
"securityProfile": {
"encryptionAtHost": "bool",
"encryptionIdentity": {
"userAssignedIdentityResourceId": "string"
},
"proxyAgentSettings": {
"enabled": "bool",
"keyIncarnationId": "int",
"mode": "string"
},
"securityType": "string",
"uefiSettings": {
"secureBootEnabled": "bool",
"vTpmEnabled": "bool"
}
},
"storageProfile": {
"dataDisks": [
{
"caching": "string",
"createOption": "string",
"deleteOption": "string",
"detachOption": "ForceDetach",
"diskSizeGB": "int",
"image": {
"uri": "string"
},
"lun": "int",
"managedDisk": {
"diskEncryptionSet": {
"id": "string"
},
"id": "string",
"securityProfile": {
"diskEncryptionSet": {
"id": "string"
},
"securityEncryptionType": "string"
},
"storageAccountType": "string"
},
"name": "string",
"toBeDetached": "bool",
"vhd": {
"uri": "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": "Local",
"placement": "string"
},
"diskSizeGB": "int",
"encryptionSettings": {
"diskEncryptionKey": {
"secretUrl": "string",
"sourceVault": {
"id": "string"
}
},
"enabled": "bool",
"keyEncryptionKey": {
"keyUrl": "string",
"sourceVault": {
"id": "string"
}
}
},
"image": {
"uri": "string"
},
"managedDisk": {
"diskEncryptionSet": {
"id": "string"
},
"id": "string",
"securityProfile": {
"diskEncryptionSet": {
"id": "string"
},
"securityEncryptionType": "string"
},
"storageAccountType": "string"
},
"name": "string",
"osType": "string",
"vhd": {
"uri": "string"
},
"writeAcceleratorEnabled": "bool"
}
},
"userData": "string",
"virtualMachineScaleSet": {
"id": "string"
}
},
"zones": [ "string" ]
}
屬性值
virtualMachines
名稱 | 描述 | 值 |
---|---|---|
類型 | 資源類型 | 'Microsoft.Compute/virtualMachines' |
apiVersion | 資源 API 版本 | '2023-09-01' |
NAME | 資源名稱 | 字串 (必要) 字元限制:1-15 (Windows) 1-64 (Linux) 合法字元: 不能使用空格、控制字元或下列字元: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ? Windows VM 不能包含句號或以連字號結尾。 Linux VM 不能以句號或連字號結尾。 |
location | 資源位置 | 字串 (必要) |
tags | 資源標籤 | 標記名稱和值的字典。 請參閱 範本中的標記 |
extendedLocation | 虛擬機的擴充位置。 | ExtendedLocation |
身分識別 | 如果已設定,則為虛擬機的身分識別。 | VirtualMachineIdentity |
方案 | 指定用來建立虛擬機之 Marketplace 映像的相關信息。 此元素僅用於市集映像。 您必須先啟用映像以程序設計方式使用,才能從 API 使用市集映射。 在 Azure 入口網站 中,尋找您想要使用的市集映射,然後按兩下 [想要以程序設計方式部署],[開始使用] -> 。 輸入任何必要資訊,然後按兩下 [ 儲存]。 | 方案 |
properties | 描述虛擬機的屬性。 | VirtualMachineProperties |
zones (區域) | 虛擬機區域。 | string[] |
ExtendedLocation
名稱 | 描述 | 值 |
---|---|---|
NAME | 擴充位置的名稱。 | 字串 |
type | 擴充位置的類型。 | 'EdgeZone' |
VirtualMachineIdentity
名稱 | 描述 | 值 |
---|---|---|
類型 | 用於虛擬機的身分識別類型。 「SystemAssigned、UserAssigned」類型同時包含隱含建立的身分識別,和一組使用者指派的身分識別。 類型 『None』 會從虛擬機中移除任何身分識別。 | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
userAssignedIdentities | 與虛擬機相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 | UserAssignedIdentities |
UserAssignedIdentities
名稱 | 描述 | 值 |
---|---|---|
{自定義屬性} | UserAssignedIdentitiesValue | |
{自定義屬性} | UserAssignedIdentitiesValue |
UserAssignedIdentitiesValue
此物件不包含部署期間要設定的任何屬性。 所有屬性都是 ReadOnly。
計畫
名稱 | 描述 | 值 |
---|---|---|
NAME | 方案標識碼。 | 字串 |
產品 | 指定市集中映像的產品。 這與 imageReference 元素下的 Offer 值相同。 | 字串 |
promotionCode | 促銷碼。 | 字串 |
publisher | 發行者標識碼。 | 字串 |
VirtualMachineProperties
名稱 | 描述 | 值 |
---|---|---|
additionalCapabilities | 指定在虛擬機上啟用或停用的其他功能。 | AdditionalCapabilities |
applicationProfile | 指定應該提供給 VM/VMSS 的資源庫應用程式。 | ApplicationProfile |
availabilitySet | 指定虛擬機應指派給的可用性設定組相關信息。 在相同可用性設定組中指定的虛擬機器會配置到不同的節點,以便將可用性最大化。 如需可用性設定組的詳細資訊,請參閱 可用性設定組概觀。 如需 Azure 計劃性維護的詳細資訊,請參閱 Azure 中 虛擬機器 的維護和更新。 目前,VM 只能在建立時新增至可用性設定組。 要新增 VM 的可用性設定組應該位於與可用性設定組資源相同的資源群組之下。 現有的 VM 無法新增至可用性設定組。 此屬性不能與非 Null 屬性一起存在。virtualMachineScaleSet 參考。 | SubResource |
billingProfile | 指定 Azure Spot 虛擬機的計費相關詳細數據。 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 擴展集,同時支援 'Deallocate' 和 'Delete',而最低 API 版本為 2017-10-30-preview。 | 'Deallocate' 'Delete' |
extensionsTimeBudget | 指定要啟動之所有延伸模組加上批注的時間。 持續時間應介於 15 分鐘到 120 分鐘之間, (包含) ,且應以 ISO 8601 格式指定。 預設值為90分鐘 (PT1H30M) 。 API 版本下限:2020-06-01。 | 字串 |
hardwareProfile | 指定虛擬機器的硬體設定。 | HardwareProfile |
主機 | 指定虛擬機所在專用主機的相關信息。 API 版本下限:2018-10-01。 | SubResource |
hostGroup | 指定虛擬機所在專用主機群組的相關信息。 注意: 用戶無法同時指定 host 和 hostGroup 屬性。 API 版本下限:2020-06-01。 | SubResource |
licenseType | 指定正在使用的映像或磁碟是在內部部署授權。 Windows Server 操作系統的可能值為: Windows_Client Windows_Server Linux Server 操作系統的可能值為: RHEL) 的RHEL_BYOS ( SUSE) 的SLES_BYOS ( 如需詳細資訊,請參閱 適用於 Windows Server 的 Azure Hybrid Use Benefit 適用於Linux伺服器的 Azure Hybrid Use Benefit 最低 api-version:2015-06-15 |
字串 |
networkProfile | 指定虛擬機器的網路介面。 | NetworkProfile |
osProfile | 指定建立虛擬機時所使用的作業系統設定。 布建 VM 之後,就無法變更部分設定。 | OSProfile |
platformFaultDomain | 指定要在其中建立虛擬機的擴展集邏輯容錯網域。 根據預設,虛擬機會自動指派給容錯網域,以在可用的容錯網域之間維持平衡。 只有在設定此虛擬機的 'virtualMachineScaleSet' 屬性時,才適用這個屬性。 所參考的虛擬機擴展集必須具有大於 1 的 『platformFaultDomainCount』。 建立虛擬機之後,就無法更新此屬性。 容錯網域指派可以在虛擬機實例檢視中檢視。 最低 api-version:2020?12?01。 | int |
priority | 指定虛擬機的優先順序。 最低 api-version:2019-03-01 | 'Low' 'Regular' 'Spot' |
proximityPlacementGroup | 指定虛擬機應指派給之鄰近放置群組的相關信息。 API 版本下限:2018-04-01。 | SubResource |
scheduledEventsProfile | 指定排程的事件相關組態。 | ScheduledEventsProfile |
securityProfile | 指定虛擬機的安全性相關配置檔設定。 | SecurityProfile |
storageProfile | 指定虛擬機器磁碟的儲存體設定。 | StorageProfile |
userData | VM 的 UserData,必須以 base-64 編碼。 客戶不應在此傳遞任何秘密。 最低 api-version:2021-03-01。 | 字串 |
virtualMachineScaleSet | 指定要指派虛擬機之虛擬機擴展集的相關信息。 相同虛擬機擴展集中指定的虛擬機會配置給不同的節點,以最大化可用性。 目前,VM 只能在建立時新增至虛擬機擴展集。 現有的 VM 無法新增至虛擬機擴展集。 這個屬性不能與非 Null properties.availabilitySet 參考一起存在。 最低 api-version:2019?03\01。 | SubResource |
AdditionalCapabilities
名稱 | 描述 | 值 |
---|---|---|
hibernationEnabled | 啟用或停用 VM 上休眠功能的旗標。 | bool |
ultraSSDEnabled | 旗標,可讓或停用在 VM 或 VMSS 上具有一或多個具有 UltraSSD_LRS記憶體帳戶類型的受控數據磁碟。 只有在啟用此屬性時,才能將具有記憶體帳戶類型的受控磁碟UltraSSD_LRS新增至虛擬機或虛擬機擴展集。 | bool |
ApplicationProfile
名稱 | 描述 | 值 |
---|---|---|
galleryApplications | 指定應該提供給 VM/VMSS 使用的資源庫應用程式 | VMGalleryApplication[] |
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 資源標識符 | 需要字串 () |
tags | 選擇性,指定更多泛型內容的傳遞值。 | 字串 |
treatFailureAsDeploymentFailure | 選擇性,如果為 true,VmApplication 中任何作業的任何失敗都會使部署失敗 | bool |
SubResource
名稱 | 描述 | 值 |
---|---|---|
id | 資源標識碼 | 字串 |
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 – 表示預設價格為隨選。 您可以將 maxPrice 設定為 -1,以指出基於價格考慮,不應收回 Azure Spot VM/VMSS。 此外,如果預設的最大值價格不是由您提供,則為 -1。 API 版本下限:2019-03-01。 若要指定十進位值,請使用 json () 函式。 |
int 或 json decimal |
CapacityReservationProfile
名稱 | 描述 | 值 |
---|---|---|
capacityReservationGroup | 指定容量保留群組資源標識符,該標識元應該用於配置已保留足夠容量的虛擬機或擴展集 VM 實例。 如需詳細資訊, https://aka.ms/CapacityReservation 請參閱 。 |
SubResource |
DiagnosticsProfile
名稱 | 描述 | 值 |
---|---|---|
bootDiagnostics | 開機診斷是一項偵錯功能,可讓您檢視控制台輸出和螢幕快照以診斷 VM 狀態。 注意:如果要指定 storageUri,請確定記憶體帳戶位於與 VM 相同的區域和訂用帳戶中。 您可以輕鬆地檢視主控台記錄檔的輸出。 Azure 也可讓您從 Hypervisor 查看 VM 的螢幕快照。 | BootDiagnostics |
BootDiagnostics
名稱 | 描述 | 值 |
---|---|---|
已啟用 | 是否應在虛擬機上啟用開機診斷。 | bool |
storageUri | 用來放置主控台輸出和螢幕快照的記憶體帳戶 URI。 如果未在啟用開機診斷時指定 storageUri,則會使用受控記憶體。 | 字串 |
HardwareProfile
名稱 | 描述 | 值 |
---|---|---|
vmSize | 指定虛擬機器的大小。 列舉數據類型目前已被取代,將於 2023 年 12 月 23 日移除。 取得可用大小清單的建議方式是使用這些 API: 列出可用性設定組中的所有可用虛擬機器大小、 列出區域中所有可用的虛擬機大小、 列出所有可用的虛擬機大小以重設大小。 如需虛擬機大小的詳細資訊,請參閱 虛擬機的大小。 可用的 VM 大小取決於區域和可用性設定組。 | 'Basic_A0' 'Basic_A1' 'Basic_A2' 'Basic_A3' 'Basic_A4' 'Standard_A0' 'Standard_A1' 'Standard_A10' 'Standard_A11' 'Standard_A1_v2' 'Standard_A2' 'Standard_A2_v2' 'Standard_A2m_v2' 'Standard_A3' 'Standard_A4' 'Standard_A4_v2' 'Standard_A4m_v2' 'Standard_A5' 'Standard_A6' 'Standard_A7' 'Standard_A8' 'Standard_A8_v2' 'Standard_A8m_v2' 'Standard_A9' 'Standard_B1ms' 'Standard_B1s' 'Standard_B2ms' 'Standard_B2s' 'Standard_B4ms' 'Standard_B8ms' 'Standard_D1' 'Standard_D11' 'Standard_D11_v2' 'Standard_D12' 'Standard_D12_v2' 'Standard_D13' 'Standard_D13_v2' 'Standard_D14' 'Standard_D14_v2' 'Standard_D15_v2' 'Standard_D16_v3' 'Standard_D16s_v3' 'Standard_D1_v2' 'Standard_D2' 'Standard_D2_v2' 'Standard_D2_v3' 'Standard_D2s_v3' 'Standard_D3' 'Standard_D32_v3' 'Standard_D32s_v3' 'Standard_D3_v2' 'Standard_D4' 'Standard_D4_v2' 'Standard_D4_v3' 'Standard_D4s_v3' 'Standard_D5_v2' 'Standard_D64_v3' 'Standard_D64s_v3' 'Standard_D8_v3' 'Standard_D8s_v3' 'Standard_DS1' 'Standard_DS11' 'Standard_DS11_v2' 'Standard_DS12' 'Standard_DS12_v2' 'Standard_DS13' 'Standard_DS13-2_v2' 'Standard_DS13-4_v2' 'Standard_DS13_v2' 'Standard_DS14' 'Standard_DS14-4_v2' 'Standard_DS14-8_v2' 'Standard_DS14_v2' 'Standard_DS15_v2' 'Standard_DS1_v2' 'Standard_DS2' 'Standard_DS2_v2' 'Standard_DS3' 'Standard_DS3_v2' 'Standard_DS4' 'Standard_DS4_v2' 'Standard_DS5_v2' 'Standard_E16_v3' 'Standard_E16s_v3' 'Standard_E2_v3' 'Standard_E2s_v3' 'Standard_E32-16_v3' 'Standard_E32-8s_v3' 'Standard_E32_v3' 'Standard_E32s_v3' 'Standard_E4_v3' 'Standard_E4s_v3' 'Standard_E64-16s_v3' 'Standard_E64-32s_v3' 'Standard_E64_v3' 'Standard_E64s_v3' 'Standard_E8_v3' 'Standard_E8s_v3' 'Standard_F1' 'Standard_F16' 'Standard_F16s' 'Standard_F16s_v2' 'Standard_F1s' 'Standard_F2' 'Standard_F2s' 'Standard_F2s_v2' 'Standard_F32s_v2' 'Standard_F4' 'Standard_F4s' 'Standard_F4s_v2' 'Standard_F64s_v2' 'Standard_F72s_v2' 'Standard_F8' 'Standard_F8s' 'Standard_F8s_v2' 'Standard_G1' 'Standard_G2' 'Standard_G3' 'Standard_G4' 'Standard_G5' 'Standard_GS1' 'Standard_GS2' 'Standard_GS3' 'Standard_GS4' 'Standard_GS4-4' 'Standard_GS4-8' 'Standard_GS5' 'Standard_GS5-16' 'Standard_GS5-8' 'Standard_H16' 'Standard_H16m' 'Standard_H16mr' 'Standard_H16r' 'Standard_H8' 'Standard_H8m' 'Standard_L16s' 'Standard_L32s' 'Standard_L4s' 'Standard_L8s' 'Standard_M128-32ms' 'Standard_M128-64ms' 'Standard_M128ms' 'Standard_M128s' 'Standard_M64-16ms' 'Standard_M64-32ms' 'Standard_M64ms' 'Standard_M64s' 'Standard_NC12' 'Standard_NC12s_v2' 'Standard_NC12s_v3' 'Standard_NC24' 'Standard_NC24r' 'Standard_NC24rs_v2' 'Standard_NC24rs_v3' 'Standard_NC24s_v2' 'Standard_NC24s_v3' 'Standard_NC6' 'Standard_NC6s_v2' 'Standard_NC6s_v3' 'Standard_ND12s' 'Standard_ND24rs' 'Standard_ND24s' 'Standard_ND6s' 'Standard_NV12' 'Standard_NV24' 'Standard_NV6' |
vmSizeProperties | 指定自定義虛擬機大小的屬性。 API 版本下限:2021-07-01。 此功能仍在預覽模式中,且 VirtualMachineScaleSet 不支援此功能。 如需詳細資訊,請遵循 VM 自定義 中的指示。 | VMSizeProperties |
VMSizeProperties
名稱 | 描述 | 值 |
---|---|---|
vCPUAvailable | 指定 VM 可用的 vCPU 數目。 在要求本文中未指定這個屬性時,預設行為是將它設定為 API 回應中公開該 VM 大小的 vCPU 值, 以列出區域中所有可用的虛擬機大小。 | int |
vCPUPerCore | 指定 vCPU 與實體核心比率。 在要求本文中未指定這個屬性時,預設行為會針對在 API 回應中公開的 VM 大小設定為 vCPUPerCore 的值,以 列出區域中所有可用的虛擬機大小。 將此屬性設定為 1 也表示超線程已停用。 | int |
NetworkProfile
名稱 | 描述 | 值 |
---|---|---|
networkApiVersion | 指定在網路介面組態中建立網路資源時所使用的 Microsoft.Network API 版本 | '2020-11-01' |
networkInterfaceConfigurations | 指定將用來建立虛擬機網路資源的網路設定。 | VirtualMachineNetworkInterfaceConfiguration[] |
networkInterfaces | 指定與虛擬機相關聯之網路介面的資源標識符清單。 | NetworkInterfaceReference[] |
VirtualMachineNetworkInterfaceConfiguration
名稱 | 描述 | 值 |
---|---|---|
NAME | 網路介面組態名稱。 | 字串 (必要) |
properties | 描述虛擬機網路配置檔的IP組態。 | VirtualMachineNetworkInterfaceConfigurationPropertie... |
VirtualMachineNetworkInterfaceConfigurationPropertie...
名稱 | 描述 | 值 |
---|---|---|
auxiliaryMode | 指定是否為網路介面資源啟用輔助模式。 | 'AcceleratedConnections' 'Floating' 'None' |
auxiliarySku | 指定是否為網路介面資源啟用輔助 SKU。 | 'A1' 'A2' 'A4' 'A8' 'None' |
deleteOption | 指定刪除 VM 時網路介面會發生什麼事 | 'Delete' 'Detach' |
disableTcpStateTracking | 指定是否停用 tcp 狀態追蹤的網路介面。 | bool |
dnsSettings | 要套用在網路介面上的 DNS 設定。 | VirtualMachineNetworkInterfaceDnsSettingsConfigurati... |
dscpConfiguration | SubResource | |
enableAcceleratedNetworking | 指定網路介面是否已啟用加速網路功能。 | bool |
enableFpga | 指定網路介面是否已啟用 FPGA 網路功能。 | bool |
enableIPForwarding | 是否在此 NIC 上啟用 IP 轉送。 | bool |
ipConfigurations | 指定網路介面的IP組態。 | VirtualMachineNetworkInterfaceIPConfiguration[] (必要) |
networkSecurityGroup | 網路安全組。 | SubResource |
primary | 指定虛擬機有1個以上的網路介面時的主要網路介面。 | bool |
VirtualMachineNetworkInterfaceDnsSettingsConfigurati...
名稱 | 描述 | 值 |
---|---|---|
dnsServers | DNS 伺服器 IP 位址清單 | string[] |
VirtualMachineNetworkInterfaceIPConfiguration
名稱 | 描述 | 值 |
---|---|---|
NAME | IP 組態名稱。 | 字串 (必要) |
properties | 描述虛擬機網路介面IP組態屬性。 | VirtualMachineNetworkInterfaceIPConfigurationPropert... |
VirtualMachineNetworkInterfaceIPConfigurationPropert...
名稱 | 描述 | 值 |
---|---|---|
applicationGatewayBackendAddressPools | 指定應用程式閘道後端位址池的參考數位。 虛擬機可以參考多個應用程式閘道的後端位址池。 多部虛擬機無法使用相同的應用程式閘道。 | SubResource[] |
applicationSecurityGroups | 指定應用程式安全組的參考陣列。 | SubResource[] |
loadBalancerBackendAddressPools | 指定負載平衡器後端位址池參考的陣列。 虛擬機可以參考一個公用和一個內部負載平衡器的後端位址池。 [多部虛擬機無法使用相同的基本 SKU 負載平衡器]。 | SubResource[] |
primary | 指定虛擬機有1個以上的網路介面時的主要網路介面。 | bool |
privateIPAddressVersion | 從 Api-Version 2017-03-30 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 | 'IPv4' 'IPv6' |
publicIPAddressConfiguration | publicIPAddressConfiguration。 | VirtualMachinePublicIPAddressConfiguration |
子網路 | 指定子網的識別碼。 | SubResource |
VirtualMachinePublicIPAddressConfiguration
名稱 | 描述 | 值 |
---|---|---|
NAME | publicIP 位址組態名稱。 | 字串 (必要) |
properties | 描述虛擬機IP組態的PublicIPAddress設定 | VirtualMachinePublicIPAddressConfigurationProperties |
sku | 描述公用IP Sku。 它只能使用 OrchestrationMode 設定為彈性。 | PublicIPAddressSku |
VirtualMachinePublicIPAddressConfigurationProperties
名稱 | 描述 | 值 |
---|---|---|
deleteOption | 指定刪除 VM 時,公用 IP 位址會發生什麼情況 | 'Delete' 'Detach' |
dnsSettings | 要套用至 publicIP 位址的 DNS 設定。 | VirtualMachinePublicIPAddressDnsSettingsConfiguratio... |
idleTimeoutInMinutes | 公用IP位址的閒置逾時。 | int |
ipTags | 與公用IP位址相關聯的IP標籤清單。 | VirtualMachineIpTag[] |
publicIPAddressVersion | 從 Api-Version 2019-07-01 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 | 'IPv4' 'IPv6' |
publicIPAllocationMethod | 指定公用IP配置類型 | 'Dynamic' 'Static' |
publicIPPrefix | 要從中配置 publicIP 位址的 PublicIPPrefix。 | SubResource |
VirtualMachinePublicIPAddressDnsSettingsConfiguratio...
名稱 | 描述 | 值 |
---|---|---|
domainNameLabel | 即將建立之 PublicIPAddress 資源的功能變數名稱標籤前置詞。 產生的名稱標籤是功能變數名稱標籤和 vm 網路設定檔唯一識別碼的串連。 | 需要字串 () |
domainNameLabelScope | 即將建立之 PublicIPAddress 資源的功能變數名稱標籤範圍。 產生的名稱標籤是根據功能變數名稱標籤範圍和 vm 網路配置檔唯一識別碼,與原則串連哈希功能變數名稱標籤。 | 'NoReuse' 'ResourceGroupReuse' 'SubscriptionReuse' 'TenantReuse' |
VirtualMachineIpTag
名稱 | 描述 | 值 |
---|---|---|
ipTagType | IP 標籤類型。 範例:FirstPartyUsage。 | 字串 |
標籤 | 與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 | 字串 |
PublicIPAddressSku
名稱 | 描述 | 值 |
---|---|---|
NAME | 指定公用IP SKU 名稱 | 'Basic' 'Standard' |
tier | 指定公用IP SKU層 | 'Global' 'Regional' |
NetworkInterfaceReference
名稱 | 描述 | 值 |
---|---|---|
id | 資源標識碼 | 字串 |
properties | 描述網路介面參考屬性。 | NetworkInterfaceReferenceProperties |
NetworkInterfaceReferenceProperties
名稱 | 描述 | 值 |
---|---|---|
deleteOption | 指定刪除 VM 時網路介面會發生什麼情況 | 'Delete' 'Detach' |
primary | 指定虛擬機有1個以上的網路介面時的主要網路介面。 | bool |
OSProfile
名稱 | 描述 | 值 |
---|---|---|
adminPassword | 指定系統管理員帳戶的密碼。 Windows) 長度下限 (: 8 個字元 Linux) 長度下限 (: 6 個字元 Windows) 長度上限 (: 123 個字元 Linux) 長度上限 (: 72 個字元 複雜度需求: 下列 4 個條件中需要滿足 3 個條件 字元較低 具有大字元 具有數位 具有特殊字元 (Regex 比對 [\W_]) 不允許的值: “abc@123”、“P@$$w 0rd”、“P@ssw0rd”、“P@ssword123”、“Pa$$word”、“pass@word1”、“Password!”、“Password1”、“Password22”、“P@ssword123”、“pa$$word”、“Password!”、“Password1”、“Password22”、“P@ssword123!” 如需重設密碼,請參閱 如何在 Windows VM 中重設遠端桌面服務或其登入密碼 如需重設根密碼,請參閱 使用 VMAccess 擴充功能管理使用者、SSH 及檢查或修復 Azure Linux VM 上的磁碟 |
字串 約束: 敏感性值。 以安全參數的形式傳入。 |
adminUsername | 指定系統管理員帳戶的名稱。 建立 VM 之後,就無法更新此屬性。 僅限 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 |
computerName | 指定虛擬機的主機OS名稱。 建立 VM 之後,就無法更新此名稱。 Windows) 長度上限 (: 15 個字元。 Linux) 長度上限 (: 64 個字元。 如需命名慣例和限制,請參閱 Azure 基礎結構服務實作指導方針。 | 字串 |
customData | 指定自訂資料的 Base-64 編碼字串。 Base-64 編碼字串會解碼成二進位陣列而儲存為虛擬機器上的檔案。 二進位陣列的長度上限是 65535 個位元組。 注意:請勿在 customData 屬性中傳遞任何秘密或密碼。 建立 VM 之後,就無法更新此屬性。 屬性 'customData' 會傳遞至要儲存為檔案的 VM,如需詳細資訊,請參閱 Azure VM 上的自定義數據。 如需針對Linux VM 使用cloud-init,請參閱在建立期間使用cloud-init 自定義Linux VM。 | 字串 |
linuxConfiguration | 指定虛擬機上的Linux作業系統設定。 如需支援的Linux發行版清單,請參閱 Azure-Endorsed 發行版上的Linux。 | LinuxConfiguration |
requireGuestProvisionSignal | 必須設定為 True 或省略的選擇性屬性。 | bool |
密碼 | 指定應該安裝到虛擬機器的憑證集。 若要在虛擬機上安裝憑證,建議您使用適用於Linux的 Azure 金鑰保存庫 虛擬機擴充功能或適用於 Windows 的 Azure 金鑰保存庫 虛擬機擴充功能。 | VaultSecretGroup[] |
windowsConfiguration | 指定虛擬機器上的 Windows 作業系統設定。 | WindowsConfiguration |
LinuxConfiguration
名稱 | 描述 | 值 |
---|---|---|
disablePasswordAuthentication | 指定是否應該停用密碼驗證。 | bool |
enableVMAgentPlatformUpdates | 指出是否已針對Linux虛擬機啟用VMAgent Platform 匯報。 預設值為 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 客體修補中指定 Patch 模式 AutomaticByPlatform 的其他設定。 | LinuxVMGuestPatchAutomaticByPlatformSettings |
patchMode | 指定 VM 客體修補至 IaaS 虛擬機的模式,或與 OrchestraMode 為彈性的虛擬機擴展集相關聯的虛擬機。 可能的值包括: ImageDefault - 會使用虛擬機的默認修補組態。 AutomaticByPlatform - 虛擬機將會由平台自動更新。 provisionVMAgent 屬性必須是 true |
'AutomaticByPlatform' 'ImageDefault' |
LinuxVMGuestPatchAutomaticByPlatformSettings
名稱 | 描述 | 值 |
---|---|---|
bypassPlatformSafetyChecksOnUserSchedule | 讓客戶排程修補而不意外升級 | bool |
rebootSetting | 指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。 | 'Always' 'IfRequired' 'Never' 'Unknown' |
SshConfiguration
名稱 | 描述 | 值 |
---|---|---|
publicKeys | 用來向Linux型VM進行驗證的SSH公鑰清單。 | SshPublicKey[] |
SshPublicKey
名稱 | 描述 | 值 |
---|---|---|
keyData | 用來透過 ssh 向 VM 進行驗證的 SSH 公鑰憑證。 密鑰至少必須是 2048 位,且以 ssh-rsa 格式表示。 如需建立 ssh 金鑰,請參閱 [在 Azure 中的 Linux 和 Mac 上建立 Linux VM 的 SSH 金鑰]/azure/virtual-machines/linux/create-ssh-keys-detailed) 。 | 字串 |
path | 指定儲存 ssh 公鑰之已建立 VM 上的完整路徑。 如果檔案已經存在,指定的金鑰就會附加至該檔案。 範例:/home/user/.ssh/authorized_keys | 字串 |
VaultSecretGroup
名稱 | 描述 | 值 |
---|---|---|
sourceVault | 包含 VaultCertificates 中所有憑證之 金鑰保存庫 的相對 URL。 | SubResource |
vaultCertificates | SourceVault 中包含憑證的金鑰保存庫參考清單。 | VaultCertificate[] |
VaultCertificate
名稱 | 描述 | 值 |
---|---|---|
certificateStore | 針對 Windows VM,指定應該新增憑證之虛擬機上的證書存儲。 指定的證書存儲隱含地位於LocalMachine帳戶中。 針對Linux VM,憑證檔案會放在 /var/lib/waagent 目錄底下,而 X509 憑證檔案的檔名<為 UppercaseThumbprint.crt,而<私鑰則為 UppercaseThumbprint.prv>>。 這兩個檔案都是 .pem 格式。 | 字串 |
certificateUrl | 這是已上傳至 金鑰保存庫 做為秘密之憑證的 URL。 如需將秘密新增至 金鑰保存庫,請參閱將密鑰或秘密新增至密鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼,其編碼方式為 UTF-8: { “data”:“{Base64-encoded-certificate}”, “dataType”:“pfx”, “password”:“{pfx-file-password}” } 若要在虛擬機上安裝憑證,建議您使用適用於Linux的 Azure 金鑰保存庫 虛擬機擴充功能或適用於 Windows 的 Azure 金鑰保存庫 虛擬機擴充功能。 |
字串 |
WindowsConfiguration
名稱 | 描述 | 值 |
---|---|---|
additionalUnattendContent | 指定可併入 Unattend.xml 檔案 (由 Windows 安裝程式使用) 的額外 Base-64 編碼 XML 格式資訊。 | AdditionalUnattendContent[] |
enableAutomaticUpdates | 指出是否為 Windows 虛擬機啟用自動 匯報。 預設值為 true。 對於虛擬機擴展集,此屬性可以更新,且更新會在OS重新佈建上生效。 | bool |
enableVMAgentPlatformUpdates | 指出是否已針對 Windows 虛擬機啟用 VMAgent Platform 匯報。 預設值為 False。 | bool |
patchSettings | [預覽功能]指定與 Windows 上的 VM 客體修補相關的設定。 | PatchSettings |
provisionVMAgent | 指出是否應該在虛擬機器上佈建虛擬機器代理程式。 當要求本文中未指定這個屬性時,預設會設定為 true。 這可確保 VM 代理程式已安裝在 VM 上,以便稍後將擴充功能新增至 VM。 | bool |
timeZone | 指定虛擬機的時區。 例如“Pacific Standard Time”。 可能的值可以從 TimeZoneInfo.GetSystemTimeZones 傳回的時區 TimeZoneInfo.Id 值。 | 字串 |
winRM | 指定 Windows 遠端管理接聽程式。 藉此將啟用遠端 Windows PowerShell。 | WinRMConfiguration |
AdditionalUnattendContent
名稱 | 描述 | 值 |
---|---|---|
componentName | 元件名稱。 目前唯一允許的值是 Microsoft-Windows-Shell-Setup。 | 'Microsoft-Windows-Shell-Setup' |
內容 | 針對指定的路徑和元件,指定新增至 unattend.xml 檔案的 XML 格式內容。 XML 必須小於 4KB,而且必須包含要插入之設定或功能的根元素。 | 字串 |
passName | 傳遞名稱。 目前唯一允許的值是 OobeSystem。 | 'OobeSystem' |
settingName | 指定要套用內容之設定的名稱。 可能的值為:FirstLogonCommands 和 AutoLogon。 | 'AutoLogon' 'FirstLogonCommands' |
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 虛擬機的模式,或與 OrchestraMode 為彈性的虛擬機擴展集相關聯的虛擬機。 可能的值包括: 手動 - 您可以控制將修補程式應用程式套用至虛擬機。 您可以在 VM 內手動套用修補程式來執行此動作。 在此模式中,自動更新會停用;屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 false AutomaticByOS - 作業系統會自動更新虛擬機。 WindowsConfiguration.enableAutomaticUpdates 屬性必須是 true。 AutomaticByPlatform - 虛擬機將會由平台自動更新。 provisionVMAgent 和 WindowsConfiguration.enableAutomaticUpdates 屬性必須是 true |
'AutomaticByOS' 'AutomaticByPlatform' 'Manual' |
WindowsVMGuestPatchAutomaticByPlatformSettings
名稱 | 描述 | 值 |
---|---|---|
bypassPlatformSafetyChecksOnUserSchedule | 讓客戶排程修補而不意外升級 | bool |
rebootSetting | 指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。 | 'Always' 'IfRequired' 'Never' 'Unknown' |
WinRMConfiguration
名稱 | 描述 | 值 |
---|---|---|
接聽程式 | Windows 遠端管理接聽程式清單 | WinRMListener[] |
WinRMListener
名稱 | 描述 | 值 |
---|---|---|
certificateUrl | 這是已上傳至 金鑰保存庫 做為秘密的憑證 URL。 如需將秘密新增至 金鑰保存庫,請參閱將密鑰或秘密新增至密鑰保存庫。 在此情況下,您的憑證必須是以UTF-8編碼的下列 JSON 物件的Base64編碼: { “data”:“{Base64-encoded-certificate}”, “dataType”:“pfx”, “password”:“{pfx-file-password}” } 若要在虛擬機上安裝憑證,建議您使用適用於Linux的 Azure 金鑰保存庫 虛擬機擴充功能,或適用於Windows的 Azure 金鑰保存庫 虛擬機擴充功能。 |
字串 |
protocol | 指定 WinRM 接聽程式的通訊協定。 可能的值為: HTTP、https。 | 'Http' 'Https' |
ScheduledEventsProfile
名稱 | 描述 | 值 |
---|---|---|
osImageNotificationProfile | 指定OS映像排程事件相關組態。 | OSImageNotificationProfile |
terminateNotificationProfile | 指定終止排程事件相關組態。 | TerminateNotificationProfile |
OSImageNotificationProfile
名稱 | 描述 | 值 |
---|---|---|
enable | 指定是否啟用或停用OS映像排程事件。 | bool |
notBeforeTimeout | 虛擬機重新映像或升級操作系統的時間長度,在事件自動核准之前,必須先核准OS映射排程事件, (逾時) 。 組態是以 ISO 8601 格式指定,值必須是 15 分鐘 (PT15M) | 字串 |
TerminateNotificationProfile
名稱 | 描述 | 值 |
---|---|---|
enable | 指定是否啟用或停用 Terminate Scheduled 事件。 | bool |
notBeforeTimeout | 刪除虛擬機的可設定時間長度,在事件自動核准之前,虛擬機必須核准終止排程事件, (逾時) 。 設定必須以 ISO 8601 格式指定,預設值為 5 分鐘, (PT5M) | 字串 |
SecurityProfile
名稱 | 描述 | 值 |
---|---|---|
encryptionAtHost | 這個屬性可由要求中的使用者用來啟用或停用虛擬機或虛擬機擴展集的主機加密。 這會啟用所有磁碟的加密,包括主機本身的資源/暫存磁碟。 默認行為為:除非資源的此屬性設定為 true,否則將會停用主機的加密。 | bool |
encryptionIdentity | 指定 ADE 用來取得 Keyvault 作業存取令牌的受控識別。 | EncryptionIdentity |
proxyAgentSettings | 指定建立虛擬機時的 ProxyAgent 設定。 API 版本下限:2023-09-01。 | ProxyAgentSettings |
securityType | 指定虛擬機的 SecurityType。 它必須設定為任何指定的值,才能啟用 UefiSettings。 默認行為為:除非設定此屬性,否則不會啟用 UefiSettings。 | 'ConfidentialVM' 'TrustedLaunch' |
uefiSettings | 指定安全性設定,例如建立虛擬機時所使用的安全開機和 vTPM。 API 版本下限:2020-12-01。 | UefiSettings |
EncryptionIdentity
名稱 | 描述 | 值 |
---|---|---|
userAssignedIdentityResourceId | 指定與 VM 相關聯的其中一個使用者身分識別的 ARM 資源識別碼。 | 字串 |
ProxyAgentSettings
名稱 | 描述 | 值 |
---|---|---|
已啟用 | 指定是否應在虛擬機或虛擬機擴展集上啟用 ProxyAgent 功能。 | bool |
keyIncarnationId | 增加此屬性的值可讓使用者重設用來保護客體與主機之間通道的密鑰。 | int |
mode | 指定啟用此功能時,ProxyAgent 將會在 上執行的模式。 ProxyAgent 會開始稽核或監視,但不會在稽核模式中對主機端點的要求強制執行訪問控制,而在 [強制執行] 模式中,則會強制執行訪問控制。 默認值為 [強制模式]。 | 'Audit' 'Enforce' |
UefiSettings
名稱 | 描述 | 值 |
---|---|---|
secureBootEnabled | 指定是否應在虛擬機上啟用安全開機。 API 版本下限:2020-12-01。 | bool |
vTpmEnabled | 指定是否應在虛擬機上啟用 vTPM。 API 版本下限:2020-12-01。 | bool |
StorageProfile
名稱 | 描述 | 值 |
---|---|---|
dataDisks | 指定用來將資料磁碟加入至虛擬機器的參數。 如需磁碟的詳細資訊,請參閱 關於 Azure 虛擬機的磁碟和 VHD。 | DataDisk[] |
diskControllerType | 指定為 VM 設定的磁碟控制器類型。 注意: 如果未指定,則會使用 『hyperVGeneration』 設定為 V2,根據指定之最低 API 版本之作業系統磁碟和 VM 大小的功能,將此屬性設定為預設磁碟控制器類型。 除非您更新 VM 組態中的 VM 大小,以隱含地解除分配和重新配置 VM,否則您必須在更新其磁碟控制器類型之前解除分配 VM。 API 版本下限:2022-08-01。 | 'NVMe' 'SCSI' |
imageReference | 指定要使用之映像的相關信息。 您可以指定平臺映像、Marketplace 映像或虛擬機映射的相關信息。 當您想要使用平臺映像、市集映像或虛擬機映像,但不會用於其他建立作業時,需要此元素。 | ImageReference |
osDisk | 指定虛擬機所使用的作業系統磁碟相關信息。 如需磁碟的詳細資訊,請參閱 關於 Azure 虛擬機的磁碟和 VHD。 | OSDisk |
DataDisk
名稱 | 描述 | 值 |
---|---|---|
快取 | 指定快取需求。 可能的值為: None、ReadOnly、ReadWrite。 默認行為為: 標準記憶體的 None。進階記憶體的 ReadOnly。 | 'None' 'ReadOnly' 'ReadWrite' |
createOption | 指定應如何建立虛擬機。 可能的值為: Attach。 當您使用特製化磁碟來建立虛擬機時,會使用此值。 FromImage。 當您使用映像來建立虛擬機時,會使用此值。 如果您使用平臺映像,則也應該使用上述的 imageReference 元素。 如果您使用 Marketplace 映射,則也應該使用先前所述的方案元素。 | 'Attach' 'Empty' 需要 『FromImage』 () |
deleteOption | 指定在 VM 刪除時應該刪除或中斷連結資料磁碟。 可能的值為: Delete。 如果使用此值,則會在刪除 VM 時刪除資料磁碟。 分離。 如果使用此值,則會在刪除 VM 之後保留資料磁碟。 默認值設定為 [卸離]。 | 'Delete' 'Detach' |
detachOption | 指定卸離磁碟時所要使用的卸離行為,或已在從虛擬機中斷鏈接的過程中使用。 支援的值: ForceDetach。 detachOption: ForceDetach 僅適用於受控數據磁碟。 如果先前的數據磁碟斷連結嘗試因為虛擬機發生意外失敗而未完成,但磁碟仍然未釋放,請使用強制卸離作為最後一個從 VM 強制卸離磁碟的選項。 使用這個卸離行為時,所有寫入可能都尚未排清。 此功能仍在預覽模式中 ,且 VirtualMachineScaleSet 不支援此功能。 強制將數據磁碟更新強制中斷連結至 『true』,以及設定 detachOption:『ForceDetach』。 | 'ForceDetach' |
diskSizeGB | 指定以 GB 為單位的空白資料磁碟大小。 此元素可用來覆寫虛擬機映像中的磁碟大小。 屬性 'diskSizeGB' 是磁碟的位元組 x 1024^3 數目,值不能大於 1023。 | int |
image | 來源使用者映像虛擬硬碟。 在連接至虛擬機之前,將會先複製虛擬硬碟。 如果提供SourceImage,目的地虛擬硬碟不得存在。 | VirtualHardDisk |
lun | 指定數據磁碟的邏輯單位編號。 此值是用來識別 VM 內的數據磁碟,因此對於連結至 VM 的每個數據磁碟而言,都必須是唯一的。 | int (必要) |
ManagedDisk | 受控磁碟參數。 | ManagedDiskParameters |
NAME | 磁碟名稱。 | 字串 |
toBeDetached | 指定數據磁碟是否正在從 VirtualMachine/VirtualMachineScaleset 中斷連結 | bool |
vhd | 虛擬硬碟。 | VirtualHardDisk |
writeAcceleratorEnabled | 指定是否應該在磁碟上啟用或停用 writeAccelerator。 | bool |
VirtualHardDisk
名稱 | 描述 | 值 |
---|---|---|
uri | 指定虛擬硬碟的 URI。 | 字串 |
ManagedDiskParameters
名稱 | 描述 | 值 |
---|---|---|
diskEncryptionSet | 指定受控磁碟的客戶受控磁碟加密集資源標識符。 | DiskEncryptionSetParameters |
id | 資源標識碼 | 字串 |
securityProfile | 指定受控磁碟的安全性配置檔。 | VMDiskSecurityProfile |
storageAccountType | 指定受控磁碟的記憶體帳戶類型。 注意:UltraSSD_LRS只能與數據磁碟搭配使用,它不能與OS磁碟搭配使用。 | 'PremiumV2_LRS' 'Premium_LRS' 'Premium_ZRS' 'StandardSSD_LRS' 'StandardSSD_ZRS' 'Standard_LRS' 'UltraSSD_LRS' |
DiskEncryptionSetParameters
名稱 | 描述 | 值 |
---|---|---|
id | 資源標識碼 | 字串 |
VMDiskSecurityProfile
名稱 | 描述 | 值 |
---|---|---|
diskEncryptionSet | 針對客戶受控密鑰加密的機密VM OS 磁碟和 VMGuest Blob,指定受控磁碟的客戶受控磁碟加密集資源識別碼。 | DiskEncryptionSetParameters |
securityEncryptionType | 指定受控磁碟的 EncryptionType。 它設定為 DiskWithVMGuestState 以加密受控磁碟以及 VMGuestState Blob、VMGuestStateOnly 只加密 VMGuestState Blob,以及 NonPersistedTPM 用於不保存 VMGuestState Blob 中的韌體狀態。 注意: 它只能設定為機密 VM。 | 'DiskWithVMGuestState' 'NonPersistedTPM' 'VMGuestStateOnly' |
ImageReference
名稱 | 描述 | 值 |
---|---|---|
communityGalleryImageId | 指定 vm 部署的社群資源庫映像唯一標識碼。 這可以從社群資源庫映像 GET 呼叫擷取。 | 字串 |
id | 資源標識碼 | 字串 |
供應項目 | 指定用來建立虛擬機的平臺映像或 Marketplace 映像供應專案。 | 字串 |
publisher | 映像發行者。 | 字串 |
sharedGalleryImageId | 指定 VM 部署的共享資源庫映像唯一識別碼。 這可以從共用資源庫映像 GET 呼叫擷取。 | 字串 |
sku | 映像 SKU。 | 字串 |
version | 指定用來建立虛擬機的平臺映像或 Marketplace 映像版本。 允許的格式為 Major.Minor.Build 或 'latest'。 主要、次要和組建都是十進位數。 指定「最新」以使用部署階段可用的最新映像版本。 即使您使用「最新」,即使有新版本可供使用,VM 映像也不會在部署時間之後自動更新。 請勿針對資源庫映射部署使用字段 'version',資源庫映射應該一律使用 'id' 字段進行部署,若要使用資源庫映射的 'latest' 版本,只要設定 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}',就不需要輸入版本。 | 字串 |
OSDisk
名稱 | 描述 | 值 |
---|---|---|
快取 | 指定快取需求。 可能的值為: None、ReadOnly、ReadWrite。 默認行為為: 標準記憶體的 None。進階記憶體的 ReadOnly。 | 'None' 'ReadOnly' 'ReadWrite' |
createOption | 指定應如何建立虛擬機。 可能的值為: Attach。 當您使用特製化磁碟來建立虛擬機時,會使用此值。 FromImage。 當您使用映像來建立虛擬機時,會使用此值。 如果您使用平臺映像,則也應該使用上述的 imageReference 元素。 如果您使用 Marketplace 映射,則也應該使用先前所述的方案元素。 | 'Attach' 'Empty' 需要 『FromImage』 () |
deleteOption | 指定在 VM 刪除時應刪除或中斷連結 OS 磁碟。 可能的值為: Delete。 如果使用此值,則會在刪除 VM 時刪除 OS 磁碟。 分離。 如果使用此值,則會在刪除 VM 之後保留 os 磁碟。 默認值設定為 [卸離]。 若為暫時OS磁碟,預設值會設定為 Delete。 使用者無法變更暫時 OS 磁碟的刪除選項。 | 'Delete' 'Detach' |
diffDiskSettings | 指定虛擬機所使用作業系統磁碟的暫時磁碟設定。 | DiffDiskSettings |
diskSizeGB | 指定以 GB 為單位的空白資料磁碟大小。 此元素可用來覆寫虛擬機映像中的磁碟大小。 屬性 'diskSizeGB' 是磁碟的位元組 x 1024^3 數目,且值不能大於 1023。 | int |
encryptionSettings | 指定 OS 磁碟的加密設定。 API 版本下限:2015-06-15。 | DiskEncryptionSettings |
image | 來源使用者映像虛擬硬碟。 虛擬硬碟將會先複製,再連結至虛擬機。 如果提供SourceImage,目的地虛擬硬碟不得存在。 | VirtualHardDisk |
ManagedDisk | 受控磁碟參數。 | ManagedDiskParameters |
NAME | 磁碟名稱。 | 字串 |
osType | 此屬性可讓您指定從使用者映像或特製化 VHD 建立 VM 時,磁碟包含的 OS 類型。 可能的值為: Windows、Linux。 | 'Linux' 'Windows' |
vhd | 虛擬硬碟。 | VirtualHardDisk |
writeAcceleratorEnabled | 指定是否應該在磁碟上啟用或停用 writeAccelerator。 | bool |
DiffDiskSettings
名稱 | 描述 | 值 |
---|---|---|
選項 | 指定作業系統磁碟的暫時磁碟設定。 | 'Local' |
放置 | 指定作業系統磁碟的暫時磁碟位置。 可能的值為: CacheDisk、ResourceDisk。 默認行為為:如果已針對 VM 大小設定 快取Disk ,否則會使用 ResourceDisk 。 請參閱 /azure/virtual-machines/windows/size 和 Linux VM 位於 /azure/virtual-machines/linux/size 的 Windows VM 大小檔,以檢查哪些 VM 大小會公開快取磁碟。 | 'CacheDisk' 'ResourceDisk' |
DiskEncryptionSettings
名稱 | 描述 | 值 |
---|---|---|
diskEncryptionKey | 指定磁碟加密金鑰的位置,這是 金鑰保存庫 秘密。 | KeyVaultSecretReference |
已啟用 | 指定是否應在虛擬機上啟用磁碟加密。 | bool |
keyEncryptionKey | 指定 金鑰保存庫 中金鑰加密金鑰的位置。 | KeyVaultKeyReference |
KeyVaultSecretReference
名稱 | 描述 | 值 |
---|---|---|
secretUrl | 參考 金鑰保存庫 中秘密的URL。 | 需要字串 () |
sourceVault | 包含秘密之 金鑰保存庫的相對 URL。 | 必要子資源 () |
KeyVaultKeyReference
名稱 | 描述 | 值 |
---|---|---|
keyUrl | 在 金鑰保存庫 中參考金鑰加密金鑰的 URL。 | 需要字串 () |
sourceVault | 包含金鑰之 金鑰保存庫 的相對 URL。 | 必要子資源 () |
快速入門範本
下列快速入門範本會部署此資源類型。
範本 | 描述 |
---|---|
部署簡單的Linux VM,並將私人IP更新為靜態 |
此範本可讓您從市集使用Ubuntu部署簡單的Linux VM。 這會使用動態指派的IP位址,在資源群組位置中部署 VNET、子網和 A1 大小 VM,然後將它轉換成靜態IP。 |
使用資源迴圈在可用性設定組中建立 VM |
使用資源迴圈在可用性設定組中建立 2-5 部 VM。 VM 可以是 Unbuntu 或 Windows,最多 5 部 VM,因為此範例使用單一 storageAccount |
具有受控磁碟的多重 VM 範本 |
此範本會建立具有受控磁碟、公用IP和網路介面的N個VM數目。 它會在單一可用性設定組中建立 VM。 它們將會布建在 虛擬網路 中,也會建立為部署的一部分 |
在 Windows VM 上安裝檔案 |
此範本可讓您部署 Windows VM 並執行自定義 PowerShell 腳本,以在該 VM 上安裝檔案。 |
使用自定義數據部署虛擬機 |
此範本可讓您建立虛擬機,並將自定義數據傳遞至 VM。 此範本也會部署記憶體帳戶、虛擬網路、公用IP位址和網路介面。 |
使用診斷部署進階 Windows VM |
此範本可讓您使用 Windows 版本的幾個不同選項,使用最新的修補版本來部署進階 Windows VM。 |
在不同的資源群組的 VNET 中建立 VM |
此範本會在位於不同資源群組的 VNET 中建立 VM |
將 VM 加入現有的網域 |
此範本示範在雲端中加入私人 AD 網域的網域。 |
建立具有動態選取數據磁碟的 VM |
此範本可讓用戶選取想要新增至 VM 的數據磁碟數目。 |
從 EfficientIP VHD 建立 VM |
此範本會從 EfficientIP VHD 建立 VM,並讓您將其連線到位於另一個資源群組中的現有 VNET,然後虛擬機 |
從使用者映像建立 VM |
此範本可讓您從使用者映像建立 虛擬機器。 此範本也會部署 虛擬網路、公用IP位址和網路介面。 |
從一般化 VHD 在新的或現有的 vnet 中建立 VM |
此範本會從一般化 VHD 建立 VM,並讓您將其連線到新的或現有的 VNET,該 VNET 可以位於虛擬機以外的另一個資源群組中 |
CentOS/UbuntuServer 自動動態磁碟 & Docker 1.12 (cs) |
這是建立單一實例 CentOS 7.2/7.1/6.5 或 Ubuntu Server 16.04.0-LTS 的常見範本,其中包含可設定的數據磁碟數目, (可設定的大小) 。 入口網站參數中可以提及最多 16 個磁碟,而且每個磁碟的大小上限應小於 1023 GB。 MDADM RAID0 Array 會自動掛接,並存留於重新啟動。 最新的 Docker 1.12 (cs3) (Swarm) ,docker-compose 1.9.0 & docker-machine 0.8.2 可從使用者 azure-cli 自動以 docker 容器的形式執行。 這個單一實例範本是 HPC/GPU 叢集範本的異地 |
具有序列輸出的Linux VM |
此範本會建立簡單的 Linux VM,並將參數和序列/主控台設定為輸出至記憶體 |
使用監視和診斷部署簡單的 Windows VM |
此範本可讓您部署簡單的 Windows VM 以及可啟用 VM 監視和診斷的診斷擴充功能 |
使用 MSI 部署 Linux 或 Windows VM |
此範本可讓您使用受控服務識別來部署Linux或Windows VM。 |
Azure 上的 Terraform |
此範本可讓您將 Terraform 工作站部署為具有 MSI 的 Linux VM。 |
具有 MSI 存取記憶體的 Linux VM |
此範本會部署 Linux VM,其中包含系統指派的受控識別,可存取不同資源群組中的記憶體帳戶。 |
從具有 4 個空白數據磁碟的 Windows 映射建立 VM |
此範本可讓您從指定的映像建立 Windows 虛擬機。 它也會連結 4 個空的數據磁碟。 請注意,您可以指定空白數據磁碟的大小。 |
部署具有多個IP的 VM |
此範本可讓您部署具有 3 個 IP 組態的 VM。 此範本會分別部署名為 myVM1 且具有 3 個 IP 組態的 Linux/Windows VM: IPConfig-1、 IPConfig-2 和 IPConfig-3。 |
使用多個UBUNTU部署Linux VM (Ubuntu) |
此範本會建立具有多個子網的 VNet,並部署具有多個 NIC 的 Ubuntu VM |
具有條件式資源的虛擬機 |
此範本允許使用 虛擬網路、記憶體和公用IP位址的新或現有資源來部署Linux VM。 它也允許在 SSH 和密碼驗證之間進行選擇。 範本會使用條件和邏輯函式來移除巢狀部署的需求。 |
從現有的 VHD 建立 VM,並將其連線至現有的VNET |
此範本會從 VHD 建立 VM (OS + 資料磁碟) ,並讓您將其連線到位於另一個資源群組的現有 VNET,然後虛擬機 |
將憑證推送至 Windows VM |
將憑證推送至 Windows VM。 |
使用 金鑰保存庫保護 VM 密碼 |
此範本可讓您擷取儲存在 金鑰保存庫 中的密碼,以部署簡單的 Windows VM。 因此,密碼永遠不會在範本參數檔案中放入純文本 |
在資源群組位置中部署簡單的FreeBSD VM |
此範本可讓您使用最新修補的版本,使用FreeBSD版本的幾個不同選項來部署簡單的FreeBSD VM。 這會部署在 D1 VM 大小的資源群組位置中。 |
部署簡單的UbuntuLinux VM 18.04-LTS |
此範本會部署具有一些 VM 選項的 Ubuntu Server。 您可以提供 VM 名稱、OS 版本、VM 大小、系統管理員使用者名稱和密碼。 VM 大小預設為 Standard_B2s,而 O.S 版本為 18.04-LTS。 |
使用加速網路部署簡單的Linux VM |
此範本可讓您使用Ubuntu 18.04-LTS 18.04-LTS搭配最新修補版本來部署具有加速網路的簡單Linux VM。 這會在資源群組位置中部署D3_v2大小 VM,並傳回 VM 的 FQDN。 |
Red Hat Enterprise Linux VM (RHEL 7.8) |
此範本會部署 Red Hat Enterprise Linux VM (RHEL 7.8) ,使用標準 D1 VM 上所選版本的隨用隨付 RHEL VM 映射,並將額外 100 GiB 數據磁碟連結至 VM 的資源群組位置。 此映像會產生額外費用 - 如需詳細資訊,請參閱 Azure VM 定價頁面。 |
Red Hat Enterprise Linux VM (RHEL 7.8 Unmanaged) |
此範本會部署 Red Hat Enterprise Linux VM (RHEL 7.8) ,使用隨用隨付 RHEL VM 映射,在所選資源群組的位置,將所選 A1_v2版本的隨用隨付 RHEL VM 映射部署至您所選資源群組的位置,並附加額外的 100 GiB 數據磁碟至 VM。 此映像會產生額外費用 - 如需詳細資訊,請參閱 Azure VM 定價頁面。 |
SUSE Linux Enterprise Server VM (SLES 12) |
此範本可讓您使用標準 D1 VM 上所選版本的隨用隨付 SLES VM 映射,在所選資源群組的位置部署 SUSE Linux Enterprise Server VM (SLES 12) 。 此映像會產生額外費用 - 如需詳細資訊,請參閱 Azure VM 定價頁面。 |
部署簡單的 Windows VM |
此範本可讓您使用 Windows 版本的幾個不同選項,使用最新的修補版本來部署簡單的 Windows VM。 這會在資源群組位置中部署 A2 大小 VM,並傳回 VM 的 FQDN。 |
使用 Visual Studio 部署 Windows Server VM |
此範本會部署具有 Visual Code Studio Community 2019 的 Windows Server VM,以及 VM 的幾個選項。 您可以提供 VM 的名稱、系統管理員使用者名稱和系統管理員密碼。 |
將 VM 部署到可用性區域 |
此範本可讓您使用最新的修補版本,在 Windows 或 Ubuntu) 部署簡單的 VM (。 這會在指定的位置部署A2_v2大小 VM,並傳回 VM 的 FQDN。 |
從自定義 VHD 在新的或現有的 vnet 中建立 VM |
此範本會從特製化 VHD 建立 VM,並讓您將其連線到新的或現有的 VNET,該 VNET 可以位於虛擬機以外的另一個資源群組中 |
SQL Server 2014 SP2 Enterprise 與自動備份 |
此範本會建立已啟用自動備份功能的 SQL Server 2014 SP2 Enterprise 版本 |
SQL Server 2014 SP1 Enterprise 與自動修補 |
此範本會建立已啟用自動修補功能的 SQL Server 2014 SP1 Enterprise 版。 |
SQL Server 2014 SP1 Enterprise 與 Azure 金鑰保存庫 |
此範本會建立已啟用 Azure 金鑰保存庫 Integration 功能的 SQL Server 2014 SP1 Enterprise 版本。 |
使用 SSH rsa 公鑰部署虛擬機 |
此範本可讓您建立具有 SSH rsa 公鑰的虛擬機 |
使用標籤部署簡單的 Windows VM |
此範本會部署D2_v3 Windows VM、NIC、記憶體帳戶、虛擬網路、公用IP位址和網路安全組。 卷標物件會在變數中建立,並在適用的情況下套用至所有資源。 |
部署支援受信任啟動的Linux虛擬機 |
此範本可讓您使用 Linux 版本的幾個不同選項,使用最新的修補版本,部署具有受信任啟動功能的 Linux 虛擬機。 如果您啟用 Secureboot 和 vTPM,客體證明擴充功能將會安裝在您的 VM 上。 此延伸模組將會由雲端執行遠程 證明 。 根據預設,這會在資源群組位置中部署Standard_D2_v3大小的虛擬機,並傳回虛擬機的 FQDN。 |
部署支援受信任啟動的 Windows 虛擬機 |
此範本可讓您使用 Windows 版本的幾個不同選項,使用最新的修補版本,部署具有受信任啟動功能的 Windows 虛擬機。 如果您啟用 Secureboot 和 vTPM,客體證明擴充功能將會安裝在您的 VM 上。 此延伸模組將會由雲端執行遠程 證明 。 根據預設,這會在資源群組位置中部署Standard_D2_v3大小的虛擬機,並傳回虛擬機的 FQDN。 |
使用用戶數據部署虛擬機 |
此範本可讓您建立虛擬機,並將用戶數據傳遞至 VM。 此範本也會部署 虛擬網路、公用IP位址和網路介面。 |
部署具有 Windows Admin Center 擴充功能的 Windows VM |
此範本可讓您部署具有 Windows Admin Center 擴充功能的 Windows VM,以便直接從 Azure 入口網站管理 VM。 |
具有 Azure 安全基準的 Windows VM |
此範本會在具有公用IP位址的新虛擬網路中建立執行 Windows Server 的虛擬機。 部署機器之後,即會安裝客體設定擴充功能,並套用適用於 Windows Server 的 Azure 安全基準。 如果機器的設定漂移,您可以再次部署範本來重新套用設定。 |
部署具有可變數據磁碟數目的 Windows VM |
此範本可讓您部署簡單的 VM,並使用 參數在部署時指定資料磁碟數目。 請注意,數據磁碟的數目和大小會系結於 VM 大小。 此範例的 VM 大小Standard_DS4_v2預設為 16 個數據磁碟。 |
具有 SSH 的 Windows Server VM |
部署已啟用Open SSH 的單一 Windows VM,以便您可以使用金鑰型驗證透過 SSH 進行連線。 |
建立數據管理閘道並在 Azure VM 上安裝 |
此範本會部署虛擬機,並建立可運作的數據管理閘道 |
具有 RDP 連接埠的虛擬機 |
建立虛擬機,併為負載平衡器中的 VM 建立 RDP 的 NAT 規則 |
建立具有多個空白 StandardSSD_LRS 資料磁碟的 VM |
此範本可讓您從指定的映像建立 Windows 虛擬機。 它預設也會連結多個空的 StandardSSD 數據磁碟。 請注意,您可以指定空白數據磁碟的大小和記憶體類型 (Standard_LRS、StandardSSD_LRS和Premium_LRS) 。 |
Azure VM 上的自我裝載 Integration Runtime |
此範本會建立自我裝載整合運行時間,並在 Azure 虛擬機上註冊它 |
將多個 VM 新增至虛擬機擴展集 |
此範本會使用受控磁碟、公用IP和網路介面建立 N 個 VM 數目。 它會在彈性協調流程模式的虛擬機擴展集中建立 VM。 它們將會在部署過程中建立的 虛擬網路 中布建 |
在 ILB 後方部署具有 Linux VM 的 VM 擴展集 |
此範本可讓您使用最新修補版本的 Ubuntu Linux 15.10 或 14.04.4-LTS 來部署 Linux VM 的 VM 擴展集。 這些 VM 位於內部負載平衡器後方,具有 SSH 連線的 NAT 規則。 |
Terraform (AzAPI 提供者) 資源定義
virtualMachines 資源類型可以使用目標作業來部署:
- 資源群組
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄。
資源格式
若要建立 Microsoft.Compute/virtualMachines 資源,請將下列 Terraform 新增至範本。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Compute/virtualMachines@2023-09-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
additionalCapabilities = {
hibernationEnabled = bool
ultraSSDEnabled = bool
}
applicationProfile = {
galleryApplications = [
{
configurationReference = "string"
enableAutomaticUpgrade = bool
order = int
packageReferenceId = "string"
tags = "string"
treatFailureAsDeploymentFailure = bool
}
]
}
availabilitySet = {
id = "string"
}
billingProfile = {
maxPrice = "decimal-as-string"
}
capacityReservation = {
capacityReservationGroup = {
id = "string"
}
}
diagnosticsProfile = {
bootDiagnostics = {
enabled = bool
storageUri = "string"
}
}
evictionPolicy = "string"
extensionsTimeBudget = "string"
hardwareProfile = {
vmSize = "string"
vmSizeProperties = {
vCPUsAvailable = int
vCPUsPerCore = int
}
}
host = {
id = "string"
}
hostGroup = {
id = "string"
}
licenseType = "string"
networkProfile = {
networkApiVersion = "2020-11-01"
networkInterfaceConfigurations = [
{
name = "string"
properties = {
auxiliaryMode = "string"
auxiliarySku = "string"
deleteOption = "string"
disableTcpStateTracking = bool
dnsSettings = {
dnsServers = [
"string"
]
}
dscpConfiguration = {
id = "string"
}
enableAcceleratedNetworking = bool
enableFpga = bool
enableIPForwarding = bool
ipConfigurations = [
{
name = "string"
properties = {
applicationGatewayBackendAddressPools = [
{
id = "string"
}
]
applicationSecurityGroups = [
{
id = "string"
}
]
loadBalancerBackendAddressPools = [
{
id = "string"
}
]
primary = bool
privateIPAddressVersion = "string"
publicIPAddressConfiguration = {
name = "string"
properties = {
deleteOption = "string"
dnsSettings = {
domainNameLabel = "string"
domainNameLabelScope = "string"
}
idleTimeoutInMinutes = int
ipTags = [
{
ipTagType = "string"
tag = "string"
}
]
publicIPAddressVersion = "string"
publicIPAllocationMethod = "string"
publicIPPrefix = {
id = "string"
}
}
sku = {
name = "string"
tier = "string"
}
}
subnet = {
id = "string"
}
}
}
]
networkSecurityGroup = {
id = "string"
}
primary = bool
}
}
]
networkInterfaces = [
{
id = "string"
properties = {
deleteOption = "string"
primary = bool
}
}
]
}
osProfile = {
adminPassword = "string"
adminUsername = "string"
allowExtensionOperations = bool
computerName = "string"
customData = "string"
linuxConfiguration = {
disablePasswordAuthentication = bool
enableVMAgentPlatformUpdates = bool
patchSettings = {
assessmentMode = "string"
automaticByPlatformSettings = {
bypassPlatformSafetyChecksOnUserSchedule = bool
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 = {
bypassPlatformSafetyChecksOnUserSchedule = bool
rebootSetting = "string"
}
enableHotpatching = bool
patchMode = "string"
}
provisionVMAgent = bool
timeZone = "string"
winRM = {
listeners = [
{
certificateUrl = "string"
protocol = "string"
}
]
}
}
}
platformFaultDomain = int
priority = "string"
proximityPlacementGroup = {
id = "string"
}
scheduledEventsProfile = {
osImageNotificationProfile = {
enable = bool
notBeforeTimeout = "string"
}
terminateNotificationProfile = {
enable = bool
notBeforeTimeout = "string"
}
}
securityProfile = {
encryptionAtHost = bool
encryptionIdentity = {
userAssignedIdentityResourceId = "string"
}
proxyAgentSettings = {
enabled = bool
keyIncarnationId = int
mode = "string"
}
securityType = "string"
uefiSettings = {
secureBootEnabled = bool
vTpmEnabled = bool
}
}
storageProfile = {
dataDisks = [
{
caching = "string"
createOption = "string"
deleteOption = "string"
detachOption = "ForceDetach"
diskSizeGB = int
image = {
uri = "string"
}
lun = int
managedDisk = {
diskEncryptionSet = {
id = "string"
}
id = "string"
securityProfile = {
diskEncryptionSet = {
id = "string"
}
securityEncryptionType = "string"
}
storageAccountType = "string"
}
name = "string"
toBeDetached = bool
vhd = {
uri = "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 = "Local"
placement = "string"
}
diskSizeGB = int
encryptionSettings = {
diskEncryptionKey = {
secretUrl = "string"
sourceVault = {
id = "string"
}
}
enabled = bool
keyEncryptionKey = {
keyUrl = "string"
sourceVault = {
id = "string"
}
}
}
image = {
uri = "string"
}
managedDisk = {
diskEncryptionSet = {
id = "string"
}
id = "string"
securityProfile = {
diskEncryptionSet = {
id = "string"
}
securityEncryptionType = "string"
}
storageAccountType = "string"
}
name = "string"
osType = "string"
vhd = {
uri = "string"
}
writeAcceleratorEnabled = bool
}
}
userData = "string"
virtualMachineScaleSet = {
id = "string"
}
}
zones = [
"string"
]
extendedLocation = {
name = "string"
type = "EdgeZone"
}
plan = {
name = "string"
product = "string"
promotionCode = "string"
publisher = "string"
}
})
}
屬性值
virtualMachines
名稱 | 描述 | 值 |
---|---|---|
類型 | 資源類型 | “Microsoft.Compute/virtualMachines@2023-09-01” |
NAME | 資源名稱 | 字串 (必要) 字元限制:1-15 (Windows) 1-64 (Linux) 合法字元: 不能使用空格、控制字元或下列字元: ~ ! @ # $ % ^ & * ( ) = + _ [ ] { } \ | ; : . ' " , < > / ? Windows VM 不能包含句號或以連字號結尾。 Linux VM 不能以句號或連字號結尾。 |
location | 資源位置 | 字串 (必要) |
parent_id | 若要部署至資源群組,請使用該資源群組的標識碼。 | 字串 (必要) |
tags | 資源標籤 | 標記名稱和值的字典。 |
extendedLocation | 虛擬機的擴充位置。 | ExtendedLocation |
身分識別 | 如果已設定,則為虛擬機的身分識別。 | VirtualMachineIdentity |
方案 | 指定用來建立虛擬機之 Marketplace 映像的相關信息。 此元素僅用於市集映像。 您必須先啟用映像以程序設計方式使用,才能從 API 使用市集映射。 在 Azure 入口網站 中,尋找您想要使用的市集映射,然後按兩下 [想要以程序設計方式部署],[開始使用] -> 。 輸入任何必要資訊,然後按兩下 [ 儲存]。 | 方案 |
properties | 描述虛擬機的屬性。 | VirtualMachineProperties |
zones (區域) | 虛擬機區域。 | string[] |
ExtendedLocation
名稱 | 描述 | 值 |
---|---|---|
NAME | 擴充位置的名稱。 | 字串 |
type | 擴充位置的類型。 | “EdgeZone” |
VirtualMachineIdentity
名稱 | 描述 | 值 |
---|---|---|
類型 | 用於虛擬機的身分識別類型。 「SystemAssigned、UserAssigned」類型同時包含隱含建立的身分識別,和一組使用者指派的身分識別。 類型 『None』 將會從虛擬機中移除任何身分識別。 | “SystemAssigned” “SystemAssigned, UserAssigned” “UserAssigned” |
identity_ids | 與虛擬機相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 | 使用者身分識別標識碼的陣列。 |
UserAssignedIdentities
名稱 | 描述 | 值 |
---|---|---|
{自定義屬性} | UserAssignedIdentitiesValue | |
{自定義屬性} | UserAssignedIdentitiesValue |
UserAssignedIdentitiesValue
此物件不包含部署期間要設定的任何屬性。 所有屬性都是 ReadOnly。
計畫
名稱 | 描述 | 值 |
---|---|---|
NAME | 方案標識碼。 | 字串 |
產品 | 指定市集中映像的產品。 這與 imageReference 元素下的 Offer 值相同。 | 字串 |
promotionCode | 促銷碼。 | 字串 |
publisher | 發行者標識碼。 | 字串 |
VirtualMachineProperties
名稱 | 描述 | 值 |
---|---|---|
additionalCapabilities | 指定在虛擬機上啟用或停用的其他功能。 | AdditionalCapabilities |
applicationProfile | 指定應該提供給 VM/VMSS 的資源庫應用程式。 | ApplicationProfile |
availabilitySet | 指定虛擬機應指派給的可用性設定組相關信息。 在相同可用性設定組中指定的虛擬機器會配置到不同的節點,以便將可用性最大化。 如需可用性設定組的詳細資訊,請參閱 可用性設定組概觀。 如需 Azure 計劃性維護的詳細資訊,請參閱 Azure 中 虛擬機器 的維護和更新。 目前,VM 只能在建立時新增至可用性設定組。 要新增 VM 的可用性設定組應該位於與可用性設定組資源相同的資源群組之下。 現有的 VM 無法新增至可用性設定組。 此屬性不能與非 Null 屬性一起存在。virtualMachineScaleSet 參考。 | SubResource |
billingProfile | 指定 Azure Spot 虛擬機的計費相關詳細數據。 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 擴展集,同時支援 'Deallocate' 和 'Delete',而最低 API 版本為 2017-10-30-preview。 | “Deallocate” "Delete" |
extensionsTimeBudget | 指定要啟動之所有延伸模組加上批注的時間。 持續時間應介於 15 分鐘到 120 分鐘之間, (包含) ,且應以 ISO 8601 格式指定。 預設值為90分鐘 (PT1H30M) 。 API 版本下限:2020-06-01。 | 字串 |
hardwareProfile | 指定虛擬機器的硬體設定。 | HardwareProfile |
主機 | 指定虛擬機所在專用主機的相關信息。 API 版本下限:2018-10-01。 | SubResource |
hostGroup | 指定虛擬機所在專用主機群組的相關信息。 注意: 用戶無法同時指定 host 和 hostGroup 屬性。 API 版本下限:2020-06-01。 | SubResource |
licenseType | 指定正在使用的映像或磁碟是在內部部署授權。 Windows Server 操作系統的可能值為: Windows_Client Windows_Server Linux Server 操作系統的可能值為: RHEL) 的 RHEL_BYOS ( SUSE) 的 SLES_BYOS ( 如需詳細資訊,請參閱 適用於 Windows Server 的 Azure Hybrid Use Benefit 適用於 Linux Server 的 Azure 混合式使用權益 API 版本下限:2015-06-15 |
字串 |
networkProfile | 指定虛擬機器的網路介面。 | NetworkProfile |
osProfile | 指定建立虛擬機時所使用的作業系統設定。 一旦布建 VM 之後,就無法變更部分設定。 | OSProfile |
platformFaultDomain | 指定要在其中建立虛擬機的擴展集邏輯容錯網域。 根據預設,虛擬機會自動指派給容錯網域,以在可用的容錯網域之間維持平衡。 只有在設定此虛擬機的 'virtualMachineScaleSet' 屬性時,才適用這個屬性。 參考的虛擬機擴展集必須具有大於 1 的 『platformFaultDomainCount』。 建立虛擬機之後,就無法更新這個屬性。 容錯網域指派可以在 [虛擬機實例檢視] 中檢視。 最小 api?version:2020?12?01。 | int |
priority | 指定虛擬機的優先順序。 API 版本下限:2019-03-01 | "Low" “Regular” “Spot” |
proximityPlacementGroup | 指定虛擬機應該指派的鄰近放置群組相關信息。 API 版本下限:2018-04-01。 | SubResource |
scheduledEventsProfile | 指定排程的事件相關組態。 | ScheduledEventsProfile |
securityProfile | 指定虛擬機的安全性相關配置檔設定。 | SecurityProfile |
storageProfile | 指定虛擬機器磁碟的儲存體設定。 | StorageProfile |
userData | VM 的 UserData,必須是base-64 編碼。 客戶不應在此傳遞任何秘密。 API 版本下限:2021-03-01。 | 字串 |
virtualMachineScaleSet | 指定虛擬機應指派給之虛擬機擴展集的相關信息。 相同虛擬機擴展集中指定的虛擬機會配置給不同的節點,以最大化可用性。 目前,VM 只能在建立時新增至虛擬機擴展集。 現有的 VM 無法新增至虛擬機擴展集。 這個屬性不能與非 Null properties.availabilitySet 參考一起存在。 最低 api?version:2019?03?01。 | SubResource |
AdditionalCapabilities
名稱 | 描述 | 值 |
---|---|---|
休眠Enabled | 啟用或停用 VM 上休眠功能的旗標。 | bool |
ultraSSDEnabled | 旗標,可啟用或停用在 VM 或 VMSS 上具有一或多個具有 UltraSSD_LRS記憶體帳戶類型的受控數據磁碟。 只有啟用此屬性時,才能將具有記憶體帳戶類型的受控磁碟UltraSSD_LRS新增至虛擬機或虛擬機擴展集。 | bool |
ApplicationProfile
名稱 | 描述 | 值 |
---|---|---|
galleryApplications | 指定應該提供給 VM/VMSS 的資源庫應用程式 | VMGalleryApplication[] |
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 資源標識符 | 字串 (必要) |
tags | 選擇性,指定更多泛型內容的傳遞值。 | 字串 |
treatFailureAsDeploymentFailure | 選擇性,如果為 true,VmApplication 中任何作業的任何失敗都會失敗部署 | bool |
SubResource
名稱 | 描述 | 值 |
---|---|---|
id | 資源標識碼 | 字串 |
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 – 表示預設價格為隨選。 您可以將 maxPrice 設定為 -1,以指出基於價格考慮,不應收回 Azure Spot VM/VMSS。 此外,如果默認價格不是由您提供,則為 -1。 API 版本下限:2019-03-01。 將十進位值指定為字串。 |
int 或 json decimal |
CapacityReservationProfile
名稱 | 描述 | 值 |
---|---|---|
capacityReservationGroup | 指定容量保留群組資源標識符,此標識元應該用於配置虛擬機或擴展集 VM 實例,前提是已保留足夠的容量。 如需詳細資訊, https://aka.ms/CapacityReservation 請參閱 。 |
SubResource |
DiagnosticsProfile
名稱 | 描述 | 值 |
---|---|---|
bootDiagnostics | 開機診斷是一項偵錯功能,可讓您檢視控制台輸出和螢幕快照來診斷 VM 狀態。 注意:如果指定 storageUri,請確定記憶體帳戶位於與 VM 相同的區域和訂用帳戶中。 您可以輕鬆地檢視主控台記錄的輸出。 Azure 也可讓您從 Hypervisor 查看 VM 的螢幕快照。 | BootDiagnostics |
BootDiagnostics
名稱 | 描述 | 值 |
---|---|---|
已啟用 | 虛擬機上是否應該啟用開機診斷。 | bool |
storageUri | 用來放置主控台輸出和螢幕快照的記憶體帳戶 URI。 如果在啟用開機診斷時未指定 storageUri,則會使用受控記憶體。 | 字串 |
HardwareProfile
名稱 | 描述 | 值 |
---|---|---|
vmSize | 指定虛擬機器的大小。 列舉數據類型目前已被取代,將於 2023 年 12 月 23 日移除。 取得可用大小清單的建議方式是使用這些 API: 列出可用性設定組中的所有可用虛擬機器大小、 列出區域中的所有可用虛擬機大小、 列出所有可用的虛擬機大小以進行重設大小。 如需虛擬機大小的詳細資訊,請參閱 虛擬機的大小。 可用的 VM 大小取決於區域和可用性設定組。 | “Basic_A0” “Basic_A1” “Basic_A2” “Basic_A3” “Basic_A4” “Standard_A0” “Standard_A1” “Standard_A10” “Standard_A11” “Standard_A1_v2” “Standard_A2” “Standard_A2_v2” “Standard_A2m_v2” “Standard_A3” “Standard_A4” “Standard_A4_v2” “Standard_A4m_v2” “Standard_A5” “Standard_A6” “Standard_A7” “Standard_A8” “Standard_A8_v2” “Standard_A8m_v2” “Standard_A9” “Standard_B1ms” “Standard_B1s” “Standard_B2ms” “Standard_B2s” “Standard_B4ms” “Standard_B8ms” “Standard_D1” “Standard_D11” “Standard_D11_v2” “Standard_D12” “Standard_D12_v2” “Standard_D13” “Standard_D13_v2” “Standard_D14” “Standard_D14_v2” “Standard_D15_v2” “Standard_D16_v3” “Standard_D16s_v3” “Standard_D1_v2” “Standard_D2” “Standard_D2_v2” “Standard_D2_v3” “Standard_D2s_v3” “Standard_D3” “Standard_D32_v3” “Standard_D32s_v3” “Standard_D3_v2” “Standard_D4” “Standard_D4_v2” “Standard_D4_v3” “Standard_D4s_v3” “Standard_D5_v2” “Standard_D64_v3” “Standard_D64s_v3” “Standard_D8_v3” “Standard_D8s_v3” “Standard_DS1” “Standard_DS11” “Standard_DS11_v2” “Standard_DS12” “Standard_DS12_v2” “Standard_DS13” “Standard_DS13-2_v2” “Standard_DS13-4_v2” “Standard_DS13_v2” “Standard_DS14” “Standard_DS14-4_v2” “Standard_DS14-8_v2” “Standard_DS14_v2” “Standard_DS15_v2” “Standard_DS1_v2” “Standard_DS2” “Standard_DS2_v2” “Standard_DS3” “Standard_DS3_v2” “Standard_DS4” “Standard_DS4_v2” “Standard_DS5_v2” “Standard_E16_v3” “Standard_E16s_v3” “Standard_E2_v3” “Standard_E2s_v3” “Standard_E32-16_v3” “Standard_E32-8s_v3” “Standard_E32_v3” “Standard_E32s_v3” “Standard_E4_v3” “Standard_E4s_v3” “Standard_E64-16s_v3” “Standard_E64-32s_v3” “Standard_E64_v3” “Standard_E64s_v3” “Standard_E8_v3” “Standard_E8s_v3” “Standard_F1” “Standard_F16” “Standard_F16s” “Standard_F16s_v2” “Standard_F1s” “Standard_F2” “Standard_F2s” “Standard_F2s_v2” “Standard_F32s_v2” “Standard_F4” “Standard_F4s” “Standard_F4s_v2” “Standard_F64s_v2” “Standard_F72s_v2” “Standard_F8” “Standard_F8s” “Standard_F8s_v2” “Standard_G1” “Standard_G2” “Standard_G3” “Standard_G4” “Standard_G5” “Standard_GS1” “Standard_GS2” “Standard_GS3” “Standard_GS4” “Standard_GS4-4” “Standard_GS4-8” “Standard_GS5” “Standard_GS5-16” “Standard_GS5-8” “Standard_H16” “Standard_H16m” “Standard_H16mr” “Standard_H16r” “Standard_H8” “Standard_H8m” “Standard_L16s” “Standard_L32s” “Standard_L4s” “Standard_L8s” “Standard_M128-32ms” “Standard_M128-64ms” “Standard_M128ms” “Standard_M128s” “Standard_M64-16ms” “Standard_M64-32ms” “Standard_M64ms” “Standard_M64s” “Standard_NC12” “Standard_NC12s_v2” “Standard_NC12s_v3” “Standard_NC24” “Standard_NC24r” “Standard_NC24rs_v2” “Standard_NC24rs_v3” “Standard_NC24s_v2” “Standard_NC24s_v3” “Standard_NC6” “Standard_NC6s_v2” “Standard_NC6s_v3” “Standard_ND12s” “Standard_ND24rs” “Standard_ND24s” “Standard_ND6s” “Standard_NV12” “Standard_NV24” “Standard_NV6” |
vmSizeProperties | 指定自定義虛擬機大小的屬性。 API 版本下限:2021-07-01。 此功能仍處於預覽模式,且 VirtualMachineScaleSet 不支援此功能。 如需詳細資訊,請遵循 VM 自定義 中的指示。 | VMSizeProperties |
VMSizeProperties
名稱 | 描述 | 值 |
---|---|---|
vCPUAvailable | 指定 VM 可用的 vCPU 數目。 當要求本文中未指定這個屬性時,預設行為是將它設定為該 VM 大小的可用 vCPU 值,而該 VM 大小會在 列出區域中所有可用的虛擬機大小時公開。 | int |
vCPUPerCore | 指定 vCPU 與實體核心比率。 當要求本文中未指定此屬性時,預設行為會針對在 列出區域中所有可用虛擬機大小的 API 回應中公開的 VM 大小設定為 vCPUPerCore 的值。 將此屬性設定為 1 也表示已停用超線程處理。 | int |
NetworkProfile
名稱 | 描述 | 值 |
---|---|---|
networkApiVersion | 會指定在網路介面組態中建立網路資源時所使用的 Microsoft.Network API 版本 | "2020-11-01" |
networkInterfaceConfigurations | 指定將用來建立虛擬機網路資源的網路設定。 | VirtualMachineNetworkInterfaceConfiguration[] |
networkInterfaces | 指定與虛擬機相關聯之網路介面的資源標識符清單。 | NetworkInterfaceReference[] |
VirtualMachineNetworkInterfaceConfiguration
名稱 | 描述 | 值 |
---|---|---|
NAME | 網路介面組態名稱。 | 需要字串 () |
properties | 描述虛擬機網路配置檔的IP組態。 | VirtualMachineNetworkInterfaceConfigurationPropertie... |
VirtualMachineNetworkInterfaceConfigurationPropertie...
名稱 | 描述 | 值 |
---|---|---|
auxiliaryMode | 指定是否啟用網路介面資源的輔助模式。 | “AcceleratedConnections” “浮動” "None" |
auxiliarySku | 指定是否為網路介面資源啟用輔助 SKU。 | “A1” “A2” “A4” “A8” "None" |
deleteOption | 指定刪除 VM 時網路介面會發生什麼情況 | "Delete" “Detach” |
disableTcpStateTracking | 指定是否停用網路介面以進行 tcp 狀態追蹤。 | bool |
dnsSettings | 要套用在網路介面上的 DNS 設定。 | VirtualMachineNetworkInterfaceDnsSettingsConfigurati... |
dscpConfiguration | SubResource | |
enableAcceleratedNetworking | 指定網路介面是否已啟用加速網路。 | bool |
enableFpga | 指定網路介面是否已啟用 FPGA 網路功能。 | bool |
enableIPForwarding | 是否在此 NIC 上啟用 IP 轉送。 | bool |
ipConfigurations | 指定網路介面的IP組態。 | VirtualMachineNetworkInterfaceIPConfiguration[] (必要) |
networkSecurityGroup | 網路安全組。 | SubResource |
primary | 指定虛擬機有1個以上的網路介面時的主要網路介面。 | bool |
VirtualMachineNetworkInterfaceDnsSettingsConfigurati...
名稱 | 描述 | 值 |
---|---|---|
dnsServers | DNS 伺服器 IP 位址清單 | string[] |
VirtualMachineNetworkInterfaceIPConfiguration
名稱 | 描述 | 值 |
---|---|---|
NAME | IP 組態名稱。 | 字串 (必要) |
properties | 描述虛擬機網路介面IP組態屬性。 | VirtualMachineNetworkInterfaceIPConfigurationPropert... |
VirtualMachineNetworkInterfaceIPConfigurationPropert...
名稱 | 描述 | 值 |
---|---|---|
applicationGatewayBackendAddressPools | 指定應用程式閘道後端位址池的參考數位。 虛擬機可以參考多個應用程式閘道的後端位址池。 多部虛擬機無法使用相同的應用程式閘道。 | SubResource[] |
applicationSecurityGroups | 指定應用程式安全組的參考陣列。 | SubResource[] |
loadBalancerBackendAddressPools | 指定負載平衡器後端位址池參考的陣列。 虛擬機可以參考一個公用和一個內部負載平衡器的後端位址池。 [多部虛擬機無法使用相同的基本 SKU 負載平衡器]。 | SubResource[] |
primary | 指定虛擬機有1個以上的網路介面時的主要網路介面。 | bool |
privateIPAddressVersion | 從 Api-Version 2017-03-30 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 | “IPv4” “IPv6” |
publicIPAddressConfiguration | publicIPAddressConfiguration。 | VirtualMachinePublicIPAddressConfiguration |
子網路 | 指定子網的識別碼。 | SubResource |
VirtualMachinePublicIPAddressConfiguration
名稱 | 描述 | 值 |
---|---|---|
NAME | publicIP 位址組態名稱。 | 字串 (必要) |
properties | 描述虛擬機IP組態的PublicIPAddress設定 | VirtualMachinePublicIPAddressConfigurationProperties |
sku | 描述公用IP Sku。 它只能使用 OrchestrationMode 設定為彈性。 | PublicIPAddressSku |
VirtualMachinePublicIPAddressConfigurationProperties
名稱 | 描述 | 值 |
---|---|---|
deleteOption | 指定刪除 VM 時,公用 IP 位址會發生什麼情況 | "Delete" “Detach” |
dnsSettings | 要套用至 publicIP 位址的 DNS 設定。 | VirtualMachinePublicIPAddressDnsSettingsConfiguratio... |
idleTimeoutInMinutes | 公用IP位址的閒置逾時。 | int |
ipTags | 與公用IP位址相關聯的IP標籤清單。 | VirtualMachineIpTag[] |
publicIPAddressVersion | 從 Api-Version 2019-07-01 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 | “IPv4” “IPv6” |
publicIPAllocationMethod | 指定公用IP配置類型 | “Dynamic” “Static” |
publicIPPrefix | 要從中配置 publicIP 位址的 PublicIPPrefix。 | SubResource |
VirtualMachinePublicIPAddressDnsSettingsConfiguratio...
名稱 | 描述 | 值 |
---|---|---|
domainNameLabel | 將建立之 PublicIPAddress 資源的功能變數名稱標籤前置詞。 產生的名稱標籤是功能變數名稱標籤和 vm 網路設定檔唯一識別碼的串連。 | 字串 (必要) |
domainNameLabelScope | 將建立之 PublicIPAddress 資源的功能變數名稱標籤範圍。 產生的名稱標籤是根據功能變數名稱標籤範圍和 vm 網路配置檔唯一識別碼,以原則串連哈希功能變數名稱標籤。 | “NoReuse” “ResourceGroupReuse” “SubscriptionReuse” “TenantReuse” |
VirtualMachineIpTag
名稱 | 描述 | 值 |
---|---|---|
ipTagType | IP 標籤類型。 範例:FirstPartyUsage。 | 字串 |
標籤 | 與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 | 字串 |
PublicIPAddressSku
名稱 | 描述 | 值 |
---|---|---|
NAME | 指定公用IP SKU 名稱 | "Basic" “Standard” |
tier | 指定公用IP SKU層 | “Global” “區域” |
NetworkInterfaceReference
名稱 | 描述 | 值 |
---|---|---|
id | 資源標識碼 | 字串 |
properties | 描述網路介面參考屬性。 | NetworkInterfaceReferenceProperties |
NetworkInterfaceReferenceProperties
名稱 | 描述 | 值 |
---|---|---|
deleteOption | 指定刪除 VM 時網路介面會發生什麼事 | "Delete" “Detach” |
primary | 指定虛擬機有1個以上的網路介面時的主要網路介面。 | bool |
OSProfile
名稱 | 描述 | 值 |
---|---|---|
adminPassword | 指定系統管理員帳戶的密碼。 Windows) 長度下限 (: 8 個字元 Linux) 長度下限 (: 6 個字元 Windows) 長度上限 (: 123 個字元 Linux) 長度上限 (: 72 個字元 複雜度需求: 需要滿足下列 4 個條件中的 3 個 字元較低 具有大字元 具有數位 具有特殊字元 (Regex 比對 [\W_]) 不允許的值: “abc@123”、“P@$$w 0rd”、“P@ssw0rd”、“P@ssword123”、“Pa$$word”、“pass@word1”、“Password!”、“Password1”、“Password22”、“iveyou!” 如需重設密碼,請參閱 如何在 Windows VM 中重設遠端桌面服務或其登入密碼 如需重設根密碼,請參閱 使用 VMAccess 擴充功能管理使用者、SSH 及檢查或修復 Azure Linux VM 上的磁碟 |
字串 約束: 敏感性值。 以安全參數的形式傳入。 |
adminUsername | 指定系統管理員帳戶的名稱。 建立 VM 之後,就無法更新此屬性。 僅限 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 |
computerName | 指定虛擬機的主機OS名稱。 建立 VM 之後,就無法更新此名稱。 Windows) 長度上限 (: 15 個字元。 Linux) 長度上限 (: 64 個字元。 如需命名慣例和限制,請參閱 Azure 基礎結構服務實作指導方針。 | 字串 |
customData | 指定自訂資料的 Base-64 編碼字串。 Base-64 編碼字串會解碼成二進位陣列而儲存為虛擬機器上的檔案。 二進位陣列的長度上限是 65535 個位元組。 注意:請勿在 customData 屬性中傳遞任何秘密或密碼。 建立 VM 之後,就無法更新此屬性。 屬性 'customData' 會傳遞至要儲存為檔案的 VM,如需詳細資訊,請參閱 Azure VM 上的自定義數據。 如需針對Linux VM 使用cloud-init,請參閱在建立期間使用cloud-init 自定義Linux VM。 | 字串 |
linuxConfiguration | 指定虛擬機上的Linux作業系統設定。 如需支援的Linux發行版清單,請參閱 Azure-Endorsed 發行版上的Linux。 | LinuxConfiguration |
requireGuestProvisionSignal | 必須設定為 True 或省略的選擇性屬性。 | bool |
密碼 | 指定應該安裝到虛擬機器的憑證集。 若要在虛擬機上安裝憑證,建議使用適用於Linux的 Azure 金鑰保存庫 虛擬機擴充功能或適用於Windows的 Azure 金鑰保存庫 虛擬機擴充功能。 | VaultSecretGroup[] |
windowsConfiguration | 指定虛擬機器上的 Windows 作業系統設定。 | WindowsConfiguration |
LinuxConfiguration
名稱 | 描述 | 值 |
---|---|---|
disablePasswordAuthentication | 指定是否應該停用密碼驗證。 | bool |
enableVMAgentPlatformUpdates | 指出是否已針對Linux虛擬機啟用VMAgent Platform 匯報。 預設值為 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 客體修補中指定 Patch 模式 AutomaticByPlatform 的其他設定。 | LinuxVMGuestPatchAutomaticByPlatformSettings |
patchMode | 指定 VM 客體修補至 IaaS 虛擬機的模式,或與 OrchestraMode 為彈性的虛擬機擴展集相關聯的虛擬機。 可能的值包括: ImageDefault - 會使用虛擬機的默認修補組態。 AutomaticByPlatform - 虛擬機將會由平台自動更新。 provisionVMAgent 屬性必須是 true |
“AutomaticByPlatform” “ImageDefault” |
LinuxVMGuestPatchAutomaticByPlatformSettings
名稱 | 描述 | 值 |
---|---|---|
bypassPlatformSafetyChecksOnUserSchedule | 讓客戶排程修補而不意外升級 | bool |
rebootSetting | 指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。 | “Always” “IfRequired” “Never” “Unknown” |
SshConfiguration
名稱 | 描述 | 值 |
---|---|---|
publicKeys | 用來向Linux型VM進行驗證的SSH公鑰清單。 | SshPublicKey[] |
SshPublicKey
名稱 | 描述 | 值 |
---|---|---|
keyData | 用來透過 ssh 向 VM 進行驗證的 SSH 公鑰憑證。 密鑰至少必須是 2048 位,且格式為 ssh-rsa。 如需建立 ssh 金鑰,請參閱 [在 Azure 中建立 Linux 和 Mac 上的 Linux VM SSH 密鑰]/azure/virtual-machines/linux/create-ssh-keys-detailed) 。 | 字串 |
path | 指定儲存 ssh 公鑰的已建立 VM 上的完整路徑。 如果檔案已經存在,指定的金鑰就會附加至該檔案。 範例:/home/user/.ssh/authorized_keys | 字串 |
VaultSecretGroup
名稱 | 描述 | 值 |
---|---|---|
sourceVault | 包含 VaultCertificates 中所有憑證之 金鑰保存庫 的相對 URL。 | SubResource |
vaultCertificates | SourceVault 中包含憑證的金鑰保存庫參考清單。 | VaultCertificate[] |
VaultCertificate
名稱 | 描述 | 值 |
---|---|---|
certificateStore | 針對 Windows VM,指定應在其中新增憑證之虛擬機上的證書存儲。 指定的證書存儲會隱含地在 LocalMachine 帳戶中。 針對Linux VM,憑證檔案會放在 /var/lib/waagent 目錄底下,而 X509 憑證檔案的檔名 <為 UppercaseThumbprint.crt>, <而私鑰則為 UppercaseThumbprint.prv>。 這兩個檔案都是 .pem 格式。 | 字串 |
certificateUrl | 這是已上傳至 金鑰保存庫 為秘密之憑證的 URL。 如需將秘密新增至 金鑰保存庫,請參閱將密鑰或秘密新增至密鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼方式,此物件是以 UTF-8 編碼: { “data”:“{Base64-encoded-certificate}”, “dataType”:“pfx”, “password”:“{pfx-file-password}” } 若要在虛擬機上安裝憑證,建議使用適用於Linux的 Azure 金鑰保存庫 虛擬機擴充功能或適用於Windows的 Azure 金鑰保存庫 虛擬機擴充功能。 |
字串 |
WindowsConfiguration
名稱 | 描述 | 值 |
---|---|---|
additionalUnattendContent | 指定可併入 Unattend.xml 檔案 (由 Windows 安裝程式使用) 的額外 Base-64 編碼 XML 格式資訊。 | AdditionalUnattendContent[] |
enableAutomaticUpdates | 指出是否為 Windows 虛擬機啟用自動 匯報。 預設值為 true。 對於虛擬機擴展集,此屬性可以更新,更新將會在OS重新佈建上生效。 | bool |
enableVMAgentPlatformUpdates | 指出是否已為 Windows 虛擬機啟用 VMAgent Platform 匯報。 預設值為 False。 | bool |
patchSettings | [預覽功能]指定與 Windows 上的 VM 客體修補相關的設定。 | PatchSettings |
provisionVMAgent | 指出是否應該在虛擬機器上佈建虛擬機器代理程式。 當要求本文中未指定這個屬性時,預設會將其設定為 true。 這可確保 VM 代理程式已安裝在 VM 上,以便稍後將擴充功能新增至 VM。 | bool |
timeZone | 指定虛擬機的時區。 例如“Pacific Standard Time”。 可能的值可以從 TimeZoneInfo.GetSystemTimeZones 傳回的時區 TimeZoneInfo.Id 值。 | 字串 |
winRM | 指定 Windows 遠端管理接聽程式。 藉此將啟用遠端 Windows PowerShell。 | WinRMConfiguration |
AdditionalUnattendContent
名稱 | 描述 | 值 |
---|---|---|
componentName | 元件名稱。 目前唯一允許的值是 Microsoft-Windows-Shell-Setup。 | “Microsoft-Windows-Shell-Setup” |
內容 | 針對指定的路徑和元件,指定新增至 unattend.xml 檔案的 XML 格式化內容。 XML 必須小於 4KB,而且必須包含要插入之設定或功能的根元素。 | 字串 |
passName | 傳遞名稱。 目前唯一允許的值是 OobeSystem。 | “OobeSystem” |
settingName | 指定要套用內容之設定的名稱。 可能的值為:FirstLogonCommands 和 AutoLogon。 | “AutoLogon” “FirstLogonCommands” |
PatchSettings
名稱 | 描述 | 值 |
---|---|---|
assessmentMode | 指定 IaaS 虛擬機的 VM 客體修補評估模式。 可能的值包括: ImageDefault - 您可以在虛擬機上控制修補程式評估的時間。 AutomaticByPlatform - 平臺會觸發定期修補程序評估。 屬性 provisionVMAgent 必須為 true。 |
“AutomaticByPlatform” “ImageDefault” |
automaticByPlatformSettings | 指定 Windows 上 VM 客體修補中之修補程式模式 AutomaticByPlatform 的其他設定。 | WindowsVMGuestPatchAutomaticByPlatformSettings |
enableHotpatching | 可讓客戶修補其 Azure VM,而不需要重新啟動。 針對 enableHotpatching,'provisionVMAgent' 必須設定為 true,且 'patchMode' 必須設定為 'AutomaticByPlatform'。 | bool |
patchMode | 指定 VM 客體修補至 IaaS 虛擬機的模式,或與具有 OrchestrationMode 的虛擬機擴展集相關聯的虛擬機作為彈性。 可能的值包括: 手動 - 您可以控制將修補程式應用程式套用至虛擬機。 您可以在 VM 內手動套用修補程式來執行此動作。 在此模式中,會停用自動更新;屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 false AutomaticByOS - 作業系統會自動更新虛擬機。 屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 true。 AutomaticByPlatform - 虛擬機將會由平台自動更新。 provisionVMAgent 和 WindowsConfiguration.enableAutomaticUpdates 屬性必須為 true |
“AutomaticByOS” “AutomaticByPlatform” “手動” |
WindowsVMGuestPatchAutomaticByPlatformSettings
名稱 | 描述 | 值 |
---|---|---|
bypassPlatformSafetyChecksOnUserSchedule | 可讓客戶排程修補,而不需意外升級 | bool |
rebootSetting | 指定所有 AutomaticByPlatform 修補程式安裝作業的重新啟動設定。 | “Always” “IfRequired” “永不” “未知” |
WinRMConfiguration
名稱 | 描述 | 值 |
---|---|---|
接聽程式 | Windows 遠端管理接聽程式清單 | WinRMListener[] |
WinRMListener
名稱 | 描述 | 值 |
---|---|---|
certificateUrl | 這是已上傳至 金鑰保存庫 做為秘密的憑證 URL。 如需將秘密新增至 金鑰保存庫,請參閱將密鑰或秘密新增至密鑰保存庫。 在此情況下,您的憑證必須是以UTF-8編碼的下列 JSON 物件的Base64編碼: { “data”:“{Base64-encoded-certificate}”, “dataType”:“pfx”, “password”:“{pfx-file-password}” } 若要在虛擬機上安裝憑證,建議使用適用於Linux的 Azure 金鑰保存庫 虛擬機擴充功能或適用於Windows的 Azure 金鑰保存庫 虛擬機擴充功能。 |
字串 |
protocol | 指定 WinRM 接聽程式的通訊協定。 可能的值為: HTTP、https。 | “Http” “Https” |
ScheduledEventsProfile
名稱 | 描述 | 值 |
---|---|---|
osImageNotificationProfile | 指定OS映像排程事件相關組態。 | OSImageNotificationProfile |
terminateNotificationProfile | 指定終止排程事件相關組態。 | TerminateNotificationProfile |
OSImageNotificationProfile
名稱 | 描述 | 值 |
---|---|---|
enable | 指定是否啟用或停用OS映像排程事件。 | bool |
notBeforeTimeout | 虛擬機重新映像或其操作系統升級的時間長度,在事件自動核准之前,必須先核准 OS 映射排程事件, (逾時) 。 設定是以 ISO 8601 格式指定,而且此值必須是 15 分鐘, (PT15M) | 字串 |
TerminateNotificationProfile
名稱 | 描述 | 值 |
---|---|---|
enable | 指定是否啟用或停用 Terminate Scheduled 事件。 | bool |
notBeforeTimeout | 刪除虛擬機的可設定時間長度,在自動核准事件之前,虛擬機必須核准終止排程事件, (逾時) 。 設定必須以 ISO 8601 格式指定,預設值為 5 分鐘, (PT5M) | 字串 |
SecurityProfile
名稱 | 描述 | 值 |
---|---|---|
encryptionAtHost | 用戶可以在要求中使用此屬性,以啟用或停用虛擬機或虛擬機擴展集的主機加密。 這會啟用所有磁碟的加密,包括主機本身的資源/暫存磁碟。 默認行為為:除非資源將此屬性設定為 true,否則將會停用主機加密。 | bool |
encryptionIdentity | 指定 ADE 用來取得金鑰保存庫作業存取令牌的受控識別。 | EncryptionIdentity |
proxyAgentSettings | 指定建立虛擬機時的 ProxyAgent 設定。 API 版本下限:2023-09-01。 | ProxyAgentSettings |
securityType | 指定虛擬機的 SecurityType。 它必須設定為任何指定的值,才能啟用 UefiSettings。 默認行為為:除非設定此屬性,否則不會啟用 UefiSettings。 | “ConfidentialVM” “TrustedLaunch” |
uefiSettings | 指定安全性設定,例如建立虛擬機時所使用的安全開機和 vTPM。 API 版本下限:2020-12-01。 | UefiSettings |
EncryptionIdentity
名稱 | 描述 | 值 |
---|---|---|
userAssignedIdentityResourceId | 指定與 VM 相關聯的其中一個使用者身分識別的 ARM 資源識別碼。 | 字串 |
ProxyAgentSettings
名稱 | 描述 | 值 |
---|---|---|
已啟用 | 指定是否應在虛擬機或虛擬機擴展集上啟用 ProxyAgent 功能。 | bool |
keyIncarnationId | 增加此屬性的值可讓使用者重設用來保護客體與主機之間通道的密鑰。 | int |
mode | 指定啟用此功能時,ProxyAgent 將會在 上執行的模式。 ProxyAgent 會開始稽核或監視,但不會在稽核模式中對主機端點的要求強制執行訪問控制,而在 [強制執行] 模式中,則會強制執行訪問控制。 默認值為 [強制模式]。 | “稽核” “強制” |
UefiSettings
名稱 | 描述 | 值 |
---|---|---|
secureBootEnabled | 指定是否應在虛擬機上啟用安全開機。 API 版本下限:2020-12-01。 | bool |
vTpmEnabled | 指定是否應在虛擬機上啟用 vTPM。 API 版本下限:2020-12-01。 | bool |
StorageProfile
名稱 | 描述 | 值 |
---|---|---|
dataDisks | 指定用來將資料磁碟加入至虛擬機器的參數。 如需磁碟的詳細資訊,請參閱 關於 Azure 虛擬機的磁碟和 VHD。 | DataDisk[] |
diskControllerType | 指定為 VM 設定的磁碟控制器類型。 注意: 如果未指定,則會使用 『hyperVGeneration』 設定為 V2,根據指定之最低 API 版本之作業系統磁碟和 VM 大小的功能,將此屬性設定為預設磁碟控制器類型。 除非您更新 VM 組態中的 VM 大小,以隱含地解除分配和重新配置 VM,否則您必須在更新其磁碟控制器類型之前解除分配 VM。 API 版本下限:2022-08-01。 | “NVMe” “SCSI” |
imageReference | 指定要使用之映像的相關信息。 您可以指定平臺映像、Marketplace 映像或虛擬機映射的相關信息。 當您想要使用平臺映像、市集映像或虛擬機映像,但不會用於其他建立作業時,需要此元素。 | ImageReference |
osDisk | 指定虛擬機所使用的作業系統磁碟相關信息。 如需磁碟的詳細資訊,請參閱 關於 Azure 虛擬機的磁碟和 VHD。 | OSDisk |
DataDisk
名稱 | 描述 | 值 |
---|---|---|
快取 | 指定快取需求。 可能的值為: None、ReadOnly、ReadWrite。 默認行為為: 標準記憶體的 None。進階記憶體的 ReadOnly。 | "None" “ReadOnly” “ReadWrite” |
createOption | 指定應如何建立虛擬機。 可能的值為: Attach。 當您使用特製化磁碟來建立虛擬機時,會使用此值。 FromImage。 當您使用映像來建立虛擬機時,會使用此值。 如果您使用平臺映像,則也應該使用上述的 imageReference 元素。 如果您使用 Marketplace 映射,則也應該使用先前所述的方案元素。 | “附加” "Empty" “FromImage” (必要) |
deleteOption | 指定刪除 VM 時,是否應該刪除或卸離數據磁碟。 可能的值為: Delete。 如果使用此值,則會在刪除 VM 時刪除資料磁碟。 分離。 如果使用此值,則會在刪除 VM 之後保留資料磁碟。 默認值設定為 [卸離]。 | "Delete" “Detach” |
detachOption | 指定要在中斷連結磁碟時使用的卸離行為,或已在從虛擬機中斷鏈接的過程中使用。 支援的值: ForceDetach。 detachOption: ForceDetach 僅適用於受控數據磁碟。 如果先前的數據磁碟斷連結嘗試因為虛擬機發生意外失敗而未完成,但磁碟仍然未釋放,請使用強制卸離作為最後一個從 VM 強制卸離磁碟的選項。 使用這個卸離行為時,所有寫入可能都尚未排清。 此功能仍在預覽模式中 ,且 VirtualMachineScaleSet 不支援此功能。 強制將數據磁碟更新強制中斷連結至 『true』,以及設定 detachOption:『ForceDetach』。 | “ForceDetach” |
diskSizeGB | 指定以 GB 為單位的空白資料磁碟大小。 此元素可用來覆寫虛擬機映像中的磁碟大小。 屬性 'diskSizeGB' 是磁碟的位元組 x 1024^3 數目,值不能大於 1023。 | int |
image | 來源使用者映像虛擬硬碟。 在連接至虛擬機之前,將會先複製虛擬硬碟。 如果提供SourceImage,目的地虛擬硬碟不得存在。 | VirtualHardDisk |
lun | 指定數據磁碟的邏輯單位編號。 此值是用來識別 VM 內的數據磁碟,因此對於連結至 VM 的每個數據磁碟而言,都必須是唯一的。 | int (必要) |
ManagedDisk | 受控磁碟參數。 | ManagedDiskParameters |
NAME | 磁碟名稱。 | 字串 |
toBeDetached | 指定數據磁碟是否正在從 VirtualMachine/VirtualMachineScaleset 中斷連結 | bool |
vhd | 虛擬硬碟。 | VirtualHardDisk |
writeAcceleratorEnabled | 指定是否應該在磁碟上啟用或停用 writeAccelerator。 | bool |
VirtualHardDisk
名稱 | 描述 | 值 |
---|---|---|
uri | 指定虛擬硬碟的 URI。 | 字串 |
ManagedDiskParameters
名稱 | 描述 | 值 |
---|---|---|
diskEncryptionSet | 指定受控磁碟的客戶受控磁碟加密集資源標識符。 | DiskEncryptionSetParameters |
id | 資源標識碼 | 字串 |
securityProfile | 指定受控磁碟的安全性配置檔。 | VMDiskSecurityProfile |
storageAccountType | 指定受控磁碟的記憶體帳戶類型。 注意:UltraSSD_LRS只能與數據磁碟搭配使用,它不能與OS磁碟搭配使用。 | “PremiumV2_LRS” "Premium_LRS" “Premium_ZRS” "StandardSSD_LRS" “StandardSSD_ZRS” "Standard_LRS" “UltraSSD_LRS” |
DiskEncryptionSetParameters
名稱 | 描述 | 值 |
---|---|---|
id | 資源標識碼 | 字串 |
VMDiskSecurityProfile
名稱 | 描述 | 值 |
---|---|---|
diskEncryptionSet | 針對客戶受控密鑰加密的機密VM OS 磁碟和 VMGuest Blob,指定受控磁碟的客戶受控磁碟加密集資源識別碼。 | DiskEncryptionSetParameters |
securityEncryptionType | 指定受控磁碟的 EncryptionType。 它設定為 DiskWithVMGuestState 以加密受控磁碟以及 VMGuestState Blob、VMGuestStateOnly 只加密 VMGuestState Blob,以及 NonPersistedTPM 用於不保存 VMGuestState Blob 中的韌體狀態。 注意: 它只能設定為機密 VM。 | “DiskWithVMGuestState” “NonPersistedTPM” “VMGuestStateOnly” |
ImageReference
名稱 | 描述 | 值 |
---|---|---|
communityGalleryImageId | 指定 vm 部署的社群資源庫映像唯一標識碼。 這可以從社群資源庫映像 GET 呼叫擷取。 | 字串 |
id | 資源標識碼 | 字串 |
供應項目 | 指定用來建立虛擬機的平臺映像或 Marketplace 映像供應專案。 | 字串 |
publisher | 映像發行者。 | 字串 |
sharedGalleryImageId | 指定 VM 部署的共享資源庫映像唯一識別碼。 這可以從共用資源庫映像 GET 呼叫擷取。 | 字串 |
sku | 映像 SKU。 | 字串 |
version | 指定用來建立虛擬機的平臺映像或 Marketplace 映像版本。 允許的格式為 Major.Minor.Build 或 'latest'。 主要、次要和組建是十進位數。 指定「最新」以使用部署階段可用的最新映像版本。 即使您使用「最新」,即使有新版本可供使用,VM 映像也不會在部署時間之後自動更新。 請勿針對資源庫映射部署使用字段 'version',資源庫映射應該一律使用 'id' 字段進行部署,若要使用資源庫映射的 'latest' 版本,只要設定 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}' 字段,就不需要輸入版本。 | 字串 |
OSDisk
名稱 | 描述 | 值 |
---|---|---|
快取 | 指定快取需求。 可能的值為: None、ReadOnly、ReadWrite。 默認行為為: 標準記憶體無。進階記憶體的 ReadOnly。 | "None" “ReadOnly” “ReadWrite” |
createOption | 指定虛擬機的建立方式。 可能的值為: 附加。 當您使用特製化磁碟來建立虛擬機時,會使用此值。 FromImage。 當您使用映像來建立虛擬機時,會使用此值。 如果您使用平臺映像,則也應該使用上述的 imageReference 元素。 如果您使用市集映像,您也應該使用先前所述的方案元素。 | “Attach” "Empty" “FromImage” (必要) |
deleteOption | 指定在 VM 刪除時,是否應該刪除或中斷連結 OS 磁碟。 可能的值為: Delete。 如果使用此值,則會在刪除 VM 時刪除 OS 磁碟。 分離。 如果使用此值,則會在刪除 VM 之後保留 os 磁碟。 默認值設定為 [卸離]。 對於暫時 OS 磁碟,預設值會設定為 [刪除]。 使用者無法變更暫時 OS 磁碟的刪除選項。 | "Delete" “Detach” |
diffDiskSettings | 指定虛擬機所使用作業系統磁碟的暫時磁碟設定。 | DiffDiskSettings |
diskSizeGB | 指定以 GB 為單位的空白資料磁碟大小。 此元素可用來覆寫虛擬機映像中的磁碟大小。 屬性 'diskSizeGB' 是磁碟的位元組 x 1024^3 數目,值不能大於 1023。 | int |
encryptionSettings | 指定 OS 磁碟的加密設定。 API 版本下限:2015-06-15。 | DiskEncryptionSettings |
image | 來源使用者映像虛擬硬碟。 在連接至虛擬機之前,將會先複製虛擬硬碟。 如果提供SourceImage,目的地虛擬硬碟不得存在。 | VirtualHardDisk |
ManagedDisk | 受控磁碟參數。 | ManagedDiskParameters |
NAME | 磁碟名稱。 | 字串 |
osType | 此屬性可讓您指定從使用者映像或特製化 VHD 建立 VM 時,磁碟包含的 OS 類型。 可能的值為: Windows、Linux。 | "Linux" "Windows" |
vhd | 虛擬硬碟。 | VirtualHardDisk |
writeAcceleratorEnabled | 指定是否應該在磁碟上啟用或停用 writeAccelerator。 | bool |
DiffDiskSettings
名稱 | 描述 | 值 |
---|---|---|
選項 | 指定作業系統磁碟的暫時磁碟設定。 | “Local” |
放置 | 指定作業系統磁碟的暫時磁碟位置。 可能的值為: CacheDisk、ResourceDisk。 默認行為為:如果已針對 VM 大小設定 快取Disk ,否則會使用 ResourceDisk 。 請參閱 /azure/virtual-machines/windows/size 和 Linux VM 位於 /azure/virtual-machines/linux/size 的 Windows VM 大小檔,以檢查哪些 VM 大小會公開快取磁碟。 | “CacheDisk” “ResourceDisk” |
DiskEncryptionSettings
名稱 | 描述 | 值 |
---|---|---|
diskEncryptionKey | 指定磁碟加密金鑰的位置,這是 金鑰保存庫 秘密。 | KeyVaultSecretReference |
已啟用 | 指定是否應在虛擬機上啟用磁碟加密。 | bool |
keyEncryptionKey | 指定 金鑰保存庫 中金鑰加密金鑰的位置。 | KeyVaultKeyReference |
KeyVaultSecretReference
名稱 | 描述 | 值 |
---|---|---|
secretUrl | 參考 金鑰保存庫 中秘密的URL。 | 需要字串 () |
sourceVault | 包含秘密之 金鑰保存庫的相對 URL。 | 必要子資源 () |
KeyVaultKeyReference
名稱 | 描述 | 值 |
---|---|---|
keyUrl | 在 金鑰保存庫 中參考金鑰加密金鑰的 URL。 | 需要字串 () |
sourceVault | 包含金鑰之 金鑰保存庫 的相對 URL。 | 必要子資源 () |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應