你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az vmss

管理 Azure 虚拟机规模集(VMSS)中的虚拟机分组。

命令

名称 说明 类型 Status
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

用于删除 run 命令的操作。

核心 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 run 命令的操作。

核心 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 规模集中现成虚拟机的逐出。

核心 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 虚拟机规模集。

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

使用默认的现有公钥从自定义映像创建 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}

在创建 VMSS 期间不支持创建具有修补程序模式“Manual”的 Windows VMSS(VMSS 创建期间不支持修补程序模式“AutomaticByPlatform”),因为无法在 VMSS 创建期间设置“AutomaticByPlatform”模式所需的运行状况扩展。

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

创建新应用程序网关(默认)或引用现有网关时要使用的名称。 还可以按 ID 引用现有应用程序网关,或为 none 指定“”。

--app-gateway-capacity

创建新应用程序网关时要使用的实例数。

默认值: 10
--app-gateway-sku

创建新的应用程序网关时,SKU。

默认值: Standard_Large
--app-gateway-subnet-address-prefix

创建 CIDR 格式的新应用程序网关时要使用的子网 IP 地址前缀。

--asgs

要与 VM 关联的现有应用程序安全组的空间分隔列表。

--assign-identity

接受由空格分隔的系统或用户分配标识。 使用“[system]”来引用系统分配的标识,或使用资源 ID 来引用用户分配的标识。 请查看有关更多示例的帮助。

--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
预览

用于分配的容量预留组的 ID 或名称。 传入“无”以取消关联容量预留组。 请注意,如果要删除已与容量预留组关联的 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

数据磁盘的磁盘加密集的名称或 ID(以空格分隔)。

--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
--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

指定是否应在虚拟机或虚拟机规模集上启用代理代理功能。

接受的值: 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 Delete 请求。

接受的值: 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

虚拟机规模集所在的专用主机组的名称或 ID。

--image

操作系统映像的名称作为 URN 别名、URN、自定义映像名称或 ID,或 VHD Blob URI。 此外,它还支持共享库映像。 请使用映像别名,包括要使用的发行版的版本。 例如:请使用 Debian11 而不是 Debian。 除非使用 --attach-os-disk. 有效的 URN 格式:“Publisher:Offer:Sku:Version”,否则此参数是必需的。 有关详细信息,请参阅 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

创建新负载均衡器(默认值)或引用现有负载均衡器时要使用的名称。 还可以按 ID 引用现有负载均衡器,或者为 none 指定“”。

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

创建新负载均衡器时要用于 NAT 规则 v2 的名称。 (NAT 规则 V2 用于替换 NAT 池)。

--lb-sku

要创建的负载均衡器的 SKU。 仅当公共 IP 为“标准”时,才支持在边缘区域创建公共 IP。

接受的值: Basic, Gateway, Standard
默认值: Standard
--license-type

指定 Windows 映像或磁盘已在本地获得许可。 若要为 Windows Server 启用Azure 混合权益,请使用“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 表示不应出于价格原因逐出现成 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

现有网络安全组的名称或 ID。

--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 磁盘的磁盘加密集的名称或 ID。

--os-disk-name

新 VM OS 磁盘的名称。

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

为用于客户托管密钥加密的机密 VM OS 磁盘和 VM 来宾 Blob 的托管磁盘指定客户托管磁盘加密集资源 ID 或名称。

--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 中手动应用修补程序。 在此模式下,自动更新处于禁用状态;参数 --enable-auto-update 必须为 false。 AutomaticByOS - 虚拟机将由 OS 自动更新。 参数 --enable-auto-update 必须为 true。 AutomaticByPlatform - 虚拟机将由 OS 自动更新。 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 应与之关联的邻近放置组的名称或 ID。

--prioritize-unhealthy-instances

设置此布尔属性将导致规模集中的所有不正常实例在任何正常实例之前升级。

接受的值: false, true
--priority

优先级。 使用“Spot”以经济高效的方式运行短期工作负荷。 将来将弃用“低”枚举。 请使用“现成”部署 Azure 现成 VM 和/或 VMSS。 默认为“常规”。

接受的值: Low, Regular, Spot
--proxy-agent-mode

指定启用该功能时代理将执行的模式。

接受的值: Audit, Enforce
--public-ip-address

创建一个(默认)或引用现有 IP 地址时公共 IP 地址的名称。 还可以使用 PowerShell 或 --% 运算符通过 ID 引用现有公共 IP,或者为“无”(“”)指定“ 。 对于使用 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

系统分配的标识将具有的角色名称或 ID。

--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

安全状况引用 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 上的目标文件路径。 如果文件已存在,则指定的键将追加到该文件中。 由于 Linux 预配代理中的已知问题,SSH 公钥的目标路径目前仅限于其默认值“/home/username/.ssh/authorized_keys”。

--ssh-key-values

SSH 公钥或公钥文件路径的空间分隔列表。

--storage-container-name

仅在与 --use-unmanaged-disk 一起使用时适用。 VM OS 磁盘的存储容器的名称。 默认值:vhd。

默认值: vhds
--storage-sku

要保留 VM 的存储帐户的 SKU。 使用将应用于所有磁盘的单一 SKU,或指定单个磁盘。 用法:[--storage-sku SKU | --storage-sku ID=SKU ID=SKU=SKU...],其中每个 ID 为“os”或 0 索引 lun。 允许的值:Standard_LRS、Premium_LRS、StandardSSD_LRS、UltraSSD_LRS、Premium_ZRS、StandardSSD_ZRS、PremiumV2_LRS。

--subnet

创建新 VNet 或引用现有 VNet 时子网的名称。 还可以按 ID 引用现有子网。 如果省略 vnet 名称和子网,将自动选择适当的 VNet 和子网,或者将创建新的 VNet 和子网。

--subnet-address-prefix

创建采用 CIDR 格式的新 VNet 时要使用的子网 IP 地址前缀。

--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

--terminate-notification-time

要发送到实例元数据服务器上的 VM 的通知(以分钟为单位,介于 5 到 15 之间),直到删除 VM。

--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 实例的域名为 vm<vm-index>.<vm-domain-name>.<..rest..>FQDN。

--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

订阅的名称或 ID。 可以使用 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

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--hibernate

从 VM 规模集休眠虚拟机。 仅适用于具有灵活 OrchestrationMode 的 VMSS。

接受的值: false, true
--instance-ids

空间分隔的 ID 列表(例如: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

订阅的名称或 ID。 可以使用 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

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--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

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

空间分隔的 ID 列表(例如:1 2 3 ...)或 * 用于所有实例。

--name -n

规模集名称。 可以使用 < a0/a0> 配置默认值 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

订阅的名称或 ID。 可以使用 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

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--instance-id

用于列出规模集中所有 VM 的实例视图的 VM 实例 ID 或“*”。

--name -n

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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 提供令牌值。

--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

订阅的名称或 ID。 可以使用 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

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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 提供令牌值。

--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

订阅的名称或 ID。 可以使用 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 提供令牌值。

--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 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

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--instance-ids

虚拟机规模集实例 ID。 省略虚拟机规模集实例 ID 将导致对虚拟机规模集中的所有虚拟机执行操作。 支持速记语法、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

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--instance-ids

VM 实例 ID 的空间分隔列表。 如果缺少,请重置所有实例的映像。

--name -n

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--no-wait

不等待长时间运行的操作完成。

默认值: False
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--instance-ids

空间分隔的 ID 列表(例如: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

订阅的名称或 ID。 可以使用 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

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--no-wait

不等待长时间运行的操作完成。

默认值: False
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--no-wait

不等待长时间运行的操作完成。

默认值: False
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--include-user-data -u

在查询结果中包含用户数据属性。

默认值: False
--instance-id

VM 实例 ID。 如果缺少,请显示 VMSS。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az vmss simulate-eviction

模拟 VM 规模集中现成虚拟机的逐出。

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

示例

模拟 VM 规模集中现成虚拟机的逐出。

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

可选参数

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--instance-id

虚拟机的实例 ID。

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

VM 规模集的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--instance-ids

空间分隔的 ID 列表(例如: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

订阅的名称或 ID。 可以使用 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

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

可选参数

--instance-ids

空间分隔的 ID 列表(例如: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

订阅的名称或 ID。 可以使用 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]

示例

更新 VMSS 的Azure 混合权益许可证类型。

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

更新 VM 实例的带宽(以 MB/秒为单位)托管磁盘。

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
预览

用于分配的容量预留组的 ID 或名称。 传入“无”以取消关联容量预留组。 请注意,如果要删除已与容量预留组关联的 VM/VMSS,则需要先取消关联容量预留组。

--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

指定是否应在虚拟机或虚拟机规模集上启用代理代理功能。

接受的值: 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 Delete 请求。

接受的值: 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

应用安全状况时要排除的虚拟机扩展列表。 可以接受 Json 字符串或文件路径。 请参阅 https://docs.microsoft.com/rest/api/compute/virtualmachinescalesets/get#virtualmachineextension 数据格式。

--force-deletion
预览

此属性允许指定在虚拟机规模集进行缩减时是否必须强制删除为删除而选择的虚拟机。

--force-string

使用“set”或“add”时,保留字符串文本,而不是尝试转换为 JSON。

默认值: False
--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--instance-id

使用此 ID 更新 VM 实例。 如果缺少,请更新 VMSS。

--license-type

指定 Windows 映像或磁盘已在本地获得许可。 若要为 Windows Server 启用Azure 混合权益,请使用“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
--max-batch-instance-percent

一批滚动升级同时升级的总虚拟机实例的最大百分比。 默认值:20%。

--max-price
预览

你愿意支付现成 VM/VMSS 的最高价格(以美元为单位)。 -1 表示不应出于价格原因逐出现成 VM/VMSS。

--max-surge
预览

指定它以创建新的虚拟机来升级规模集,而不是更新现有虚拟机。

接受的值: false, true
--max-unhealthy-instance-percent

规模集中虚拟机实例总数的最大百分比,可以同时运行不正常。 默认值:20%。

--max-unhealthy-upgraded-instance-percent

可发现处于不正常状态的已升级虚拟机实例的最大百分比。 默认值:20%。

--name -n

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--no-wait

不等待长时间运行的操作完成。

默认值: False
--pause-time-between-batches

完成一批中所有虚拟机的更新和开始下一批之间的等待时间。 默认值:0 秒。

--ppg

VMSS 应与之关联的邻近放置组的名称或 ID。

--prioritize-unhealthy-instances

设置此布尔属性将导致规模集中的所有不正常实例在任何正常实例之前升级。

接受的值: false, true
--priority

优先级。 使用“Spot”以经济高效的方式运行短期工作负荷。 将来将弃用“低”枚举。 请使用“现成”部署 Azure 现成 VM 和/或 VMSS。 默认为“常规”。

接受的值: Low, Regular, Spot
--protect-from-scale-in

保护 VM 实例免受横向扩展操作的阻止。

接受的值: false, true
--protect-from-scale-set-actions

保护 VM 实例免受规模集操作(包括横向缩减)的保护。

接受的值: false, true
--proxy-agent-mode

指定启用该功能时代理将执行的模式。

接受的值: Audit, Enforce
--regular-priority-count
预览

将在横向扩展时在此规模集中创建的常规优先级 VM 的基数。必须大于 0。

--regular-priority-percentage
预览

达到基本常规优先级计数后,VM 实例的百分比应使用常规优先级。 必须介于 0 和 100 之间。

--remove

从列表中删除属性或元素。 示例: --remove property.list <indexToRemove> OR --remove propertyToRemove.

默认值: []
--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--scale-in-policy

指定缩放策略(以空格分隔),该策略决定在缩放虚拟机规模集时选择要删除的虚拟机。

接受的值: Default, NewestVM, OldestVM
--security-posture-id --security-posture-reference-id

安全状况引用 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--terminate-notification-time

要发送到实例元数据服务器上的 VM 的通知(以分钟为单位,介于 5 到 15 之间),直到删除 VM。

--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

订阅的名称或 ID。 可以使用 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

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--placement-group-id

为其请求手动恢复演练的放置组 ID。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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

空间分隔的 ID 列表(例如:1 2 3 ...)或 * 用于所有实例。

--name -n

规模集名称。 可以使用 < a0/a0> 配置默认值 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

订阅的名称或 ID。 可以使用 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

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--instance-id

等待具有此 ID 的 VM 实例。 如果缺少,请在 VMSS 上等待。

--interval

轮询间隔(以秒为单位)。

默认值: 30
--name -n

规模集名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults vmss=<name>

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。