diff --git a/docs-ref-conceptual/includes/current-version.md b/docs-ref-conceptual/includes/current-version.md index 85e2896bb2..64a3a1a056 100644 --- a/docs-ref-conceptual/includes/current-version.md +++ b/docs-ref-conceptual/includes/current-version.md @@ -2,8 +2,8 @@ author: dbradish-microsoft ms.author: dbradish manager: barbkess -ms.date: 10/29/2021 +ms.date: 11/02/2021 ms.topic: include --- -The current version of the Azure CLI is __2.29.2__. For information about the latest release, see the [release notes](../release-notes-azure-cli.md). To find your installed version and see if you need to update, run [az version](/cli/azure/reference-index#az_version). +The current version of the Azure CLI is __2.30.0__. For information about the latest release, see the [release notes](../release-notes-azure-cli.md). To find your installed version and see if you need to update, run [az version](/cli/azure/reference-index#az_version). diff --git a/docs-ref-conceptual/release-notes-azure-cli.md b/docs-ref-conceptual/release-notes-azure-cli.md index f3dbe18267..6ca069b1ad 100644 --- a/docs-ref-conceptual/release-notes-azure-cli.md +++ b/docs-ref-conceptual/release-notes-azure-cli.md @@ -4,7 +4,7 @@ description: Learn about the latest Azure Command-Line Interface (CLI) release n author: dbradish-microsoft ms.author: dbradish manager: barbkess -ms.date: 10/29/2021 +ms.date: 11/02/2021 ms.topic: article ms.service: azure-cli ms.devlang: azurecli @@ -16,6 +16,136 @@ keywords: azure cli updates, azure cli notes, azure cli versions # [Current release notes](#tab/azure-cli) +## November 02, 2021 + +Version 2.30.0 + +### ACR + +* [BREAKING CHANGE] `az connected-registry`: `--repository` flag short version `-t` is being removed. +* [BREAKING CHANGE] `az connected-registry install renew credentials`: Now it requires the user to confirm password generation. +* `az connected-registry install`: Deprecate and redirect to `az acr connected-registry get-settings`. +* `az connected-registry repo`: Deprecate and redirect to `az acr connected-registry permissions update`. +* `az connected-registry permissions show`: A new command that allows the user to see the sync scope map information. +* `az connected-registry get-settings`: A new command that retrieves the necessary information to install a connected registry and allows the generation of a new sync token password. +* `az connected-registry create`: No longer adds a postfix to the sync token and scope map name. + +### AKS + +* `az aks create/update`: Add new parameter `--aks-custom-headers` to support for custom headers +* `az aks create`: Support setting `--private-dns-zone` to none for private cluster creation +* `az aks create/update`: Add new parameter `--enable-secret-rotation` and `--rotation-poll-interval` to support secret rotation +* `az aks enable-addons`: Add new parameter `--enable-secret-rotation` and `--rotation-poll-interval` to support secret rotation + +### App Config + +* `az appconfig kv import/export`: Add new parameter `--profile` to support using `appconfig/kvset` profile + +### App Service + +* Fix #19617: `az webapp ssh`: Open Web SSH on the specified instance +* `az staticwebapp hostname`: Support adding static webapp hostname via TXT validation +* Enable support for PowerShell on Linux function apps with V4 + +### ARM + +* `az bicep publish`: Add new command to publish bicep modules + +### ARO + +* `az aro create`: Remove Identifier URIs + +### Compute + +* `az disk update`: Fix the problem that updating network access policy to `AllowPrivate` failed +* `az vm update`: Add `--host` argument and `--host-group` argument to support assign an existing VM to a specific ADH +* Fix #19599: `az vm create`: Fix the issue that `--nic-delete-option` not working when no `--nics` is provided. +* `az snapshot create`: Support copyStart as createOption +* `az vmss create/update`: Support in-guest patching for VMSS +* `az vm application set/list`: Add new commands to support VM application +* `az vmss application set/list`: Add new commands to support VMSS application +* `az vm create`: Add `--ephemeral-os-disk-placement` argument to support choosing the Ephemeral OS disk provisioning location +* `az vmss create`: Add `--ephemeral-os-disk-placement` argument to support choosing the Ephemeral OS disk provisioning location +* `az vm update`: Add `--size` argument to support the resize +* `az vmss update`: Add `--vm-sku` argument to support the resize +* `az vm run-command`: Add new commands to support managing the running commands in VM +* `az vm update`: Add `--ephemeral-os-disk-placement` argument to support choose the Ephemeral OS disk provisioning location +* `az vmss update`: Add `--ephemeral-os-disk-placement` argument to support choose the Ephemeral OS disk provisioning location +* `az sig gallery-application`: Add new commands to support managing gallery application +* `az sig gallery-application version`: Add new commands to support managing gallery application version +* GA the features related to Flex VMSS + +### Container + +* `az container create`: Add parameter `--zone` to support Availability Zone selection +* `az container create`: Fix the issue that `--subnet` or `--vnet` cannot be used with IP address type `Public` to allow `Private` +* `az container create`: Add Support for `--registry-login-server` to work with `--acr-identity` + +### Cosmos DB + +* `az cosmosdb mongodb retrieve-latest-backup-time`: Add new command for fetching latest restorable timestamp for Mongo Account. +* `az cosmosdb locations`: Add new commands for listing account locations and their properties. +* `az managed-cassandra cluster/data-center`: GA support for managed cassandra cluster and data center + +### DMS + +* `az dms project create/az dms project task create` : Add MySQL projects/tasks for offline migrations. + +### FunctionApp + +* [BREAKING CHANGE] `az functionapp devops-pipeline`: Remove commands and move them to `functionapp` extension + +### HDInsight + +* `az hdinsight create`: Add two parameters `--zones` and `--private-link-configurations` to support creating cluster with availability zones feature and creating private link enabled cluster with private link configurations feature. + +### Key Vault + +* Support Keyvault SKR +* `az keyvault key random`: Request some random bytes from managedHSM +* `az keyvault rotation-policy/key rotate`: Support rotate key and manage key rotation policy +* `az keyvault create/update`: Add `--public-network-access` parameter + +### Monitor + +* `az monitor metrics alert condition` : Add support for 'skip metric validation' + +### NetAppFiles + +* [BREAKING CHANGE] `az netappfiles account backup-policy create/update`: Remove optional parameter `--yearly-backups`. +* `az netappfiles account list`: Add option to skip `--resource-group` parameter and fetch accounts for subscription. +* `az netappfiles pool create`: Add optional parameter named `--encryption-type` +* `az netappfiles volume create`: Add optional parameters: `--network-features`, `--avs-data-store`, `--default-group-quota`, `--default-user-quota`, `--is-def-quota-enabled` +* `az netappfiles volume update`: Add optional parameters: `--default-group-quota`, `--default-user-quota`, `--is-def-quota-enabled` + +### Network + +* `az network bastion create`: Add new parameter `--scale-units` and `--sku` to support setting scale unit +* `az network vnet`: Add parameter `--bgp-community` +* `az network private-endpoint-connection`: Support "Microsoft.Cache/Redis" +* `az network private-endpoint-connection`: Support "Microsoft.SignalRService/WebPubSub" + +### RDBMS + +* Introduce MySQL georestore command and update validators +* GA `az mysql flexible-server` + +### Service Bus + +* Fix MU capacity to include 16 when updating namespace + +### ServiceConnector + +* `az webapp/spring-cloud connection`: New command group to support service to service connection + +### SQL + +* `az sql server ad-admin`: Fix breaking change made to update and delete + +### Synapse + +* `az synapse kusto`: Add Kusto pool(mgmt) support + ## October 29, 2021 Version 2.29.2 @@ -69,7 +199,7 @@ Version 2.29.0 * `az backup`: Add CRR functionality for Azure Workload * `az backup`: Add support for MAB backup management type in some sub commands -### Compute +### Compute * `az sig create/update`: Add new parameter `--soft-delete` to support soft delete * `az sig image-version`: Add new parameter `--replication-mode` to support setting replication mode @@ -150,7 +280,7 @@ Version 2.29.0 ### Synapse -* [BREAKING CHANGE] `az synapse sql/pool audit-policy update`: Add parameter `blob-storage-target-state`, `log-analytics-target-state`, `event-hub-target-state` (at least choose one of these 3 paras) +* [BREAKING CHANGE] `az synapse sql/pool audit-policy update`: Add parameter `blob-storage-target-state`, `log-analytics-target-state`, `event-hub-target-state` (at least choose one of these 3 paras) * `az synapse integration-runtime`: Support start/stop integration-runtime * `az synapse trigger`: Add az synapse trigger wait * `az synapse trigger-run`: Add az synapse trigger-run cancel @@ -377,7 +507,7 @@ Version 2.27.0 * `az cdn endpoint rule`: Add OriginGroupOverride action support -### Compute +### Compute * `az sig image-version create`: Support mixing disks, snapshots, and vhd * `az vmss update`: Upgrade package version to fix securityProfile issue @@ -555,7 +685,7 @@ Workload container registration fix, SDK upgraded to 0.12.0, Fixed and Re-ran te * `az cognitiveservices account`: Add list-deleted, show-deleted, recover, purge commands -### Compute +### Compute * `az sig create/update`: Add --permissions to specify the permission of sharing gallery. * `az sig share`: Manage gallery sharing profile. @@ -3889,8 +4019,8 @@ Version 2.0.77 ### AppConfig * Added support for using ":" for `as az appconfig kv import` separator -* Fixed issue for listing key values with multiple labels including null label. -* Updated management plane sdk, azure-mgmt-appconfiguration, to version 0.3.0. +* Fixed issue for listing key values with multiple labels including null label. +* Updated management plane sdk, azure-mgmt-appconfiguration, to version 0.3.0. ### AppService @@ -4507,8 +4637,8 @@ Version 2.0.68 ### HDInsight * [BREAKING CHANGE] Changed `oms` command group name to `monitor` -* [BREAKING CHANGE] Made `--http-password/-p` a required parameter -* Added completers for `--cluster-admin-account` and `cluster-users-group-dns` parameters completer +* [BREAKING CHANGE] Made `--http-password/-p` a required parameter +* Added completers for `--cluster-admin-account` and `cluster-users-group-dns` parameters completer * Changed `cluster-users-group-dns` parameter to be required when `—esp` is present * Added a timeout for all existing argument auto-completers * Added a timeout for transforming resource name to resource id @@ -4539,8 +4669,8 @@ Version 2.0.68 ### Storage -* Added user delegation SAS token support with `--as-user` to `storage blob generate-sas` -* Added user delegation SAS token support with `--as-user` to `storage container generate-sas` +* Added user delegation SAS token support with `--as-user` to `storage blob generate-sas` +* Added user delegation SAS token support with `--as-user` to `storage container generate-sas` ### VM @@ -4665,7 +4795,7 @@ Version 2.0.66 ### Network * Added `network application-gateway waf-policy` commands to support custom WAF rules. -* Added `--waf-policy` and `--max-capacity` arguments to `network application-gateway [create|update]` +* Added `--waf-policy` and `--max-capacity` arguments to `network application-gateway [create|update]` ### Resource * Improved error message from `deployment create` when there is no TTY available @@ -4711,7 +4841,7 @@ Version 2.0.65 * Added support to list all keys ### Network -* [BREAKING CHANGE]: Removed `network interface-endpoints` command group - use `network private-endpoints` +* [BREAKING CHANGE]: Removed `network interface-endpoints` command group - use `network private-endpoints` * Added `--nat-gateway` argument to `network vnet subnet [create|update]` for attaching to a NAT gateway * Fixed issue with `dns zone import` where record names could not match a record type @@ -4784,7 +4914,7 @@ Version 2.0.64 * Added `--default-action` argument for network rules to `namespace [create|update]` ### Network -* [BREAKING CHANGE] Replaced `--cache` arugment with `--defer` for `vnet [create|update]` +* [BREAKING CHANGE] Replaced `--cache` arugment with `--defer` for `vnet [create|update]` ### Policy Insights * Added support for `--expand PolicyEvaluationDetails` to query policy evaluation details on the resource @@ -4891,7 +5021,7 @@ Version 2.0.63 * Changed `feedback` to print out issue body when run with '--verbose' ### Monitor -* Fixed issue where "count" was not a permitted value with `metrics alert [create|update]` +* Fixed issue where "count" was not a permitted value with `metrics alert [create|update]` ### Network * Fixed table format not displaying with `vnet-gateway list-bgp-peer-status` @@ -4945,7 +5075,7 @@ Version 2.0.63 * Added `SCM_DO_BUILD_DURING_DEPLOYMENT` to ARM template's Application Settings for v4 Web App Bots ### CDN -* Added support for `--no-wait` to `cdn endpoint [create|update|start|stop|delete|load|purge]` +* Added support for `--no-wait` to `cdn endpoint [create|update|start|stop|delete|load|purge]` * [BREAKING CHANGE]: Changed `cdn endpoint create` default query string caching behaviour. No longer defaults to "IgnoreQueryString". It is now set by the service ### Cosmosdb @@ -4964,7 +5094,7 @@ Version 2.0.63 ### Profile * Added tenant level account support for managed service identity to `login` -### Postgres +### Postgres * Added postgresql `replica` commands and `restart server` command * Changed to get default location from resource group when not provided for creating servers and add validation for retention days @@ -5002,7 +5132,7 @@ Version 2.0.60 ### ACS -* Changed to ignore the `--listen-address` parameter for `aks browse` if it is not supported by kubectl +* Changed to ignore the `--listen-address` parameter for `aks browse` if it is not supported by kubectl ### AppService @@ -5076,7 +5206,7 @@ Version 2.0.59 * [BREAKING CHANGE] Removed the `batch pool upgrade os` command * [BREAKING CHANGE] Removed the `Pacakges` property from `Application` responses * Added the `batch application package list` command to list packages of an application -* [BREAKING CHANGE] Changed `--application-id` to `--application-name` in all `batch application` commands, +* [BREAKING CHANGE] Changed `--application-id` to `--application-name` in all `batch application` commands, * Added the `--json-file` argument to commands for requesting the raw API response * Updated validation to automatically include `https://` in all endpoints if missing @@ -5093,7 +5223,7 @@ Version 2.0.59 * Added `--express-route-gateway-bypass` argument to `vpn-connection [create|update]` * Added command groups from `express-route` extensions * Added `express-route gateway` and `express-route port` command groups -* Added argument `--legacy-mode` to `express-route peering [create|update]` +* Added argument `--legacy-mode` to `express-route peering [create|update]` * Added arguments `--allow-classic-operations` and `--express-route-port` to `express-route [create|update]` * Added `--gateway-default-site` argument to `vnet-gateway [create|update]` * Added `ipsec-policy` commands to `vnet-gateway` @@ -5238,7 +5368,7 @@ Version 2.0.56 * [BREAKING CHANGE] Removed the `--virtual-network` and `--subnet-name` parameters from `hdinsight [application] create` * [BREAKING CHANGE] Changed `hdinsight create --storage-account` to accept name or id of storage account instead of blob endpoints * Added `--vnet-name` and `--subnet-name` parameters to `hdinsight create` -* Added support for Enterprise Security Package and disk encryption to `hdinsight create` +* Added support for Enterprise Security Package and disk encryption to `hdinsight create` * Added `hdinsight rotate-disk-encryption-key` command * Added `hdinsight update` command @@ -5291,7 +5421,7 @@ Version 2.0.55 ### Appservice * Fixed issue with uploading certificates for apps that are hosted on an ASE, where the ASE RG & App RG are different * Changed `webapp up` to use SKU P1V1 as default for Linux -* Fixed `[webapp|functionapp] deployment source config-zip` to show the right error message when a deployment fails +* Fixed `[webapp|functionapp] deployment source config-zip` to show the right error message when a deployment fails * Added `webapp ssh` command ### Botservice @@ -5313,7 +5443,7 @@ Version 2.0.55 ### Network * Added `--custom-headers` and `--status-code-ranges` arguments to `traffic-manager profile [create|update]` * Added new routing types: Subnet and Multivalue -* Added `--custom-headers` and `--subnets` arguments to `traffic-manager endpoint [create|update]` +* Added `--custom-headers` and `--subnets` arguments to `traffic-manager endpoint [create|update]` * Fixed issue where supplying `--vnets ""` to `ddos-protection update` caused an error ### Role @@ -5325,7 +5455,7 @@ Version 2.0.55 ### Storage * [BREAKING CHANGE] Changed `storage [blob|file|container|share] list` default number of results to be 5,000. Use `--num-results *` for original behavior of returning all results * Added `--marker` parameter to `storage [blob|file|container|share] list` -* Added log marker for next page to STDERR for `storage [blob|file|container|share] list` +* Added log marker for next page to STDERR for `storage [blob|file|container|share] list` * Added `storage blob service-properties update` command with support for static websites ### VM @@ -5395,7 +5525,7 @@ Version 2.0.53 * Fixed issue with `dns zone update` where using "" to clear resolution and registration VNets didn't work ### Resource -* Fixed handling of scope parameter for management groups in `policy assignment [create|list|delete|show|update]` +* Fixed handling of scope parameter for management groups in `policy assignment [create|list|delete|show|update]` * Added new command `resource wait` ### Storage @@ -5419,7 +5549,7 @@ Version 2.0.52 * Added `--exclusion` argument to `application-gateway waf-config set` to support WAF exclusions ### Role -* Added support for custom identifiers for password credential +* Added support for custom identifiers for password credential ### VM * [DEPRECATED] Deprecated `vm extension [show|wait] --expand` parameter @@ -5453,7 +5583,7 @@ Version 2.0.51 ### Network * Added `root-cert` subcommands to `application-gateway` to handle trusted root certifcates * Added `--min-capacity` and `--custom-error-pages` options to `application-gateway [create|update]`: -* Added `--zones` for availability zone support to `application-gateway create` +* Added `--zones` for availability zone support to `application-gateway create` * Added arguments `--file-upload-limit`, `--max-request-body-size` and `--request-body-check` to `application-gateway waf-config set` ### Rdbms @@ -5461,7 +5591,7 @@ Version 2.0.51 ### Rbac * Fixed an issue with attempting to update immutable credentials in `ad app update` -* Added output warnings to communicate breaking changes in the near future for `ad [app|sp] list` +* Added output warnings to communicate breaking changes in the near future for `ad [app|sp] list` ### Storage * Improved handling of corner cases for storage copy commands @@ -5514,7 +5644,7 @@ Version 2.0.50 * Added support to `ams transform output remove` now can be performed by passing the output index to remove * Added `--correlation-data` and `--label` arguments to `ams job` command group * Added `--storage-account` and `--container` arguments to `ams asset` command group -* Added default values for expiry time (Now+23h) and permissions (Read) in `ams asset get-sas-url` command +* Added default values for expiry time (Now+23h) and permissions (Read) in `ams asset get-sas-url` command * [BREAKING CHANGE] Replaced `ams streaming locator` command with `ams streaming-locator` * [BREAKING CHANGE] Updated `--content-keys` argument of `ams streaming locator` * [BREAKING CHANGE] Renamed `--content-policy-name` to `--content-key-policy-name` in `ams streaming locator` command @@ -5543,7 +5673,7 @@ Version 2.0.50 ### Network * Deprecated `network interface-endpoint` command names in favor of `network private-endpoint` * Fixed issue with where `--peer-circuit` argument in `express-route peering connection create`would not accept an ID -* Fixed issue where `--ip-tags` did not work correctly with `public-ip create` +* Fixed issue where `--ip-tags` did not work correctly with `public-ip create` ### Profile * Added `--use-cert-sn-issuer` to `az login` for service principal login with cert auto-rolls @@ -5654,7 +5784,7 @@ Version 2.0.47 * Added support for similar table format as helm client ### ACS -* Added `aks [create|scale] --nodepool-name` to configure nodepool name, truncated to 12 characters, default - nodepool1 +* Added `aks [create|scale] --nodepool-name` to configure nodepool name, truncated to 12 characters, default - nodepool1 * Fixed to fall back to 'scp' when Parimiko fails * Changed `aks create` to no longer require `--aad-tenant-id` * Improved merging of Kubernetes credentials when duplicate entries are present @@ -5734,7 +5864,7 @@ Version 2.0.46 * Added `--max-tasks-per-node-option` to `batch pool create` * Changed behavior of `batch account` to show currently logged in account if no options are specified -### Batch AI +### Batch AI * Fixed auto storage account creation failure in `batchai cluster create` command ### Cognitive Services @@ -5871,7 +6001,7 @@ Version 2.0.45 ### VM -* Changed `vm/vmss identity show` to exit with code 3 upon a missing resource +* Changed `vm/vmss identity show` to exit with code 3 upon a missing resource * Deprecated `--storage-caching` for `vm create` ## Auguest 14, 2018 @@ -5897,8 +6027,8 @@ Version 2.0.44 * Changed `az acs/aks install-cli` to install under `%USERPROFILE%\.azure-kubectl` on Windows * Changed `az aks install-connector` to detect if the cluster has RBAC and configure ACI Connector appropriately * Changed to role assignment to the subnet when it's provided -* Added new option to "skip role assignment" for subnet when it's provided -* Changed to skip role assignment to subnet when assignment already exists +* Added new option to "skip role assignment" for subnet when it's provided +* Changed to skip role assignment to subnet when assignment already exists ### AppService @@ -5907,11 +6037,11 @@ Version 2.0.44 ### BatchAI -* Changed logger output for auto-storage account creation to specifies "resource *group*". +* Changed logger output for auto-storage account creation to specifies "resource *group*". ### Container -* Added `--secure-environment-variables` for passing secure environment variables to a container +* Added `--secure-environment-variables` for passing secure environment variables to a container ### IoT @@ -5926,7 +6056,7 @@ Version 2.0.44 * Added commands for managing storage accounts and sas-definitions -* Added commands for network-rules +* Added commands for network-rules * Added `--id` parameter to secret, key, and certificate operations * Added support for KV mgmt multi-api version * Added support for KV data plane multi-api version @@ -5974,7 +6104,7 @@ Version 2.0.43 ### Network -* Added dns support to 2017-03-09-profile for Azure Stack +* Added dns support to 2017-03-09-profile for Azure Stack ### Resource @@ -6050,10 +6180,10 @@ Version 2.0.42 ### Network -* Added `--no-wait` support to `network nic [create|update|delete]` +* Added `--no-wait` support to `network nic [create|update|delete]` * Added `network nic wait` * Deprecated `--ids` argument for `network vnet [subnet|peering] list` -* Added `--include-default` flag to include default security rules in the output of `network nsg rule list` +* Added `--include-default` flag to include default security rules in the output of `network nsg rule list` ### Resource @@ -8392,9 +8522,9 @@ You can report issues with nightly preview builds in the following ways: * [BREAKING CHANGE] Skip SSL verification via environment `ADAL_PYTHON_SSL_NO_VERIFY` has been removed. See [work behind a proxy](/cli/azure/use-cli-effectively#work-behind-a-proxy) for trusting a self-signed root certificate. -The beta version of the Azure CLI supports all commands and will stay in sync with the current released version. +The beta version of the Azure CLI supports all commands and will stay in sync with the current released version. -For installation instructions, see [Install Azure CLI beta version](install-azure-cli-beta.md). +For installation instructions, see [Install Azure CLI beta version](install-azure-cli-beta.md). If you find issues in the beta release, the Azure CLI engineering team welcomes your comments on [GitHub](https://github.com/Azure/azure-cli/issues/new/choose).