az vmss

參考

管理 Azure 虛擬機擴展集（VMSS）中的虛擬機群組。

命令

名稱	Description	類型	狀態
az vmss application	管理 VM 擴充集的應用程式。	核心	GA
az vmss application list	列出 VMSS 的應用程式。	核心	GA
az vmss application set	設定 VMSS 的應用程式。	核心	GA
az vmss create	建立 Azure 虛擬機擴展集。	核心	GA
az vmss deallocate	解除分配 VMSS 內的 VM。	核心	GA
az vmss delete	刪除 VM 擴展集。	核心	GA
az vmss delete-instances	刪除 VMSS 內的 VM。	核心	GA
az vmss diagnostics	設定 Azure 虛擬機擴展集診斷擴充功能。	核心	GA
az vmss diagnostics get-default-config	顯示定義要收集的數據的預設組態檔。	核心	GA
az vmss diagnostics set	在 VMSS 上啟用診斷。	核心	GA
az vmss disk	管理 VMSS 的數據磁碟。	核心	GA
az vmss disk attach	將受控數據磁碟連結至擴展集或其實例。	核心	GA
az vmss disk detach	從擴展集或其實例中斷鏈接受控數據磁碟。	核心	GA
az vmss encryption	管理 VMSS 的加密。	核心	GA
az vmss encryption disable	使用受控磁碟停用 VMSS 上的加密。	核心	GA
az vmss encryption enable	使用受控磁碟加密 VMSS。	核心	GA
az vmss encryption show	顯示加密狀態。	核心	GA
az vmss extension	管理 VM 擴展集上的擴充功能。	核心	GA
az vmss extension delete	從 VMSS 刪除擴充功能。	核心	GA
az vmss extension image	尋找訂用帳戶和區域的可用 VM 擴充功能。	核心	GA
az vmss extension image list	列出可用擴充功能的相關信息。	核心	GA
az vmss extension image list-names	列出虛擬機擴充功能映像類型。	核心	GA
az vmss extension image list-versions	列出虛擬機擴充功能映像版本。	核心	GA
az vmss extension image show	取得虛擬機擴充功能映像。	核心	GA
az vmss extension list	列出與 VMSS 相關聯的擴充功能。	核心	GA
az vmss extension set	將擴充功能新增至 VMSS 或更新現有的擴充功能。	核心	GA
az vmss extension show	顯示 VMSS 擴充功能的詳細數據。	核心	GA
az vmss extension upgrade	將所有 VMSS 實例的所有擴充功能升級至最新版本。	核心	GA
az vmss get-instance-view	檢視 VMSS 的實例。	核心	GA
az vmss get-os-upgrade-history	列出 VM 擴展集實例上的 OS 升級。	核心	GA
az vmss identity	管理服務擴展集的服務身分識別。	核心	GA
az vmss identity assign	在VMSS上啟用受控服務識別。	核心	GA
az vmss identity remove	從 VM 擴展集移除使用者指派的身分識別。	核心	預覽
az vmss identity show	顯示 VM 擴展集的受控識別資訊。	核心	GA
az vmss list	列出資源群組下的所有 VM 擴展集。	核心	GA
az vmss list-instance-connection-info	取得用來連線到集合內個別 VM 實例的 IP 位址和埠號碼。	核心	GA
az vmss list-instance-public-ips	列出集合內 VM 實例的公用 IP 位址。	核心	GA
az vmss list-instances	列出 VM 擴展集中的所有虛擬機。	核心	GA
az vmss list-skus	列出 VM 擴充集可用的 SKU，包括每個 SKU 允許的最小和最大 VM 實例。	核心	GA
az vmss nic	管理 VMSS 的網路介面。	核心	GA
az vmss nic list	取得虛擬機擴展集中的所有網路介面。	核心	GA
az vmss nic list-vm-nics	取得虛擬機擴展集中虛擬機中所有網路介面的相關信息。	核心	GA
az vmss nic show	取得虛擬機擴展集中的指定網路介面。	核心	GA
az vmss perform-maintenance	在 VM 擴展集中的一或多個虛擬機上執行維護。不符合執行維護資格的實例上的作業將會失敗。如需詳細資訊，請參閱最佳做法： https://docs.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-maintenance-notifications。	核心	GA
az vmss reimage	在 VMSS 內重新設定 VM 的映像。	核心	GA
az vmss restart	重新啟動 VMSS 內的 VM。	核心	GA
az vmss rolling-upgrade	管理滾動升級。	核心	GA
az vmss rolling-upgrade cancel	取消目前的虛擬機擴展集滾動升級。	核心	GA
az vmss rolling-upgrade get-latest	取得最新虛擬機擴展集滾動升級的狀態。	核心	GA
az vmss rolling-upgrade start	啟動滾動升級，將所有虛擬機擴展集實例移至最新的可用平臺映射OS版本。已經執行最新可用 OS 版本的實例不會受到影響。	核心	GA
az vmss run-command	管理虛擬機擴展集上的執行命令。	核心	GA
az vmss run-command create	建立 VMSS VM 執行命令的作業。	核心	GA
az vmss run-command delete	要刪除執行命令的作業。	核心	GA
az vmss run-command invoke	在虛擬機擴展集實例上執行特定的執行命令。	核心	GA
az vmss run-command list	在虛擬機擴展集中取得實例所有執行命令的作業。	核心	GA
az vmss run-command show	取得 VMSS 執行命令的作業。	核心	GA
az vmss run-command update	更新 VMSS 執行命令的作業。	核心	GA
az vmss scale	變更 VMSS 內的 VM 數目。	核心	GA
az vmss set-orchestration-service-state	變更 VMSS 內指定服務的 ServiceState 屬性。	核心	GA
az vmss show	取得 VMSS 內 VM 的詳細數據。	核心	GA
az vmss simulate-eviction	模擬 VM 擴展集中 Spot 虛擬機的收回。	核心	GA
az vmss start	啟動 VMSS 內的 VM。	核心	GA
az vmss stop	關閉（停止） VMSS 內的 VM。	核心	GA
az vmss update	更新 VMSS。如果您尚未設定升級原則，請執行 'az vmss update-instances' 命令來推出 VM 的變更。	核心	GA
az vmss update-domain-walk	手動平臺更新網域逐步解說，以更新 Service Fabric 虛擬機擴展集中的虛擬機。	核心	GA
az vmss update-instances	升級 VMSS 內的 VM。	核心	GA
az vmss wait	將 CLI 置於等候狀態，直到符合擴展集的條件為止。	核心	GA

az vmss create

編輯

建立 Azure 虛擬機擴展集。

如需端對端教學課程，請參閱 https://docs.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-linux-create-cli。

az vmss create --name
               --resource-group
               [--accelerated-networking {false, true}]
               [--accept-term]
               [--additional-events {false, true}]
               [--admin-password]
               [--admin-username]
               [--app-gateway]
               [--app-gateway-capacity]
               [--app-gateway-sku]
               [--app-gateway-subnet-address-prefix]
               [--asgs]
               [--assign-identity]
               [--authentication-type {all, password, ssh}]
               [--automatic-repairs-action {Reimage, Replace, Restart}]
               [--automatic-repairs-grace-period]
               [--backend-pool-name]
               [--backend-port]
               [--capacity-reservation-group]
               [--computer-name-prefix]
               [--custom-data]
               [--data-disk-caching]
               [--data-disk-delete-option {Delete, Detach}]
               [--data-disk-encryption-sets]
               [--data-disk-iops]
               [--data-disk-mbps]
               [--data-disk-sizes-gb]
               [--disable-integrity-monitoring-autoupgrade]
               [--disable-overprovision]
               [--disk-controller-type {NVMe, SCSI}]
               [--dns-servers]
               [--edge-zone]
               [--enable-agent {false, true}]
               [--enable-auto-os-upgrade {false, true}]
               [--enable-auto-update {false, true}]
               [--enable-cross-zone-upgrade {false, true}]
               [--enable-hibernation {false, true}]
               [--enable-integrity-monitoring]
               [--enable-osimage-notification {false, true}]
               [--enable-proxy-agent {false, true}]
               [--enable-reboot {false, true}]
               [--enable-redeploy {false, true}]
               [--enable-resilient-creation {false, true}]
               [--enable-resilient-deletion {false, true}]
               [--enable-secure-boot {false, true}]
               [--enable-spot-restore {false, true}]
               [--enable-vtpm {false, true}]
               [--encryption-at-host {false, true}]
               [--ephemeral-os-disk {false, true}]
               [--ephemeral-os-disk-placement {CacheDisk, NvmeDisk, ResourceDisk}]
               [--eviction-policy {Deallocate, Delete}]
               [--exclude-extensions]
               [--generate-ssh-keys]
               [--health-probe]
               [--host-group]
               [--image]
               [--instance-count]
               [--lb]
               [--lb-nat-rule-name]
               [--lb-sku {Basic, Gateway, Standard}]
               [--license-type {None, RHEL_BASE, RHEL_BASESAPAPPS, RHEL_BASESAPHA, RHEL_BYOS, RHEL_ELS_6, RHEL_EUS, RHEL_SAPAPPS, RHEL_SAPHA, SLES, SLES_BYOS, SLES_HPC, SLES_SAP, SLES_STANDARD, UBUNTU, UBUNTU_PRO, Windows_Client, Windows_Server}]
               [--location]
               [--max-batch-instance-percent]
               [--max-price]
               [--max-surge {false, true}]
               [--max-unhealthy-instance-percent]
               [--max-unhealthy-upgraded-instance-percent]
               [--network-api-version]
               [--no-wait]
               [--nsg]
               [--orchestration-mode {Flexible, Uniform}]
               [--os-disk-caching {None, ReadOnly, ReadWrite}]
               [--os-disk-delete-option {Delete, Detach}]
               [--os-disk-encryption-set]
               [--os-disk-name]
               [--os-disk-secure-vm-disk-encryption-set]
               [--os-disk-security-encryption-type {DiskWithVMGuestState, NonPersistedTPM, VMGuestStateOnly}]
               [--os-disk-size-gb]
               [--os-type {linux, windows}]
               [--patch-mode {AutomaticByOS, AutomaticByPlatform, ImageDefault, Manual}]
               [--pause-time-between-batches]
               [--plan-name]
               [--plan-product]
               [--plan-promotion-code]
               [--plan-publisher]
               [--platform-fault-domain-count]
               [--ppg]
               [--prioritize-unhealthy-instances {false, true}]
               [--priority {Low, Regular, Spot}]
               [--proxy-agent-mode {Audit, Enforce}]
               [--public-ip-address]
               [--public-ip-address-allocation {dynamic, static}]
               [--public-ip-address-dns-name]
               [--public-ip-per-vm]
               [--regular-priority-count]
               [--regular-priority-percentage]
               [--role]
               [--scale-in-policy {Default, NewestVM, OldestVM}]
               [--scope]
               [--secrets]
               [--security-posture-id]
               [--security-type {ConfidentialVM, Standard, TrustedLaunch}]
               [--single-placement-group {false, true}]
               [--specialized {false, true}]
               [--spot-restore-timeout]
               [--ssh-dest-key-path]
               [--ssh-key-values]
               [--storage-container-name]
               [--storage-sku]
               [--subnet]
               [--subnet-address-prefix]
               [--tags]
               [--terminate-notification-time]
               [--ultra-ssd-enabled {false, true}]
               [--upgrade-policy-mode {Automatic, Manual, Rolling}]
               [--use-unmanaged-disk]
               [--user-data]
               [--v-cpus-available]
               [--v-cpus-per-core]
               [--validate]
               [--vm-domain-name]
               [--vm-sku]
               [--vnet-address-prefix]
               [--vnet-name]
               [--zones]

範例

建立具有 5 個實例、負載平衡器、公用 IP 位址、2GB 數據磁碟和 40GB OS 磁碟的 Windows VM 擴展集。

az vmss create -n MyVmss -g MyResourceGroup --instance-count 5 --image Win2016Datacenter --data-disk-sizes-gb 2 --os-disk-size-gb 40

建立具有自動產生 SSH 金鑰組、公用 IP 位址、DNS 專案、現有負載平衡器和現有虛擬網路的 Linux VM 擴展集。

az vmss create -n MyVmss -g MyResourceGroup --public-ip-address-dns-name my-globally-dns-name \
    --load-balancer MyLoadBalancer --vnet-name MyVnet --subnet MySubnet --image Ubuntu2204 \
    --generate-ssh-keys

使用預設現有的公用 SSH 金鑰，從自定義映像建立 Linux VM 擴展集。

az vmss create -n MyVmss -g MyResourceGroup --image MyImage

使用負載平衡器和自定義 DNS 伺服器建立 Linux VM 擴展集。每個 VM 都有公用 IP 位址和自訂功能變數名稱。

az vmss create -n MyVmss -g MyResourceGroup --image CentOS85Gen2 \
    --public-ip-per-vm --vm-domain-name myvmss --dns-servers 10.0.0.6 10.0.0.5

使用 cloud-init 腳本建立 Linux VM 擴展集以進行設定。請參閱：https://docs.microsoft.com/azure/virtual-machines/linux/using-cloud-init

az vmss create -g MyResourceGroup -n MyVmss --image Debian11 --custom-data MyCloudInitScript.yml

從一般化資源庫映像版本建立 VMSS。

az vmss create -g MyResourceGroup -n MyVmss --image /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage/versions/1.0.0

從特製化資源庫映像版本建立 VMSS。

az vmss create -g MyResourceGroup -n MyVmss --image /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage/versions/1.0.0 --specialized

從最新版資源庫映像建立 VMSS

az vmss create -g MyResourceGroup -n MyVmss --image /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Compute/galleries/myGallery/images/myImage

使用金鑰保存庫秘密建立Debian11 VM擴展集。

az keyvault certificate create --vault-name vaultname -n cert1 \
  -p "$(az keyvault certificate get-default-policy)"

secrets=$(az keyvault secret list-versions --vault-name vaultname \
  -n cert1 --query "[?attributes.enabled].id" -o tsv)

vm_secrets=$(az vm secret format -s "$secrets")

az vmss create -g group-name -n vm-name --admin-username deploy  \
  --image Debian11 --secrets "$vm_secrets"

建立具有系統指派身分識別的 VM 擴展集。 VM 將具有記憶體帳戶存取權的「參與者」角色。

az vmss create -n MyVmss -g MyResourceGroup --image CentOS85Gen2 --assign-identity --scope /subscriptions/99999999-1bf0-4dda-aec3-cb9272f09590/MyResourceGroup/myRG/providers/Microsoft.Storage/storageAccounts/storage1 --role Contributor

建立具有使用者指派身分識別的Debian11 VM擴展集。

az vmss create -n MyVmss -g rg1 --image Debian11 --assign-identity  /subscriptions/99999999-1bf0-4dda-aec3-cb9272f09590/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID

建立具有系統與使用者指派身分識別的Debian11 VM擴展集。

az vmss create -n MyVmss -g rg1 --image Debian11 --assign-identity  [system] /subscriptions/99999999-1bf0-4dda-aec3-cb9272f09590/resourcegroups/myRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myID

在目前資源群組的區域中建立單一區域 VM 擴展集

az vmss create -n MyVmss -g MyResourceGroup --image CentOS85Gen2 --zones 1

建立支援 SpotRestore 的 VMSS。

az vmss create -n MyVmss -g MyResourceGroup  --location NorthEurope --instance-count 2 --image CentOS85Gen2 --priority Spot --eviction-policy Deallocate --single-placement-group --enable-spot-restore True --spot-restore-timeout PT1H

從共享資源庫映像建立 VMSS。

az vmss create -n MyVmss -g MyResourceGroup --image /SharedGalleries/{gallery_unique_name}/Images/{image}/Versions/{version}

從社群資源庫映像建立 VMSS。

az vmss create -n MyVmss -g MyResourceGroup --image /CommunityGalleries/{gallery_unique_name}/Images/{image}/Versions/{version}

建立具有修補程式模式 'Manual' 的 Windows VMSS（VMSS 建立期間不支援目前修補程式模式 'AutomaticByPlatform' 作為 'AutomaticByPlatform' 模式所需的健康情況延伸模組，無法在 VMSS 建立期間設定。

az vmss create -n MyVmss -g MyResourceGroup --image Win2019Datacenter --enable-agent --enable-auto-update false --patch-mode Manual --orchestration-mode Flexible

建立 VMSS，並指定要用於擴展集中所有虛擬機的安全性狀態。

az vmss create -n MyVmss -g MyResourceGroup --image /CommunityGalleries/{gallery_unique_name}/Images/{image}/Versions/{version} --security-posture-reference-id /CommunityGalleries/{communityGalleryName}/securityPostures/{securityPostureName}/versions/{version} \
    --security-posture-reference-exclude-extensions "c:\tmp\exclude_extensions.json"

必要參數

--name -n

虛擬機擴展集的名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--accelerated-networking

啟用加速網路功能。除非指定，否則 CLI 會根據電腦映像和大小加以啟用。

接受的值: false, true

--accept-term

接受許可協議和隱私聲明。

--additional-events --additional-scheduled-events --scheduled-event-additional-publishing-target-event-grid-and-resource-graph

建立事件方格和資源圖表排程事件設定時所使用的組態參數。

接受的值: false, true

--admin-password

如果驗證類型為「密碼」，則 VM 的密碼。

--admin-username

VM 的用戶名稱。預設值是OS的目前用戶名稱。如果預設值是系統保留的，則預設值會設定為 azureuser。請參閱 https://docs.microsoft.com/rest/api/compute/virtualmachines/createorupdate#osprofile 以取得保留值的完整清單。

--app-gateway

建立新的應用程式閘道時要使用的名稱（預設值）或參考現有的閘道。也可以依標識碼參考現有的應用程式網關，或針對 none 指定 “”。

--app-gateway-capacity

建立新應用程式閘道時要使用的實例數目。

預設值: 10

--app-gateway-sku

建立新的應用程式閘道時，SKU。

預設值: Standard_Large

--app-gateway-subnet-address-prefix

建立 CIDR 格式的新應用程式閘道時要使用的子網 IP 位址前綴。

--asgs

要與 VM 建立關聯的現有應用程式安全組的空間分隔清單。

--assign-identity

接受以空格分隔的系統或使用者指派身分識別。使用 '[system]' 來參考系統指派的身分識別，或參考使用者指派的身分識別的資源標識符。如需更多範例，請參閱說明。

--authentication-type

要與 VM 搭配使用的驗證類型。預設為 Windows 和 Linux 的 SSH 公鑰密碼。 “all” 同時啟用 ssh 和密碼驗證。

接受的值: all, password, ssh

--automatic-repairs-action

將用於修復擴展集中狀況不良虛擬機的修復動作類型。

接受的值: Reimage, Replace, Restart

--automatic-repairs-grace-period

VM 狀態變更而暫停自動修復的時間量（以分鐘為單位，介於 30 到 90 之間）。

--backend-pool-name

建立新的負載平衡器或應用程式閘道時，要用於後端集區的名稱。

--backend-port

建立新的負載平衡器時，後埠會以 NAT 規則開啟（在 Linux 上預設為 22，在 Windows 上為 3389）。建立應用程式閘道時，要用於後端 HTTP 設定的後連接埠。

--capacity-reservation-group --crg

預覽

用來配置之容量保留群組的標識碼或名稱。傳入「None」以解除容量保留群組的關聯。請注意，如果您想要刪除已與容量保留群組相關聯的 VM/VMSS，您必須先解除與容量保留群組的關聯。

--computer-name-prefix

擴展集中所有虛擬機的計算機名稱前置詞。計算機名稱前置詞長度必須為1到15個字元。

--custom-data

自定義 init 腳本檔案或文字（cloud-init、cloud-config 等）。

--data-disk-caching

數據磁碟的記憶體快取類型，包括『None』、『ReadOnly』、『ReadWrite』等。使用單一值在所有磁碟上套用，或使用 <lun>=<vaule1> <lun>=<value2> 來設定個別磁碟。

--data-disk-delete-option

指定數據磁碟應該在 VMSS Flex 刪除時刪除或中斷連結（此功能僅適用於具有彈性協調流程模式的 VMSS）。

接受的值: Delete, Detach

--data-disk-encryption-sets

數據磁碟的磁碟加密集名稱或標識碼（以空格分隔）。

--data-disk-iops

指定受控磁碟的讀寫 IOPS （空格分隔）。只有當 StorageAccountType UltraSSD_LRS時，才應該使用。如果未指定，則會根據diskSizeGB指派預設值。

--data-disk-mbps

為受控磁碟指定每秒 MB 的頻寬（以空格分隔）。只有當 StorageAccountType UltraSSD_LRS時，才應該使用。如果未指定，則會根據diskSizeGB指派預設值。

--data-disk-sizes-gb

以 GB 為單位的空間分隔空白受控數據磁碟大小來建立。

--disable-integrity-monitoring-autoupgrade

針對已啟用信任啟動的 VM 和 VMSS，停用客體證明延伸模組的自動升級。

預設值: False

--disable-overprovision

過度布建選項（如需詳細資訊，請參閱 https://azure.microsoft.com/documentation/articles/virtual-machine-scale-sets-overview/ ）。

--disk-controller-type

預覽

指定為 VM 或 VMSS 設定的磁碟控制器類型。

接受的值: NVMe, SCSI

--dns-servers

DNS 伺服器的空間分隔 IP 位址，例如 10.0.0.5 10.0.0.6。

--edge-zone

邊緣區域的名稱。

--enable-agent

指出虛擬機器代理程式是否應該佈建在虛擬機上。未指定此屬性時，預設行為是將它設定為 true。這可確保 VM 代理程式已安裝在 VM 上，以便稍後將擴充功能新增至 VM。

接受的值: false, true

--enable-auto-os-upgrade

指出當較新版本的OS映像可用時，是否應該以滾動方式自動將OS升級套用至擴展集實例。

接受的值: false, true

--enable-auto-update

指出是否為 Windows 虛擬機啟用自動更新。

接受的值: false, true

--enable-cross-zone-upgrade

設定此布爾值屬性可讓 VMSS 在建構升級批次時忽略 AZ 界限，並且只考慮更新網域和 maxBatchInstancePercent 來判斷批次大小。

接受的值: false, true

--enable-hibernation

在 VMSS 上啟用或停用休眠功能的旗標。

接受的值: false, true

--enable-integrity-monitoring

啟用安裝Microsoft支援且不支援安全性的客體證明延伸模組，並啟用已啟用受信任啟動之 VM 和 VMSS 的系統指派身分識別。

預設值: False

--enable-osimage-notification

指定是否啟用或停用OS映像排程事件。

接受的值: false, true

--enable-proxy-agent

指定是否應在虛擬機或虛擬機擴展集上啟用 Proxy 代理程式功能。

接受的值: false, true

--enable-reboot --enable-user-reboot-scheduled-events

發佈排程事件時所使用的組態參數，其他發佈目標。

接受的值: false, true

--enable-redeploy --enable-user-redeploy-scheduled-events

建立使用者起始的重新部署排程事件設定建立時所使用的組態參數。

接受的值: false, true

--enable-resilient-creation

藉由刪除並重新建立受影響的 VM，自動從 VM 建立作業期間發生的 OS 佈建逾時和 VM 啟動逾時錯誤復原客戶。

接受的值: false, true

--enable-resilient-deletion

在刪除作業失敗時，請以異步方式重試 VM 刪除要求。

接受的值: false, true

--enable-secure-boot

啟用安全開機。

接受的值: false, true

--enable-spot-restore

啟用 Spot-Try-Restore 功能，其中會嘗試根據容量可用性和定價限制，嘗試收回的 VMSS SPOT 實例以機會方式還原。

接受的值: false, true

--enable-vtpm

啟用 vTPM。

接受的值: false, true

--encryption-at-host

啟用 VM 或 VMSS 的主機加密。這會啟用所有磁碟的加密，包括主機本身的資源/暫存磁碟。

接受的值: false, true

--ephemeral-os-disk

可讓您直接在主機節點上建立OS磁碟，以提供本機磁碟效能和更快的VM/VMSS重新映像時間。

接受的值: false, true

--ephemeral-os-disk-placement --ephemeral-placement

僅適用於搭配 --ephemeral-os-disk使用時。可讓您選擇暫時 OS 磁碟布建位置。

接受的值: CacheDisk, NvmeDisk, ResourceDisk

--eviction-policy

現成優先順序擴展集中虛擬機的收回原則。默認收回原則是現成優先順序擴展集的解除分配。

接受的值: Deallocate, Delete

--exclude-extensions --security-posture-reference-exclude-extensions

套用安全性狀態時要排除的虛擬機擴充功能清單。可以接受 Json 字串或檔案路徑。如需資料格式，請參閱 https://docs.microsoft.com/rest/api/compute/virtualmachinescalesets/get#virtualmachineextension 。

--generate-ssh-keys

如果遺失 SSH 公用和私人 RSA 金鑰檔案，請產生 SSH 公用和私人 RSA 金鑰檔案。金鑰會儲存在 ~/.ssh 目錄中。

預設值: False

--health-probe

來自現有負載平衡器的探查名稱，主要用於滾動升級或自動修復。

--host-group

虛擬機擴展集所在的專用主機群組名稱或標識碼。

--image

操作系統映像的名稱，做為 URN 別名、URN、自定義映像名稱或標識碼，或 VHD Blob URI。此外，它也支援共用資源庫映像。請使用映像別名，包括您想要使用的發行版版本。例如：請使用Debian11，而不是Debian。除非使用有效的 URN 格式：“Publisher：Offer：Sku：Version”，否則需要此參數 --attach-os-disk. 。如需詳細資訊，請參閱https://docs.microsoft.com/azure/virtual-machines/linux/cli-ps-findimage。

值來源: az sig image-version show-shared, az vm image list, az vm image show

--instance-count

擴展集中的 VM 數目。

預設值: 2

--lb --load-balancer

建立新的負載平衡器時要使用的名稱（預設值）或參考現有的負載平衡器。也可以依標識符參考現有的負載平衡器，或針對 none 指定 “”。

--lb-nat-rule-name --nat-rule-name

建立新的負載平衡器時，要用於 NAT 規則 v2 的名稱。（NAT 規則 V2 用來取代 NAT 集區）。

--lb-sku

要建立的Load Balancer Sku。只有在「標準」時，才支援在邊緣區域建立公用IP。

接受的值: Basic, Gateway, Standard

預設值: Standard

--license-type

指定 Windows 映像或磁碟已獲內部部署授權。若要啟用適用於 Windows Server 的 Azure Hybrid Benefit，請使用「Windows_Server」。若要啟用 Windows 10 的多租用戶裝載許可權，請使用『Windows_Client』。如需詳細資訊，請參閱 Azure Windows VM 在線檔。

接受的值: None, RHEL_BASE, RHEL_BASESAPAPPS, RHEL_BASESAPHA, RHEL_BYOS, RHEL_ELS_6, RHEL_EUS, RHEL_SAPAPPS, RHEL_SAPHA, SLES, SLES_BYOS, SLES_HPC, SLES_SAP, SLES_STANDARD, UBUNTU, UBUNTU_PRO, Windows_Client, Windows_Server

--location -l

用來建立 VM 和相關資源的位置。如果未設定預設位置，則會預設為資源群組的位置。

--max-batch-instance-percent

一個批次中滾動升級同時升級的虛擬機實例總數上限百分比。預設值：20%。

--max-price

預覽

您願意支付現成 VM/VMSS 的最高價格（以美元為單位）。 -1 表示基於價格原因，不應收回 Spot VM/VMSS。

--max-surge

預覽

指定它以建立新的虛擬機來升級擴展集，而不是更新現有的虛擬機。

接受的值: false, true

--max-unhealthy-instance-percent

擴展集中可同時狀況不良之虛擬機實例總數的百分比上限。預設值：20%。

--max-unhealthy-upgraded-instance-percent

可發現處於狀況不良狀態的已升級虛擬機實例百分比上限。預設值：20%。

--network-api-version

使用協調流程模式「彈性」，在虛擬機擴展集的網路介面組態中，指定建立網路資源時所使用的Microsoft.Network API 版本。預設值為 2020-11-01。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--nsg

現有網路安全組的名稱或識別碼。

--orchestration-mode

選擇虛擬機如何由擴展集管理。在統一模式中，您會定義虛擬機模型，而 Azure 會根據該模型產生相同的實例。在彈性模式中，您可以手動建立任何組態的虛擬機，並將其新增至擴展集，或根據為擴展集定義的虛擬機模型產生相同的實例。

接受的值: Flexible, Uniform

預設值: Flexible

--os-disk-caching

VM OS 磁碟的記憶體快取類型。默認值：ReadWrite。

接受的值: None, ReadOnly, ReadWrite

--os-disk-delete-option

指定在 VMSS Flex 刪除時應刪除或中斷連結 OS 磁碟（此功能僅適用於具有彈性協調流程模式的 VMSS）。

接受的值: Delete, Detach

--os-disk-encryption-set

OS 磁碟的磁碟加密集名稱或標識碼。

--os-disk-name

新 VM OS 磁碟的名稱。

--os-disk-secure-vm-disk-encryption-set

針對客戶受控密鑰加密的機密 VM OS 磁碟和 VM 客體 Blob，指定客戶受控磁碟加密集資源識別碼或名稱。

--os-disk-security-encryption-type

指定 OS 受控磁碟的加密類型。

接受的值: DiskWithVMGuestState, NonPersistedTPM, VMGuestStateOnly

--os-disk-size-gb

要建立的 OS 磁碟大小以 GB 為單位。

--os-type

安裝在自定義 VHD 上的 OS 類型。指定 URN 或 URN 別名時請勿使用。

接受的值: linux, windows

--patch-mode

客體內修補至 IaaS 虛擬機的模式。 Windows VM 允許的值：AutomaticByOS、AutomaticByPlatform、Manual。 Linux VM 允許的值：AutomaticByPlatform、ImageDefault。手動 - 您可以控制將修補程式的應用程式套用至虛擬機。您可以手動在 VM 內套用修補程式來執行此動作。在此模式中，會停用自動更新;paramater --enable-auto-update 必須是 false。 AutomaticByOS - 作業系統會自動更新虛擬機。參數 --enable-auto-update 必須為 true。 AutomaticByPlatform - 虛擬機將會由操作系統自動更新。 ImageDefault - 會使用虛擬機的默認修補組態。參數 --enable-agent 和 --enable-auto-update 必須為 true。

接受的值: AutomaticByOS, AutomaticByPlatform, ImageDefault, Manual

--pause-time-between-batches

完成一個批次中所有虛擬機的更新，以及開始下一個批次之間的等候時間。預設值：0 秒。

--plan-name

方案名稱。

--plan-product

規劃產品。

--plan-promotion-code

規劃促銷碼。

--plan-publisher

方案發行者。

--platform-fault-domain-count

可用性區域中每個放置群組的容錯網域計數。

--ppg

VMSS 應該與鄰近放置群組的名稱或標識符相關聯。

--prioritize-unhealthy-instances

設定此布爾值屬性會導致擴展集中所有狀況不良的實例在任何狀況良好的實例之前升級。

接受的值: false, true

--priority

優先順序。使用『Spot』以符合成本效益的方式執行短期工作負載。未來『低』列舉將會淘汰。請使用「Spot」來部署 Azure 現成 VM 和/或 VMSS。默認為 [一般]。

接受的值: Low, Regular, Spot

--proxy-agent-mode

如果啟用此功能，請指定 Proxy 代理程式在上執行的模式。

接受的值: Audit, Enforce

--public-ip-address

建立一個公用IP位址時的名稱（預設值）或參考現有的IP位址。也可以使用 PowerShell 或 --% 運算符，依標識符參考現有的公用 IP，或在 Azure CLI 中為 None 指定 “”'“。針對使用 powershell Core 7.3.4 版的 Azure CLI，請指定或 “” （--public-ip-address 或 --public-ip-address “” ）。

--public-ip-address-allocation

接受的值: dynamic, static

--public-ip-address-dns-name

新建立公用IP的全域唯一 DNS 名稱。

--public-ip-per-vm

每個 VM 實例都會有公用 IP。為了安全性，您可以使用 '--nsg' 來套用適當的規則。

預設值: False

--regular-priority-count

預覽

將在此擴展集中建立之一般優先順序 VM 的基數，因為它會相應放大。必須大於 0。

--regular-priority-percentage

預覽

達到基底一般優先順序計數之後，VM 實例的百分比預期會使用一般優先順序。必須介於 0 到 100 之間。

--role

系統指派身分識別的角色名稱或標識碼。

--scale-in-policy

指定相應縮小原則（以空格分隔），決定在調整虛擬機擴展集時要移除的虛擬機。

接受的值: Default, NewestVM, OldestVM

--scope

系統指派的身分識別可以存取的範圍。

--secrets

一或多個金鑰保存庫秘密作為 JSON 字串或檔案，透過@{path}包含 [{ "sourceVault": { "id": "value" }, "vaultCertificates": [{ "certificateUrl": "value", "certificateStore": "cert store name (only on windows)"}] }]。

--security-posture-id --security-posture-reference-id

安全性狀態參考標識符的格式為 /CommunityGalleries/{communityGalleryName}/securityPostures/{securityPostureName}/versions/{major.minor.patch}|{major.*}|latest。

--security-type

指定虛擬機的安全性類型。

接受的值: ConfidentialVM, Standard, TrustedLaunch

--single-placement-group

將擴展集限制為單一放置群組。如需詳細資訊，請參閱https://docs.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-placement-groups。

接受的值: false, true

--specialized

指出來源映像是否特製化。

接受的值: false, true

--spot-restore-timeout

以 ISO 8601 時間持續時間表示的逾時值，之後平臺不會嘗試還原 VMSS SPOT 實例。

--ssh-dest-key-path

SSH 金鑰 VM 上的目的地檔案路徑。如果檔案已經存在，指定的索引鍵會附加至檔案。 SSH 公鑰的目的地路徑目前受限於其預設值 “/home/username/.ssh/authorized_keys”，因為 Linux 布建代理程式有已知問題。

--ssh-key-values

SSH 公鑰或公鑰檔案路徑的空間分隔清單。

--storage-container-name

僅適用於搭配 --use-unmanaged-disk使用時。 VM OS 磁碟的記憶體容器名稱。默認值：vhds。

預設值: vhds

--storage-sku

要保存 VM 之記憶體帳戶的 SKU。使用可套用至所有磁碟的單一 SKU，或指定個別磁碟。使用方式：[--storage-sku SKU | --storage-sku ID=SKU ID=SKU=SKU...]，其中每個標識符都是 “os” 或 0 索引的 lun。允許的值：Standard_LRS、Premium_LRS、StandardSSD_LRS、UltraSSD_LRS、Premium_ZRS、StandardSSD_ZRS、PremiumV2_LRS。

--subnet

建立新的 VNet 或參考現有 VNet 時，子網的名稱。也可以依標識碼參考現有的子網。如果省略 vnet 名稱和子網，系統會自動選取適當的 VNet 和子網，或建立新的 VNet。

--subnet-address-prefix

建立 CIDR 格式的新 VNet 時要使用的子網 IP 位址前綴。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用「清除現有的標記」。

--terminate-notification-time

將通知傳送至實例元數據伺服器上的 VM，直到 VM 被刪除為止，時間長度（以分鐘為單位，介於 5 到 15 之間）。

--ultra-ssd-enabled

啟用或停用具有1個以上的受控數據磁碟與UltraSSD_LRS記憶體帳戶的功能。

接受的值: false, true

--upgrade-policy-mode

指定升級至擴展集中虛擬機的模式。

接受的值: Automatic, Manual, Rolling

預設值: manual

--use-unmanaged-disk

請勿使用受控磁碟來保存 VM。

預設值: False

--user-data

擴展集中虛擬機的UserData。它可以以檔案或字串的形式傳入。

--v-cpus-available

指定可用的 vCPU 數目。

--v-cpus-per-core

指定 vCPU 與實體核心的比例。將此屬性設定為 1 也表示已停用超線程處理。

--validate

產生並驗證 ARM 範本，而不需建立任何資源。

預設值: False

--vm-domain-name

一旦設定好 VM 實體的功能變數名稱，FQDN 就是 vm<vm-index>.<vm-domain-name>.<..rest..>。

--vm-sku

擴展集中的 VM 大小。預設為「Standard_DS1_v2」。。如需大小資訊，請參閱 https://azure.microsoft.com/pricing/details/virtual-machines/ 。

--vnet-address-prefix

以 CIDR 格式建立新 VNet 時要使用的 IP 位址前綴。

預設值: 10.0.0.0/16

--vnet-name

建立新的虛擬網路或參考現有虛擬網路時的名稱。

--zones -z

要在其中布建資源的可用性區域空間分隔清單。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss deallocate

編輯

解除分配 VMSS 內的 VM。

az vmss deallocate --name
                   --resource-group
                   [--hibernate {false, true}]
                   [--instance-ids]
                   [--no-wait]

範例

解除分配 VMSS 內的 VM。（自動產生）

az vmss deallocate --instance-ids 1 --name MyScaleSet --resource-group MyResourceGroup

必要參數

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--hibernate

從 VM 擴展集休眠虛擬機。僅適用於具有彈性 OrchestrationMode 的 VMSS。

接受的值: false, true

--instance-ids

所有實體的空間分隔識別碼清單（例如：1 2 3 ...）或 * 。如果未提供，則會在擴展集本身套用動作。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss delete

編輯

刪除 VM 擴展集。

az vmss delete [--force-deletion {0, 1, f, false, n, no, t, true, y, yes}]
               [--ids]
               [--name]
               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
               [--resource-group]
               [--subscription]

選擇性參數

--force-deletion

選擇性參數以強制刪除 VM 擴展集。（預覽中的功能）。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--ids

一或多個資源識別碼 (以空格分隔)。它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。您應該提供 --ids 或其他「資源識別碼」引數。

--name --vm-scale-set-name -n

VM 擴展集的名稱。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss delete-instances

編輯

刪除 VMSS 內的 VM。

az vmss delete-instances --instance-ids
                         --name
                         --resource-group
                         [--no-wait]

範例

刪除 VMSS 內的 VM。（自動產生）

az vmss delete-instances --instance-ids 0 --name MyScaleSet --resource-group MyResourceGroup

必要參數

--instance-ids

所有實體的空間分隔識別碼清單（例如：1 2 3 ...）或 * 。

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss get-instance-view

編輯

檢視 VMSS 的實例。

az vmss get-instance-view [--ids]
                          [--instance-id]
                          [--name]
                          [--resource-group]
                          [--subscription]

範例

檢視 VMSS 的實例。（自動產生）

az vmss get-instance-view --name MyScaleSet --resource-group MyResourceGroup

選擇性參數

--ids

--instance-id

VM 實例識別碼或「*」可列出擴展集中所有 VM 的實例檢視。

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss get-os-upgrade-history

編輯

列出 VM 擴展集實例上的 OS 升級。

az vmss get-os-upgrade-history --name
                               --resource-group
                               [--max-items]
                               [--next-token]

必要參數

--name --vm-scale-set-name -n

VM 擴展集的名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--max-items

命令輸出中要傳回的項目總數。如果可用的專案總數超過指定的值，則會在命令的輸出中提供令牌。若要繼續分頁，請在後續命令的自變數中 --next-token 提供令牌值。

--next-token

標記，指定要開始分頁的位置。這是先前截斷回應中的令牌值。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss list

編輯

列出資源群組下的所有 VM 擴展集。

az vmss list [--max-items]
             [--next-token]
             [--resource-group]

範例

列出 VMSS

az vmss list --resource-group MyResourceGroup

選擇性參數

--max-items

--next-token

標記，指定要開始分頁的位置。這是先前截斷回應中的令牌值。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss list-instance-connection-info

編輯

取得用來連線到集合內個別 VM 實例的 IP 位址和埠號碼。

az vmss list-instance-connection-info [--ids]
                                      [--name]
                                      [--resource-group]
                                      [--subscription]

範例

取得用來連線到集合內個別 VM 實例的 IP 位址和埠號碼。（自動產生）

az vmss list-instance-connection-info --name MyScaleSet --resource-group MyResourceGroup

選擇性參數

--ids

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss list-instance-public-ips

編輯

列出集合內 VM 實例的公用 IP 位址。

az vmss list-instance-public-ips [--ids]
                                 [--name]
                                 [--resource-group]
                                 [--subscription]

範例

列出集合內 VM 實例的公用 IP 位址。（自動產生）

az vmss list-instance-public-ips --name MyScaleSet --resource-group MyResourceGroup

選擇性參數

--ids

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss list-instances

編輯

列出 VM 擴展集中的所有虛擬機。

傳回 VMSS 所管理的虛擬機清單。針對彈性協調流程模式中的 VMSS，請使用 “az vm list” 來取得完整詳細數據。

az vmss list-instances --name
                       --resource-group
                       [--expand]
                       [--filter]
                       [--max-items]
                       [--next-token]
                       [--select]

必要參數

--name --virtual-machine-scale-set-name -n

VM 擴展集的名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--expand

要套用至作業的展開表達式。允許的值為『instanceView』。

--filter

要套用至作業的篩選。允許的值是 'startswith（instanceView/statuses/code， 'PowerState'） eq true'， 'properties/latestModelApplied eq true'， 'properties/latestModelApplied eq false'。

--max-items

--next-token

標記，指定要開始分頁的位置。這是先前截斷回應中的令牌值。

--select

清單參數。允許的值為『instanceView』、'instanceView/statuses'。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss list-skus

編輯

列出 VM 擴充集可用的 SKU，包括每個 SKU 允許的最小和最大 VM 實例。

az vmss list-skus --name
                  --resource-group
                  [--max-items]
                  [--next-token]

必要參數

--name --vm-scale-set-name -n

VM 擴展集的名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--max-items

--next-token

標記，指定要開始分頁的位置。這是先前截斷回應中的令牌值。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss perform-maintenance

編輯

在 VM 擴展集中的一或多個虛擬機上執行維護。不符合執行維護資格的實例上的作業將會失敗。如需詳細資訊，請參閱最佳做法： https://docs.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-maintenance-notifications。

az vmss perform-maintenance [--ids]
                            [--instance-ids]
                            [--name]
                            [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                            [--resource-group]
                            [--subscription]

選擇性參數

--ids

--instance-ids

虛擬機擴展集實例標識碼。省略虛擬機擴展集實例標識碼會導致作業在虛擬機擴展集的所有虛擬機上執行。支援速記語法、json-file 和 yaml-file。請嘗試 “？？” 以顯示更多。

--name --vm-scale-set-name -n

VM 擴展集的名稱。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss reimage

編輯

在 VMSS 內重新設定 VM 的映像。

az vmss reimage [--force-update-os-disk-for-ephemeral {false, true}]
                [--ids]
                [--instance-ids]
                [--name]
                [--no-wait]
                [--resource-group]
                [--subscription]

範例

在 VMSS 內重新設定 VM 實例的映像。

az vmss reimage --instance-ids 1 --name MyScaleSet --resource-group MyResourceGroup --subscription MySubscription

在 VMSS 中重新映像一批 VM 實例。

az vmss reimage --instance-ids 1 2 3 --name MyScaleSet --resource-group MyResourceGroup --subscription MySubscription

重新映像 VMSS 內的所有 VM 實例。

az vmss reimage --name MyScaleSet --resource-group MyResourceGroup --subscription MySubscription

選擇性參數

--force-update-os-disk-for-ephemeral --update-os-disk

強制更新虛擬機擴展集 VM 的暫時 OS 磁碟。

接受的值: false, true

--ids

--instance-ids

VM 實例識別碼的空間分隔清單。如果遺失，請重新設定所有實例的映像。

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss restart

編輯

重新啟動 VMSS 內的 VM。

az vmss restart --name
                --resource-group
                [--instance-ids]
                [--no-wait]

範例

重新啟動 VMSS 內的 VM。（自動產生）

az vmss restart --instance-ids 1 --name MyScaleSet --resource-group MyResourceGroup

必要參數

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--instance-ids

所有實體的空間分隔識別碼清單（例如：1 2 3 ...）或 * 。如果未提供，則會在擴展集本身套用動作。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss scale

編輯

變更 VMSS 內的 VM 數目。

az vmss scale --new-capacity
              [--ids]
              [--name]
              [--no-wait]
              [--resource-group]
              [--subscription]

範例

變更 VMSS 內的 VM 數目。（自動產生）

az vmss scale --name MyScaleSet --new-capacity 6 --resource-group MyResourceGroup

必要參數

--new-capacity

VMSS 中的 VM 數目。

選擇性參數

--ids

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss set-orchestration-service-state

編輯

變更 VMSS 內指定服務的 ServiceState 屬性。

az vmss set-orchestration-service-state --action {Resume, Suspend}
                                        --service-name {AutomaticRepairs, DummyOrchestrationServiceName}
                                        [--ids]
                                        [--name]
                                        [--no-wait]
                                        [--resource-group]
                                        [--subscription]

範例

變更 AutomaticRepairs 的 ServiceState 屬性

az vmss set-orchestration-service-state --service-name AutomaticRepairs --action Resume --name MyScaleSet --resource-group MyResourceGroup

必要參數

--action

要執行的動作。

接受的值: Resume, Suspend

--service-name

協調流程服務的名稱。

接受的值: AutomaticRepairs, DummyOrchestrationServiceName

選擇性參數

--ids

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss show

編輯

取得 VMSS 內 VM 的詳細數據。

az vmss show --name
             --resource-group
             [--include-user-data]
             [--instance-id]

範例

取得 VMSS 內 VM 的詳細數據。（自動產生）

az vmss show --name MyScaleSet --resource-group MyResourceGroup

必要參數

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--include-user-data -u

在查詢結果中包含用戶資料屬性。

預設值: False

--instance-id

VM 實例標識碼。如果遺失，請顯示 VMSS。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss simulate-eviction

編輯

模擬 VM 擴展集中 Spot 虛擬機的收回。

az vmss simulate-eviction [--ids]
                          [--instance-id]
                          [--name]
                          [--resource-group]
                          [--subscription]

範例

模擬 VM 擴展集中 Spot 虛擬機的收回。

az vmss simulate-eviction --resource-group MyResourceGroup --name MyScaleSet --instance-id 0

選擇性參數

--ids

--instance-id

虛擬機的實例標識碼。

--name --vm-scale-set-name -n

VM 擴展集的名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss start

編輯

啟動 VMSS 內的 VM。

az vmss start --name
              --resource-group
              [--instance-ids]
              [--no-wait]

範例

啟動 VMSS 內的 VM。（自動產生）

az vmss start --instance-ids 1 --name MyScaleSet --resource-group MyResourceGroup

必要參數

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--instance-ids

所有實體的空間分隔識別碼清單（例如：1 2 3 ...）或 * 。如果未提供，則會在擴展集本身套用動作。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss stop

編輯

關閉（停止） VMSS 內的 VM。

VM 將會繼續計費。若要避免這種情況，您可以透過「az vmss deallocate」在 VMSS 內解除分配 VM 實例。

az vmss stop --name
             --resource-group
             [--instance-ids]
             [--no-wait]
             [--skip-shutdown]

範例

在 VMSS 內關閉 VM，而不需關閉。

az vmss stop --name MyScaleSet --resource-group MyResourceGroup --skip-shutdown

關閉（停止） VMSS 內的 VM。（自動產生）

az vmss stop --instance-ids 1 --name MyScaleSet --resource-group MyResourceGroup

必要參數

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--instance-ids

所有實體的空間分隔識別碼清單（例如：1 2 3 ...）或 * 。如果未提供，則會在擴展集本身套用動作。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--skip-shutdown

立即略過關機和關閉電源。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss update

編輯

更新 VMSS。如果您尚未設定升級原則，請執行 'az vmss update-instances' 命令來推出 VM 的變更。

az vmss update [--add]
               [--additional-events {false, true}]
               [--automatic-repairs-action {Reimage, Replace, Restart}]
               [--automatic-repairs-grace-period]
               [--capacity-reservation-group]
               [--custom-data]
               [--disk-controller-type {NVMe, SCSI}]
               [--enable-auto-os-upgrade {false, true}]
               [--enable-automatic-repairs {false, true}]
               [--enable-cross-zone-upgrade {false, true}]
               [--enable-hibernation {false, true}]
               [--enable-osimage-notification {false, true}]
               [--enable-proxy-agent {false, true}]
               [--enable-reboot {false, true}]
               [--enable-redeploy {false, true}]
               [--enable-resilient-creation {false, true}]
               [--enable-resilient-deletion {false, true}]
               [--enable-secure-boot {false, true}]
               [--enable-spot-restore {false, true}]
               [--enable-terminate-notification {false, true}]
               [--enable-vtpm {false, true}]
               [--ephemeral-option {Local}]
               [--ephemeral-os-disk {false, true}]
               [--ephemeral-os-disk-placement {CacheDisk, NvmeDisk, ResourceDisk}]
               [--exclude-extensions]
               [--force-deletion]
               [--force-string]
               [--ids]
               [--instance-id]
               [--license-type {None, RHEL_BASE, RHEL_BASESAPAPPS, RHEL_BASESAPHA, RHEL_BYOS, RHEL_ELS_6, RHEL_EUS, RHEL_SAPAPPS, RHEL_SAPHA, SLES, SLES_BYOS, SLES_HPC, SLES_SAP, SLES_STANDARD, UBUNTU, UBUNTU_PRO, Windows_Client, Windows_Server}]
               [--max-batch-instance-percent]
               [--max-price]
               [--max-surge {false, true}]
               [--max-unhealthy-instance-percent]
               [--max-unhealthy-upgraded-instance-percent]
               [--name]
               [--no-wait]
               [--pause-time-between-batches]
               [--ppg]
               [--prioritize-unhealthy-instances {false, true}]
               [--priority {Low, Regular, Spot}]
               [--protect-from-scale-in {false, true}]
               [--protect-from-scale-set-actions {false, true}]
               [--proxy-agent-mode {Audit, Enforce}]
               [--regular-priority-count]
               [--regular-priority-percentage]
               [--remove]
               [--resource-group]
               [--scale-in-policy {Default, NewestVM, OldestVM}]
               [--security-posture-id]
               [--security-type {Standard, TrustedLaunch}]
               [--set]
               [--spot-restore-timeout]
               [--subscription]
               [--terminate-notification-time]
               [--ultra-ssd-enabled {false, true}]
               [--upgrade-policy-mode {Automatic, Manual, Rolling}]
               [--user-data]
               [--v-cpus-available]
               [--v-cpus-per-core]
               [--vm-sku]
               [--zones]

範例

更新 Azure Hybrid Benefit 的 VMSS 授權類型。

az vmss update --name MyScaleSet --resource-group MyResourceGroup --license-type windows_server

更新 VM 實例的保護原則。

az vmss update --name MyScaleSet --resource-group MyResourceGroup --instance-id 4 --protect-from-scale-set-actions False --protect-from-scale-in

更新 VM 實例的保護原則。

az vmss update --name MyScaleSet --resource-group MyResourceGroup --instance-id 4 --set protectionPolicy.protectFromScaleIn=True protectionPolicy.protectFromScaleSetActions=False

更新 VM 實例受控磁碟的讀寫 IOPS。

az vmss update --name MyScaleSet --resource-group MyResourceGroup --set virtualMachineProfile.storageProfile.dataDisks[0].diskIOPSReadWrite=444

以每秒 MB 為單位的受控磁碟更新 VM 實例的頻寬。

az vmss update --name MyScaleSet --resource-group MyResourceGroup --set virtualMachineProfile.storageProfile.dataDisks[0].diskMBpsReadWrite=66

更新 VM 以使用自訂映像。

az vmss update --name MyScaleSet --resource-group MyResourceGroup --set virtualMachineProfile.storageProfile.imageReference.id=imageID

將 Linux VMSS 更新為修補程式模式『AutomaticByPlatform』。

az vmss update -n MyVmss -g MyResourceGroup --set virtualMachineProfile.osProfile.linuxConfiguration.patchSettings.patchMode=AutomaticByPlatform

更新 VMSS，並指定要用於擴展集中所有虛擬機的安全性狀態。

az vmss update -n MyVmss -g MyResourceGroup --security-posture-reference-id /CommunityGalleries/{communityGalleryName}/securityPostures/{securityPostureName}/versions/{version} \
    --security-posture-reference-exclude-extensions "c:\tmp\exclude_extensions.json"

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。範例：--add property.listProperty <key=value, string or JSON string>。

預設值: []

--additional-events --additional-scheduled-events --scheduled-event-additional-publishing-target-event-grid-and-resource-graph

建立事件方格和資源圖表排程事件設定時所使用的組態參數。

接受的值: false, true

--automatic-repairs-action

將用於修復擴展集中狀況不良虛擬機的修復動作類型。

接受的值: Reimage, Replace, Restart

--automatic-repairs-grace-period

VM 狀態變更而暫停自動修復的時間量（以分鐘為單位，介於 30 到 90 之間）。

--capacity-reservation-group --crg

預覽

--custom-data

自定義 init 腳本檔案或文字（cloud-init、cloud-config 等）。

--disk-controller-type

預覽

指定為 VM 或 VMSS 設定的磁碟控制器類型。

接受的值: NVMe, SCSI

--enable-auto-os-upgrade

指出當較新版本的OS映像可用時，是否應該以滾動方式自動將OS升級套用至擴展集實例。

接受的值: false, true

--enable-automatic-repairs

啟用自動修復。

接受的值: false, true

--enable-cross-zone-upgrade

設定此布爾值屬性可讓 VMSS 在建構升級批次時忽略 AZ 界限，並且只考慮更新網域和 maxBatchInstancePercent 來判斷批次大小。

接受的值: false, true

--enable-hibernation

在 VMSS 上啟用或停用休眠功能的旗標。

接受的值: false, true

--enable-osimage-notification

指定是否啟用或停用OS映像排程事件。

接受的值: false, true

--enable-proxy-agent

指定是否應在虛擬機或虛擬機擴展集上啟用 Proxy 代理程式功能。

接受的值: false, true

--enable-reboot --enable-user-reboot-scheduled-events

發佈排程事件時所使用的組態參數，其他發佈目標。

接受的值: false, true

--enable-redeploy --enable-user-redeploy-scheduled-events

建立使用者起始的重新部署排程事件設定建立時所使用的組態參數。

接受的值: false, true

--enable-resilient-creation

藉由刪除並重新建立受影響的 VM，自動從 VM 建立作業期間發生的 OS 佈建逾時和 VM 啟動逾時錯誤復原客戶。

接受的值: false, true

--enable-resilient-deletion

在刪除作業失敗時，請以異步方式重試 VM 刪除要求。

接受的值: false, true

--enable-secure-boot

啟用安全開機。

接受的值: false, true

--enable-spot-restore

啟用 Spot-Try-Restore 功能，其中會嘗試根據容量可用性和定價限制，嘗試收回的 VMSS SPOT 實例以機會方式還原。

接受的值: false, true

--enable-terminate-notification

啟用終止通知。

接受的值: false, true

--enable-vtpm

啟用 vTPM。

接受的值: false, true

--ephemeral-option --ephemeral-os-disk-option

指定作業系統磁碟的暫時磁碟設定。

接受的值: Local

--ephemeral-os-disk

可讓您指定作業系統磁碟的暫時磁碟設定。將其指定為 false，將暫時磁碟設定設定為空白，並將其遷移至非暫時性。

接受的值: false, true

--ephemeral-os-disk-placement --ephemeral-placement

僅適用於搭配 --vm-sku使用時。可讓您選擇暫時 OS 磁碟布建位置。

接受的值: CacheDisk, NvmeDisk, ResourceDisk

--exclude-extensions --security-posture-reference-exclude-extensions

--force-deletion

預覽

此屬性可讓您指定在虛擬機擴展集相應縮小時，是否必須強制刪除選擇移除的虛擬機。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

預設值: False

--ids

--instance-id

使用此標識碼更新 VM 實例。如果遺失，請更新 VMSS。

--license-type

--max-batch-instance-percent

一個批次中滾動升級同時升級的虛擬機實例總數上限百分比。預設值：20%。

--max-price

預覽

您願意支付現成 VM/VMSS 的最高價格（以美元為單位）。 -1 表示基於價格原因，不應收回 Spot VM/VMSS。

--max-surge

預覽

指定它以建立新的虛擬機來升級擴展集，而不是更新現有的虛擬機。

接受的值: false, true

--max-unhealthy-instance-percent

擴展集中可同時狀況不良之虛擬機實例總數的百分比上限。預設值：20%。

--max-unhealthy-upgraded-instance-percent

可發現處於狀況不良狀態的已升級虛擬機實例百分比上限。預設值：20%。

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

--pause-time-between-batches

完成一個批次中所有虛擬機的更新，以及開始下一個批次之間的等候時間。預設值：0 秒。

--ppg

VMSS 應該與鄰近放置群組的名稱或標識符相關聯。

--prioritize-unhealthy-instances

設定此布爾值屬性會導致擴展集中所有狀況不良的實例在任何狀況良好的實例之前升級。

接受的值: false, true

--priority

接受的值: Low, Regular, Spot

--protect-from-scale-in

保護 VM 實例免於相應縮小作業。

接受的值: false, true

--protect-from-scale-set-actions

保護 VM 實例免於擴展集動作（包括相應縮小）。

接受的值: false, true

--proxy-agent-mode

如果啟用此功能，請指定 Proxy 代理程式在上執行的模式。

接受的值: Audit, Enforce

--regular-priority-count

預覽

將在此擴展集中建立之一般優先順序 VM 的基數，因為它會相應放大。必須大於 0。

--regular-priority-percentage

預覽

達到基底一般優先順序計數之後，VM 實例的百分比預期會使用一般優先順序。必須介於 0 到 100 之間。

--remove

從清單中移除屬性或專案。範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

預設值: []

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--scale-in-policy

指定相應縮小原則（以空格分隔），決定在調整虛擬機擴展集時要移除的虛擬機。

接受的值: Default, NewestVM, OldestVM

--security-posture-id --security-posture-reference-id

安全性狀態參考標識符的格式為 /CommunityGalleries/{communityGalleryName}/securityPostures/{securityPostureName}/versions/{major.minor.patch}|{major.*}|latest。

--security-type

指定虛擬機擴展集的安全性類型。

接受的值: Standard, TrustedLaunch

--set

指定要設定的屬性路徑和值，以更新物件。範例：--set property1.property2=<value>。

預設值: []

--spot-restore-timeout

以 ISO 8601 時間持續時間表示的逾時值，之後平臺不會嘗試還原 VMSS SPOT 實例。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--terminate-notification-time

將通知傳送至實例元數據伺服器上的 VM，直到 VM 被刪除為止，時間長度（以分鐘為單位，介於 5 到 15 之間）。

--ultra-ssd-enabled

啟用或停用具有1個以上的受控數據磁碟與UltraSSD_LRS記憶體帳戶的功能。

接受的值: false, true

--upgrade-policy-mode

指定升級至擴展集中虛擬機的模式。

接受的值: Automatic, Manual, Rolling

--user-data

擴展集中虛擬機的UserData。它可以以檔案或字串的形式傳入。如果傳入空字串，將會刪除現有的值。

--v-cpus-available

指定可用的 vCPU 數目。

--v-cpus-per-core

指定 vCPU 與實體核心的比例。將此屬性設定為 1 也表示已停用超線程處理。

--vm-sku

預覽

擴展集中虛擬機實例的新大小。預設為「Standard_DS1_v2」。。如需大小資訊，請參閱 https://azure.microsoft.com/pricing/details/virtual-machines/ 。

--zones -z

要在其中布建資源的可用性區域空間分隔清單。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss update-domain-walk

編輯

手動平臺更新網域逐步解說，以更新 Service Fabric 虛擬機擴展集中的虛擬機。

az vmss update-domain-walk --platform-update-domain
                           [--ids]
                           [--placement-group-id]
                           [--resource-group]
                           [--subscription]
                           [--vmss-name]
                           [--zone]

範例

強制復原 Service Fabric 平臺更新網域逐步解說

az vmss update-domain-walk -g rg --vmss-name vmss --platform-update-domain

必要參數

--platform-update-domain

要求手動復原逐步解說的平臺更新網域。

選擇性參數

--ids

--placement-group-id

要求手動復原逐步解說的放置群組標識碼。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--vmss-name

VM 擴展集的名稱。

--zone

針對跨區域虛擬機擴展集要求手動復原逐步解說的區域。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss update-instances

編輯

升級 VMSS 內的 VM。

az vmss update-instances --instance-ids
                         --name
                         --resource-group
                         [--no-wait]

範例

升級 VMSS 內的 VM。（自動產生）

az vmss update-instances --instance-ids 1 --name MyScaleSet --resource-group MyResourceGroup

必要參數

--instance-ids

所有實體的空間分隔識別碼清單（例如：1 2 3 ...）或 * 。

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--no-wait

請勿等候長時間執行的作業完成。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az vmss wait

編輯

將 CLI 置於等候狀態，直到符合擴展集的條件為止。

az vmss wait [--created]
             [--custom]
             [--deleted]
             [--exists]
             [--ids]
             [--instance-id]
             [--interval]
             [--name]
             [--resource-group]
             [--subscription]
             [--timeout]
             [--updated]

範例

將 CLI 置於等候狀態，直到 VMSS 更新為止。

az vmss wait --updated --name MyScaleSet --resource-group MyResourceGroup

將 CLI 置於等候狀態，直到 VMSS 實例更新為止。

az vmss wait --updated --instance-id 1 --name MyScaleSet --resource-group MyResourceGroup

將 CLI 置於等候狀態，直到符合擴展集的條件為止。（自動產生）

az vmss wait --created --name MyScaleSet --resource-group MyResourceGroup

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False

--custom

等到條件符合自定義 JMESPath 查詢為止。例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False

--exists

等候資源存在。

預設值: False

--ids

--instance-id

等候具有此標識碼的 VM 實例。如果遺失，請在 VMSS 上等候。

--interval

輪詢間隔以秒為單位。

預設值: 30

--name -n

擴展集名稱。您可以使用來設定預設值 az configure --defaults vmss=<name>。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--timeout

以秒為單位的等候上限。

預設值: 3600

--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

共用方式為

az vmss

命令

az vmss create

範例

必要參數

選擇性參數

az vmss deallocate

範例

必要參數

選擇性參數

az vmss delete

選擇性參數

az vmss delete-instances

範例

必要參數

選擇性參數

az vmss get-instance-view

範例

選擇性參數

az vmss get-os-upgrade-history

必要參數

選擇性參數

az vmss list

範例

選擇性參數

az vmss list-instance-connection-info

範例

選擇性參數

az vmss list-instance-public-ips

範例

選擇性參數

az vmss list-instances

必要參數

選擇性參數

az vmss list-skus

必要參數

選擇性參數

az vmss perform-maintenance

選擇性參數

az vmss reimage

範例

選擇性參數

az vmss restart

範例

必要參數

選擇性參數

az vmss scale

範例

必要參數

選擇性參數

az vmss set-orchestration-service-state

範例

必要參數

選擇性參數

az vmss show

範例

必要參數

選擇性參數

az vmss simulate-eviction

範例

選擇性參數

az vmss start

範例

必要參數

選擇性參數

az vmss stop

範例

必要參數

選擇性參數

az vmss update

範例

選擇性參數

az vmss update-domain-walk

範例

必要參數

選擇性參數

az vmss update-instances

範例

必要參數