Package: azure-cli-vm
Microsoft Azure CLI ‘vm’ Command ModuleThis package is for the ‘vm’ module.
i.e. ‘az vm’Release History2.2.23[New Command Group]. image template: added image builder support viaimage template. These commands are in preview.2.2.22vm create: can now create a vm from a managed image with data-disk luns that do not start from 0 or that skip numbers.
Does not assume data-disk lun from the number of data disks in source managed image.2.2.21vm create: Added –computer-name for setting a vm’s computer name.vm/vmss create:–ssh-key-valuerenamed to–ssh-key-valuesand can now accept multiple ssh public key values or paths.
Note: this isnota breaking change.–ssh-key-valuewill be parsed correctly as it matches only–ssh-key-valuesppg create:–type, the proximity placement group type, is now optional.2.2.20vmss update: add–protect-from-scale-inand–protect-from-scale-set-actionsto enable updates to the protection policy of VMSS VM instances.vmss update: add–instance-idto enable generic update of VMSS VM instances.vmss wait: add–instance-id.[new command group] ppg: addppg create / delete / list / show / updatefor managing Proximity Placement Groups.ppg: add–ppgtovm create,vmss createandvm availability-set createimage create: expose–hyper-v-generationparameter.2.2.19vm/vmss stop: expose –skip-shutdown. If used, the VM will be powered-off without shutting down. This is helpful if a VM crashes and/or cannot properly shutdown.sig image-version create: expose –storage-account-type. Can now set the publishing profile’s general storage account type to Standard_LRS or Standard_ZRSsig image-version create: –target-regions updated to allow for setting region-specific storage account types2.2.18Minor fixes2.2.17Addedimage updatecommand.2.2.16vm create: Fixed issue where –accelerated-networking was not enabled by default for Ubuntu 18.0.2.2.15vm list-skus: Allow use of–allin place of–all trueAddvmss run-command [invoke / list / show]vmss encryption enable: Fixed bug where command fails if it was ran previously.Movingaz identitycommand tree toazure-cli-role.2.2.14Minor fixes2.2.13vm encryption enable: now validates –disk encryption keyvault and that key encryption keyvault exists, in line withvmss encryption enable. Exposes –force. For more info: see issues #8111 and #81102.2.12‘vm disk/unmanaged-disk’ and ‘vmss disk’: parameter options are more consistent.vm/vmss create: support cross tenant image referencing.vm diagnostics get-default-config –windows-os: fix bug in windows os default config.vmss extension set: expose–provision-after-extensions. It defines what extensions must be provisioned before the extension being set.sig image-version update: expose –replica-count for setting the default replication count.2.2.11disk create: expose –os-type parameter.image create –source: fixed bug where source os disk is mistaken for a VM with the same name, even if the full resource ID is provided.2.2.10vm identity remove: does not crash if the specified vm has no assigned managed service identities.2.2.9vm extension show / wait: deprecated –expand parameter.vm restart: Added–forcewhich redeploys unresponsive VMs.vm/vmss create:–authentication-typenow accepts/infers “all” to create a VM with both password and ssh authentication.image create: Added–os-disk-cachingparameter to set os disk caching for an image.2.2.8vm/vmss create –storage-sku: can now specify the storage account sku for managed os and data disks separately.sig image-version: Version names now consistently specified by–image-version -e.–image-version-namedeprecated.vm/vmss create –ephemeral-os-disk: exposed parameter to create a vm/vmss with a local os disk.snapshot create/update: Added support for–no-wait.snapshot: Addedwaitcommand.vm/vmss extension set –extension-instance-name: can now specify the instance name of an extension.2.2.7image create: expose storage-sku argument for setting the image’s default storage account typevm resize: fix bug where–no-waitoption causes command to crashvm encryption show: table output format shows statusvm secret format: requires json/jsonc output. Warns user and defaults to json output if an undesired output format is selected.vm create –image: improved validation of image argument2.2.6vm/vmss create: enforce disk caching mode beNonefor Lv/Lv2 series of machinesvm create: update supported size list supporting networking acceleratordisk update: expose strong typed arguments for ultrassd iops and mbps configs2.2.5Fix SDK issue that caused Homebrew installation to fail.2.2.4az disk grant-access: fix the empty “accessSas” fieldvmss create: reserve large enough frontend port range to handle overprovisioningaz sig: fix update commands, support –no-wait on managing image versionsvm list-ip-addresses: now shows availability zone of public IP addresses.az vmvmss disk attach: default disk’s lun to the first available spot2.2.3support shared image gallery throughaz sig.2.2.2vm/vmss identity show: exception handling to exit with code 3 upon a missing resource for consistencyvm create: deprecate–storage-cachingoption.2.2.1vm list-skus: add a few common filters to make the command easier to use2.2.0availability set: support list by subscriptionvm/vmss: support StandardSSD_LRSvm/vmss: support application security group on creating VM scale setBREAKING CHANGE:vm/vmss create,vm/vmss identity assign/removewill outputuser assigned identitiesin dictionary formatConsuming multi api azure.mgmt.authorization package for azure stack support2.1.0BREAKING CHANGE: updatevmss createto useStandard_DS1_v2as the default instance sizeBREAKING CHANGE: ‘show’ commands log error message and fail with exit code of 3 upon a missing resource.vm/vmss extension set/delete: Added–no-waitsupport.Addedvm extension wait.2.0.35msi: support removing system assigned identity2.0.34vm create: refine vm size check for accelerated networking supportvmss create: warn about the default vm size will be switched from “Standard_D1_v2” to “Standard_DS1_v2”vm/vmss extension set: Expose–force-updateflag to update the extension even when the configuration has not changed.2.0.33vm list-skus: make sure we have fixed columns; warn aboutTierand “Size” columns will be removedvm create: support–accelerated-networkingvm/vmss extension image list: absorb 404 when an image type is not foundidentity create: support–tags2.0.32BREAKING CHANGE: remove–write-acceleratorfromvm create. The same supportcan be accessed throughvm updateorvm disk attachvm/vmss extension: fix an incorrect extension image matching logicvm create: expose–boot-diagnostics-storageto capture boot logvm/vmss update: expose–license-typevm/vmss: use PATCH for updating identities2.0.31vm: fix an invalid detection logic on unmanaged blob urivm: support disk encryption w/o user provided service principalsBREAKING CHANGE: do not use VM ‘ManagedIdentityExtension’ for MSI supportvmss: support eviction policyBREAKING CHANGE: remove erroneous argument ofidsfromvm extension list,vm secret list,vm unmanaged-disk listandvmss nic listvm: support write acceleratorvmss: exposeaz vmss perform-maintenancevm diagnostics set: detect VM’s OS type reliablyvm resize: check if the requested size is different than currently set and update only on change2.0.30vmss create: support to configure platform fault domain countvmss create: default to Standard LB for zonal, large or single-placement-group disabled scale-setBREAKING CHANGE:vm assign-identity,vm remove-identity: Deprecated commands have been removed.BREAKING CHANGE:vm format-secret: Deprecated command has been removed.vm create: support configure Public-IP skuvm create: support configure Public-IP SKUvm secret format: Added extra validation. Added–keyvaultand–resource-groupto support scenarioswhere the command is unable to resolve the vault ID. [#5718](https://github.com/Azure/azure-cli/issues/5718)vm/vmss create: emit out a better error if resource group’s location has no zone supportsdistis now compatible with wheel 0.31.02.0.29vmss create: warn on upcoming breaking changes on default balancer for scaleset with 100+ instancesvm snapshot/image: support zone resilientvmss: report better encryption status through disk instance viewBC:az vm extension deleteno longer returns output as expected for adeletecommand.2.0.28vm/vmss create: support to attach unmanaged data disks and configure their caching modesvm/vmss: author managed identity commandsidentity assign/remove/show, and deprecateassign-identity/remove-identityvmss create: default priority to NoneSupport Autorest 3.0 based SDKs2.0.27vmss instance update: support attach/detach disks on an individual instanceSupport Autorest 3.0 based SDKs2.0.26vm encryption: avoid the crash when vm encryption setting might not be fully initializedmsi: output principal id on enabling system assigned identityvm boot-diagnostic: fix the broken get log command2.0.25vm image: support accept market terms to use vm imagesvm/vmss create: ensure commands can run under proxy with unsigned certificates.vmss:(PREVIEW) support low priorityvm/vmss create-–admin-passwordupdated to type secureString.2.0.24vmss:(PREVIEW) cross zone supportvmss:(BREAKING CHANGE)single zone scale-set will default to “Standard” load balancer instead of “Basic”vm/vmss: use right term of “userAssignedIdentity” for EMSIvm: (PREVIEW) support os disk swapvm: support use image from other subscriptions2.0.23vmss: ensure app-gateway has a name when defaults to it for large scalesets2.0.22VM/VMSS: (Preview) support user assigned identity2.0.21Minor fixes2.0.20Minor fixes2.0.19show zone information onaz vm list-skus -otableUpdate the storage multiapi package reference2.0.18vmss create: fix a bug that blocks using Basic tier of VM sizesvm/vmss create: exposeplanarguments for using custom images with billing informationsvm : supportvm secret add/remove/listvm :vm format-secretis copied tovm secret format. The old one will be removed in futureMinor fixes.2.0.17vm encryption enable: expose ‘–encrypt-format’vmss create: expose ‘–accelerated-networking’2.0.16 (2017-10-09)vm show: fix a bug when using ‘-d’ crashes on missing private ip addressesvmss create: (PREVIEW) support rolling upgradevm encryption enable: allow updating encryption settings by rerunning the commandvm create: expose –os-disk-size-gbvmss create: expose –license-type for windows os2.0.15 (2017-09-22)vm/vmss/disk create: support availability zonevmss create: Fixed issue where supplying–app-gateway IDwould fail.vm create: Added–asgssupport.vm run-command: support to run commands on remote VMsvmss encryption: (PREVIEW) support vmss disk encryptionsvm perform-maintenance: support to perform maintenance on a vm2.0.14 (2017-09-11)msi: don’t assign access unless–scopeis providedmsi: use the same extension naming as portal doesmsi: remove the uselesssubscriptionfrom thevm/vmss createcommands outputvm/vmss create: fix a bug that the storage sku is not applied on data disks coming with an imagevm format-secret: Fix issue where–secretswould not accept newline-separated IDs.2.0.13 (2017-08-28)vmss get-instance-view: Fix issue where extra, erroneous information was displayed when using–instance-id *vmss create: Added support for–lb-skuvm/vmss create: remove human names from the admin name blacklistvm/vmss create: fix issue where the command would throw an error if unable to extract plan information from an image.vmss create: fix a crash when create a scaleset with an internal LBvm availability-set create: Fix issue where –no-wait argument did not work.2.0.12 (2017-08-11)availability-set: expose fault domain count on convertvm: expose ‘az vm list-skus’ commandvm/vmss: support to assign identity w/o creating role assignmentsvm: apply storage sku on attaching data disksvm: remove default os-disk name and storage SKU when using managed disks.2.0.11 (2017-07-27)vmss: support configuring nsgvmss: fix a bug that dns server is not configured right.vm/vmss: support managed service identityvmss create: Fix issue where creating with existing load balancer required–backend-pool-name.vm image create: make datadisk’s lun start with 02.0.10 (2017-07-07)vm/vmss: use newer api-version of “2017-03-30”BC: ‘sku.managed’ is removed from ‘az vm availability-set show’ (use sku.name instead)vmss create: add arguments–app-gateway-capacityand–app-gateway-sku.vm/vmss create: if –admin-password is specified for Linux images, automatically will change from SSH authentication
to password without needing–authentication-type passwordexplicitly.vm/vmss create: added information statements that can be shown using –debugvm/vmss create: added client-side validation where certain parameters were previously just ignored.vmss create: support public ip per instance, instance custom domain name, custom dns servers2.0.9 (2017-06-21)vm/vmss: lower thread number used for ‘vm image list –all’ to avoid exceeding the OS opened file limitsdiagnostics: Fix a typo in default Linux Diagnostic extension configvmss create: fix failure when running with –use-unmanaged-disk2.0.8 (2017-06-13)vm: support attaching data disks on vm create (#3644)Improve table output for vm/vmss commands: get-instance-view, list, show, list-usage, etcsupport configuring disk caching on attaching a managed disk (#3513)Support attaching existing data disks on vm createVM/VMSS: fixed an issue with name generation that resulted in the create commands not being idempotent.2.0.7 (2017-05-09)diagnostics: Fix incorrect Linux diagnostics default config with update for LAD v.3.0 extensiondisk: support cross subscription blob importdisk: add –no-wait flag to disk create, update, and delete.disk: addaz disk waitcommand.BC: disk: add confirmation prompt toaz disk delete.vm: support license type on createBC: vm open-port: command always returns the NSG. Previously it returned the NIC or Subnet.vm: fix “vm extension list” crash if the VM has no extensionsvmss: update arg description for ‘vmss delete-instances –instance-ids’vmss: hide arg ‘vmss show –ids’, which is not supposed to work because of ‘instance-id’ argBC: vmss list-instance-connection-info: include instance IDs in the outputvm/vmss diagnostics: provide protected settings samples, handle extension major version upgrade, etc.disk/snapshot/image: expose ‘–tags’ in the create commandvmss: provides default for ‘–app-gateway-subnet-address-prefix’ when creating a new vnetvm: support configuring disk caching on attaching a managed disk2.0.6 (2017-05-09)Minor fixes.2.0.5 (2017-05-05)avail-set: make UD&FD domain counts optionalnote: VM commands in sovereign clouds
Please avoid managed disk related features, including the following:
1.       az disk/snapshot/image
2.       az vm/vmss disk
3.       Inside “az vm/vmss create”, use “—use-unmanaged-disk” to avoid managed disk
Other commands should work2.0.4 (2017-04-28)vm/vmss: improve the warning text when generates ssh key pairs2.0.3 (2017-04-17)vm/vmss: support create from a market place image which requires plan info(#1209)Fix bug withvmss updateandvm availability-set update2.0.2 (2017-04-03)vmss: bug fixes on ip address handling (#2683)Fix #2641 (#2670)Update storage dependencies (#2654)vm: fix the bug that missing fallback default using ‘next’ (#2624)[Compute] Add AppGateway support to VMSS create (#2570)[VM/VMSS] Improved disk caching support (#2522)VM/VMSS: incorporate credentials validation logic used by portal (#2537)Add wait commands and –no-wait support (#2524)vm: fix distro check mechanism used by disk encryption (#2511)fixed typo in help text (#2519)[KeyVault] Command fixes (#2474)vm: catch more general exception on querying encryption extension status (#2498)2.0.1 (2017-03-13)vmss: support * to list instance view across vms (#2467)core: support setting default values for common arguments like default resource group, default web, default vm (#2414)no dynamic completion on vm create name (#2451)VM/VMSS: reuse existing extension instance name on update (#2395)Fix bug in vm show. (#2415)Add –secrets for VM and VMSS (#2212)Allow VM creation with specialized VHD (#2256)vm/vmss: move generate_ssh_keys to ‘Authentication’ group (#2296)2.0.0 (2017-02-27)GA releaseFix vmss list-instance-connection-info namingSnapshot description update0.1.2rc2 (2017-02-22)VM: fix a casing issue on check os type (#2208)Rev compute package to 0.33.rc1 for new API version (#2136)Change default VM size to Standard_DS1_v2. (#2181)Fix VM names in documentation. (#2183)0.1.2rc1 (2017-02-17)vm/disk: fix bugs in detach (#2138)Show commands return empty string with exit code 0 for 404 responses (#2117)Disk encryption: Enable/Disable/Show (#2113)vm image: do not normalize casing on blob uri (#2126)vm/av-set: remove domain count defaults (#2111)Move acs commands from vm to acs module (#2098)Fix broken name or ids logic in VM/VMSS Create (#2091)VM list: avoid add None mac addresss (#2059)Use same defaults like portal (#2055)VM: command renaming on ‘access’ related command (#2053)Add –custom-data to VM and VMSS create (#2035)Improve the default logic on the subnets (#2000)Prompts for yes / no use the -y option rather than –force0.1.1b3 (2017-02-08)VM/VMSS: Managed Disk SupportEnhance vm open-port command with –port and –priority parameters.0.1.1b2 (2017-01-30)VM: generate ssh key file if needed (#1842)New VM/VMSS Create (#1849)Fix vm doc bug #621, #519 (#1839)Add path expansion to file type parameters (#1827)Expose flags to show vm ip-address, power state (#1820)[ACS] Add validation for SSH key format (#1699)Add confirmation prompt to ‘vm delete’.Support Python 3.6.0.1.1b1 (2017-01-17)Enable Multi-Cloud VM/VMSS Create.[ACS] Add a table transform for acs show to match acs list.Fix: az vm boot-diagnostics get-boot-log key1 -> keys[0].value.0.1.0b11 (2016-12-12)Preview release.