az vmss update
Update a VMSS. Azure CLI reference
75 options Its page in the Azure CLI reference
Options
Show its 75 options
--add-proxy-agent-extension, --add-proxy-agent-extSpecify whether to implicitly install the ProxyAgent Extension.--additional-scheduled-events, --additional-eventsThe configuration parameter used while creating event grid and resource graph scheduled event setting.--automatic-repairs-actionType of repair action that will be used for repairing unhealthy virtual machines in the scale set.--automatic-repairs-grace-periodThe amount of time (in minutes, between 30 and 90) for which automatic repairs are suspended due to a state change on VM.--automatic-zone-balancing-behavior, --balancing-behaviorType of rebalance behavior that will be used for recreating virtualmachines in the scale set across availability zones.--automatic-zone-balancing-strategy, --balancing-strategyType of rebalance strategy that will be used for rebalancing virtualmachines in the scale set across availability zones.--capacity-reservation-group, --crgThe ID or name of the capacity reservation group that is used to allocate.--custom-dataCustom init script file or text (cloud-init, cloud-config, etc..)--disable-capacity-reservation-assignment, --no-cap-reservationSpecifies whether the virtual machine scale set is explicitly opted out from being associated with any capacity reservation.--disk-controller-typeSpecify the disk controller type configured for the VM or VMSS.--enable-all-instance-down, --all-instance-downSpecifies if Scheduled Events should be auto-approved when all instances are down.--enable-auto-os-upgradeIndicate whether OS upgrades should automatically be applied to scale set instances in a rolling fashion when a newer version of the OS image becomes available.--enable-automatic-repairsEnable automatic repairs--enable-automatic-zone-balancing, --enable-zone-balancingSpecify whether automatic AZ balancing should be enabled on the virtualmachine scale set.--enable-cross-zone-upgradeSet this Boolean property will allow VMSS to ignore AZ boundaries when constructing upgrade batches, and only consider Update Domain and maxBatchInstancePercent to determine the batch size--enable-hibernationThe flag that enable or disable hibernation capability on the VMSS.--enable-osimage-notificationSpecify whether the OS Image Scheduled event is enabled or disabled.--enable-proxy-agentSpecify whether metadata security protoco (proxy agent) feature should be enabled on the virtual machine or virtual machine scale set.--enable-resilient-creationAutomatically recover customers from OS Provisioning Timeout and VM Start Timeout errors experienced during a VM Create operation by deleting and recreating the affected VM.--enable-resilient-deletionRetry VM Delete requests asynchronously in the event of a failed delete operation.--enable-secure-bootEnable secure boot.--enable-spot-restoreEnable the Spot-Try-Restore feature where evicted VMSS SPOT instances will be tried to be restored opportunistically based on capacity availability and pricing constraints--enable-terminate-notificationEnable terminate notification--enable-user-reboot-scheduled-events, --enable-rebootThe configuration parameter used while publishing scheduled events additional publishing targets.--enable-user-redeploy-scheduled-events, --enable-redeployThe configuration parameter used while creating user initiated redeploy scheduled event setting creation.--enable-vtpmEnable vTPM.--ephemeral-os-disk-option, --ephemeral-optionSpecify the ephemeral disk settings for operating system disk.--ephemeral-os-disk-placement, --ephemeral-placementOnly applicable when used with --vm-sku.--ephemeral-os-diskAllow you to specify the ephemeral disk settings for the operating system disk.--exclude-zonesSpecify a list of availability zones that must be excluded from placement when --zone-placement-policy is set to Auto.--force-deletionThis property allow you to specify if virtual machines chosen for removal have to be force deleted when a virtual machine scale set is being scaled-in.--imds-access-control-profile-reference-id, --imds-profile-idSpecify the access control profile version resource id resource id of imds.--include-zonesSpecify a list of availability zones that must be considered for placement when --zone-placement-policy is set to Auto.--instance-idUpdate the VM instance with this ID.--instance-percent-policy, --ippSpecify whether maximum percentage of virtual machine instances per zone policy should be enabled on the virtual machine scale set.--license-typeSpecifies that the Windows image or disk was licensed on-premises.--max-batch-instance-percentThe maximum percent of total virtual machine instances that will be upgraded simultaneously by the rolling upgrade in one batch.--max-priceThe maximum price (in US Dollars) you are willing to pay for a Spot VM/VMSS.--max-surgeSpecify it to create new virtual machines to upgrade the scale set, rather than updating the existing virtual machines.--max-unhealthy-instance-percentThe maximum percentage of the total virtual machine instances in the scale set that can be simultaneously unhealthy.--max-unhealthy-upgraded-instance-percentThe maximum percentage of upgraded virtual machine instances that can be found to be in an unhealthy state.--max-zone-countSpecify the maximum number of availability zones to use for this scale set.--pause-time-between-batchesThe wait time between completing the update for all virtual machines in one batch and starting the next batch.--ppgThe name or ID of the proximity placement group the VMSS should be associated with.--prioritize-unhealthy-instancesSet this Boolean property will lead to all unhealthy instances in a scale set getting upgraded before any healthy instances--priorityPriority.--processor-modeSpecifies the processor mode for the virtual machine or virtual machine scale set.--protect-from-scale-inProtect the VM instance from scale-in operations.--protect-from-scale-set-actionsProtect the VM instance from scale set actions (including scale-in).--proxy-agent-mode, --wire-server-mode, --imds-modeSpecify the mode that proxy agent will execute on if the feature is enabled.--regular-priority-countThe base number of regular priority VMs that will be created in this scale set as it scales out.--regular-priority-percentageThe percentage of VM instances, after the base regular priority count has been reached, that are expected to use regular priority.--scale-in-policySpecify the scale-in policy (space delimited) that decides which virtual machines are chosen for removal when a Virtual Machine Scale Set is scaled-in.--scheduled-events-api-version, --se-api-versionSpecifies the api-version to determine which Scheduled Events configuration schema version will be delivered.--security-posture-reference-exclude-extensions, --exclude-extensionsList of virtual machine extensions to exclude when applying the Security Posture.--security-posture-reference-id, --security-posture-idThe security posture reference id in the form of /CommunityGalleries/{communityGalleryName}/securityPostures/{securityPostureName}/versions/{major.minor.patch}|{major.*}|latest--security-posture-reference-is-overridable, --is-overridableWhether the security posture can be overridden by the user.--security-typeSpecify the security type of the virtual machine scale set.--skuprofile-allocation-strategy, --sku-allocat-stratAllocation strategy for vm sizes in SKU profile.--skuprofile-rankA list for ranks associated with the SKU profile vm sizes.--skuprofile-vmsizesA list of VM sizes in the scale set.--spot-restore-timeoutTimeout value expressed as an ISO 8601 time duration after which the platform will not try to restore the VMSS SPOT instances--terminate-notification-timeLength of time (in minutes, between 5 and 15) a notification to be sent to the VM on the instance metadata server till the VM gets deleted--ultra-ssd-enabledEnables or disables the capability to have 1 or more managed data disks with UltraSSD_LRS storage account--upgrade-policy-modeSpecify the mode of an upgrade to virtual machines in the scale set.--user-dataUserData for the virtual machines in the scale set.--v-cpus-availableSpecify the number of vCPUs available--v-cpus-per-coreSpecify the ratio of vCPU to physical core.--value-max-instance-percent-per-zone, --max-instance-percentSpecify the maximum percentage of virtual machine instances that can be allocated to a single availability zone in the virtual machine scale set.--vm-skuThe new size of the virtual machine instances in the scale set.--wire-server-access-control-profile-reference-id, --wire-server-profile-idSpecify the access control profile version resource id of wire server.--wire-server-use-local-file-rules, --wire-local-rulesWhen set to true, instructs the GuestProxyAgent inside the VM to load additional access control rules defined in a local file on the VM.--zone-balanceWhether to force strictly even Virtual Machine distribution cross x-zones in case there is zone outage.--zone-placement-policySpecify the policy for availability zone placement of the virtual machine scale set.--zones, -zSpace-separated list of availability zones into which to provision the resource.