Inter Mute v1.2.11.1 serial key or number

1. About Cygwin

1.1. What is it?

1.2. What versions of Windows are supported?

1.3. Where can I get it?

1.4. Is it free software?

1.5. What version of Cygwin is this, anyway?

1.6. Who's behind the project?

1.1.

What is it?

Cygwin is a distribution of popular GNU and other Open Source tools running on Microsoft Windows. The core part is the Cygwin library which provides the POSIX system calls and environment these programs expect.

The Cygwin distribution contains thousands of packages from the Open Source world including most GNU tools, many BSD tools, an X server and a full set of X applications. If you're a developer you will find tools, headers and libraries allowing to write Windows console or GUI applications that make use of significant parts of the POSIX API. Cygwin allows easy porting of many Unix programs without the need for extensive changes to the source code. This includes configuring and building most of the available GNU or BSD software, including the packages included with the Cygwin distribution themselves. They can be used from one of the provided Unix shells like bash, tcsh or zsh.

1.2.

What versions of Windows are supported?

Cygwin can be expected to run on all modern, released versions of Windows. State January 2016 this includes Windows Vista, Windows Server 2008 and all later versions of Windows up to Windows 10 and Windows Server 2016. The 32 bit version of Cygwin also runs in the WOW64 32 bit environment on released 64 bit versions of Windows, the 64 bit version of course only on 64 bit Windows.

Keep in mind that Cygwin can only do as much as the underlying OS supports. Because of this, Cygwin will behave differently, and exhibit different limitations, on the various versions of Windows.

1.3.

Where can I get it?

The home page for the Cygwin project is https://cygwin.com/. There you should find everything you need for Cygwin, including links for download and setup, a current list of mirror sites, a User's Guide, an API Reference, mailing lists and archives.

You can find documentation for the individual GNU tools typically as man pages or info pages as part of the Cygwin net distribution. Additionally you can get the latest docs at http://www.gnu.org/manual.

1.4.

Is it free software?

Yes. Parts are GNU software (gcc, gas, ld, etc...), parts are covered by the standard X11 license, some of it is public domain, some of it was written by Red Hat (or the former Cygnus Solutions) and placed under the GPL. None of it is shareware. You don't have to pay anyone to use it but you should be sure to read the copyright section of the FAQ for more information on how the GNU General Public License may affect your use of these tools.

Note that when we say "free" we mean freedom, not price. The goal of such freedom is that the people who use a given piece of software should be able to change it to fit their needs, learn from it, share it with their friends, etc. The GPL or LGPL licenses allows you those freedoms, so it is free software.

1.5.

What version of Cygwin is this, anyway?

To find the version of the Cygwin DLL installed, you can use as on Linux or . Refer to each command's output and the Cygwin User's Guide for more information.

If you are looking for the version number for the whole Cygwin release, there is none. Each package in the Cygwin release has its own version. The packages in Cygwin are continually improving, thanks to the efforts of net volunteers who maintain the Cygwin binary ports. Each package has its own version numbers and its own release process.

So, how do you get the most up-to-date version of Cygwin? Easy. Just download the Cygwin Setup program by following the instructions here. The setup program will handle the task of updating the packages on your system to the latest version. For more information about using Cygwin's , see Setting Up Cygwin in the Cygwin User's Guide.

1.6.

Who's behind the project?

(Please note that if you have cygwin-specific questions, all of these people will appreciate it if you use the cygwin mailing lists rather than sending personal email.)

Corinna Vinschen is the current project lead. Corinna is a senior Red Hat engineer. Corinna is responsible for the Cygwin library and maintains a couple of packages, for instance OpenSSH, OpenSSL, and a lot more.

Yaakov Selkowitz is another Red Hat engineer working on the Cygwin project. He's the guy behind the current build and packaging system and maintains by far the most packages in the Cygwin distribution.

Jon Turney is developer and maintainer of the Cygwin X server and a couple of related packages.

The packages in the Net release are maintained by a large group of people; a complete list can be found here.

Please note that all of us working on Cygwin try to be as responsive as possible and deal with patches and questions as we get them, but realistically we don't have time to answer all of the email that is sent to the main mailing list. Making Net releases of the Win32 tools and helping people on the Net out is not our primary job function, so some email will have to go unanswered.

Many thanks to everyone using the tools for their many contributions in the form of advice, bug reports, and code fixes. Keep them coming!

2. Setting up Cygwin

2.1. What is the recommended installation procedure?

2.2. What about an automated Cygwin installation?

2.3. Does Setup accept command-line arguments?

2.4. Can I install Cygwin without administrator rights?

2.5. Why not install in C:\?

2.6. Can I use Cygwin Setup to get old versions of packages (like gcc-2.95)?

2.7. How does Cygwin secure the installation and update process?

2.8. What else can I do to ensure that my installation and updates are secure?

2.9. Is Cygwin Setup, or one of the packages, infected with a virus?

2.10. My computer hangs when I run Cygwin Setup!

2.11. What packages should I download? Where are 'make', 'gcc', 'vi', etc?

2.12. How do I just get everything?

2.13. How much disk space does Cygwin require?

2.14. How do I know which version I upgraded from?

2.15. What if setup fails?

2.16. My Windows logon name has a space in it, will this cause problems?

2.17. My HOME environment variable is not what I want.

2.18. How do I uninstall individual packages?

2.19. How do I uninstall a Cygwin service?

2.20. How do I uninstall all of Cygwin?

2.21. How do I install snapshots?

2.22. Can Cygwin Setup maintain a ``mirror''?

2.23. How can I make my own portable Cygwin on CD?

2.24. How do I save, restore, delete, or modify the Cygwin information stored in the registry?

2.1.

What is the recommended installation procedure?

There is only one recommended way to install Cygwin, which is to use the GUI installer setup-*.exe. It is flexible and easy to use. You can pick and choose the packages you wish to install, and update them individually. Full source code is available for all packages and tools. More information on using Cygwin Setup may be found at https://cygwin.com/cygwin-ug-net/setup-net.html.

If you do it any other way, you're on your own! If something doesn't work right for you, and it's not covered here or in the latest development snapshot at https://cygwin.com/snapshots/, then by all means report it to the mailing list.

For a searchable list of packages that can be installed with Cygwin, see https://cygwin.com/packages/.

2.2.

What about an automated Cygwin installation?

The Cygwin Setup program is designed to be interactive, but there are a few different ways to automate it. If you are deploying to multiple systems, the best way is to run through a full installation once, saving the entire downloaded package tree. Then, on target systems, run Cygwin Setup as a "Local Install" pointed at your downloaded package tree. You could do this non-interactively with the command line options , where your downloaded package tree is in (see the next FAQ for an explanation of those options.)

For other options, search the mailing lists with terms such as cygwin automated setup or automated cygwin install.

2.3.

Does Setup accept command-line arguments?

Yes, run or for a list.

2.4.

Can I install Cygwin without administrator rights?

Yes. The default installation requests administrator rights because this allows to set up the Cygwin environment so that all users can start a Cygwin shell out of the box. However, if you don't have administrator rights for your machine, and the admins don't want to install it for you, you can install Cygwin just for yourself by downloading setup-x86.exe (for a 32 bit install) or setup-x86_64.exe (for a 64 bit install) and then start it from the command line or via the "Run..." dialog from the start menu using the option, for instance:

2.5.

Why not install in C:\?

The Cygwin Setup program will prompt you for a "root" directory. The default is , but you can change it. You are urged not to choose something like (the root directory on the system drive) for your Cygwin root. If you do, then critical Cygwin system directories like , and could easily be corrupted by other (non-Cygwin) applications or packages that use , or . Perhaps there is no conflict now, but who knows what you might install in the future? It's also just good common sense to segregate your Cygwin "filesystems" from the rest of your Windows system disk.

(In the past, there had been genuine bugs that would cause problems for people who installed in , but we believe those are gone now.)

2.6.

Can I use Cygwin Setup to get old versions of packages (like gcc-2.95)?

Cygwin Setup can be used to install any packages that are on a Cygwin mirror, which usually includes one version previous to the current one. The complete list may be searched at https://cygwin.com/packages/. There is no complete archive of older packages. If you have a problem with the current version of a Cygwin package, please report it to the mailing list using the guidelines at https://cygwin.com/problems.html.

That said, if you really need an older package, you may be able to find an outdated or archival mirror by searching the web for an old package version (for example, ), but keep in mind that this older version will not be supported by the mailing list and that installing the older version will not help improve Cygwin.

2.7.

How does Cygwin secure the installation and update process?

Here is how Cygwin secures the installation and update process to counter man-in-the-middle (MITM) attacks:

Cygwin uses the cryptographic hash algorithm SHA-512 as of 2015-03-23. The earlier 2015-02-06 update of the setup program added support for SHA-512 (Cygwin previously used MD5). There are no known practical exploits of SHA-512 (SHA-512 is part of the widely-used SHA-2 suite of cryptographic hashes).

2.8.

What else can I do to ensure that my installation and updates are secure?

To best secure your installation and update process, download the setup program (32-bit) or (64-bit), and then check its signature (using a signature-checking tool you trust) using the Cygwin public key (https://cygwin.com/key/pubring.asc). This was noted on the front page for installing and updating.

If you use the actual Cygwin public key, and have an existing secure signature-checking process, you will counter many other attacks such as subversion of the Cygwin website and malicious certificates issued by untrustworthy certificate authorities (CAs). One challenge, of course, is ensuring that you have the actual Cygwin public key. You can increase confidence in the Cygwin public key by checking older copies of the Cygwin public key (to see if it's been the same over time). Another challenge is having a secure signature-checking process. You can use GnuPG to check signatures; if you have a trusted Cygwin installation you can install GnuPG. Otherwise, to check the signature you must use an existing trusted tool or install a signature-checking tool you can trust.

Not everyone will go through this additional effort, but we make it possible for those who want that extra confidence. We also provide automatic mechanisms (such as our use of HTTPS) for those with limited time and do not want to perform the signature checking on the setup program itself. Once the correct setup program is running, it will counter other attacks as described in https://cygwin.com/faq/faq.html#faq.setup.install-security.

2.9.

Is Cygwin Setup, or one of the packages, infected with a virus?

Unlikely. Unless you can confirm it, please don't report it to the mailing list. Anti-virus products have been known to detect false positives when extracting compressed tar archives. If this causes problems for you, consider disabling your anti-virus software when running . Read the next entry for a fairly safe way to do this.

2.10.

My computer hangs when I run Cygwin Setup!

Both Network Associates (formerly McAfee) and Norton anti-virus products have been reported to "hang" when extracting Cygwin tar archives. If this happens to you, consider disabling your anti-virus software when running Cygwin Setup. The following procedure should be a fairly safe way to do that:

This should be safe, but only if Cygwin Setup is not substituted by something malicious. See also https://cygwin.com/faq/faq.html#faq.setup.install-security for a description of how the Cygwin project counters man-in-the-middle (MITM) attacks.

See also https://cygwin.com/faq/faq.html#faq.using.bloda for a list of applications that have been known, at one time or another, to interfere with the normal functioning of Cygwin.

2.11.

What packages should I download? Where are 'make', 'gcc', 'vi', etc?

When using Cygwin Setup for the first time, the default is to install a minimal subset of all available packages. If you want anything beyond that, you will have to select it explicitly. See https://cygwin.com/packages/ for a searchable list of available packages, or use as described in the Cygwin User's Guide at https://cygwin.com/cygwin-ug-net/cygcheck.html.

If you want to build programs, of course you'll need , , and probably other packages from the ``Devel'' category. Text editors can be found under ``Editors''.

2.12.

How do I just get everything?

Long ago, the default was to install everything, much to the irritation of most users. Now the default is to install only a basic core of packages. Cygwin Setup is designed to make it easy to browse categories and select what you want to install or omit from those categories. It's also easy to install everything:

This procedure only works for packages that are currently available. There is no way to tell Cygwin Setup to install all packages by default from now on. As new packages become available that would not be installed by default, you have to repeat the above procedure to get them.

In general, a better method (in my opinion), is to:

2.13.

How much disk space does Cygwin require?

That depends, obviously, on what you've chosen to download and install. A full installation today is probably larger than 1 GB installed, not including the package archives themselves nor the source code.

After installation, the package archives remain in your ``Local Package Directory''. By default the location of . You may conserve disk space by deleting the subdirectories there. These directories will have very weird looking names, being encoded with their URLs (named ).

Of course, you can keep them around in case you want to reinstall a package. If you want to clean out only the outdated packages, Michael Chase has written a script called , available at in a Cygwin mirror.

2.14.

How do I know which version I upgraded from?

Detailed logs of the most recent Cygwin Setup session can be found in and less verbose information about prior actions is in .

2.15.

What if setup fails?

First, make sure that you are using the latest version of Cygwin Setup. The latest version is always available from the Cygwin Home Page at https://cygwin.com/.

If you are downloading from the Internet, setup will fail if it cannot download the list of mirrors at https://cygwin.com/mirrors.html. It could be that the network is too busy. Something similar could be the cause of a download site not working. Try another mirror, or try again later.

If setup refuses to download a package that you know needs to be upgraded, try deleting that package's entry from /etc/setup. If you are reacting quickly to an announcement on the mailing list, it could be that the mirror you are using doesn't have the latest copy yet. Try another mirror, or try again tomorrow.

If setup has otherwise behaved strangely, check the files and in ( by default). It may provide some clues as to what went wrong and why.

If you're still baffled, search the Cygwin mailing list for clues. Others may have the same problem, and a solution may be posted there. If that search proves fruitless, send a query to the Cygwin mailing list. You must provide complete details in your query: version of setup, options you selected, contents of setup.log and setup.log.full, what happened that wasn't supposed to happen, etc.

2.16.

My Windows logon name has a space in it, will this cause problems?

Most definitely yes! UNIX shells (and thus Cygwin) use the space character as a word delimiter. Under certain circumstances, it is possible to get around this with various shell quoting mechanisms, but you are much better off if you can avoid the problem entirely.

You have two choices:

2.17.

My environment variable is not what I want.

When starting Cygwin from Windows, is determined as follows:

When using Cygwin from a network login (via ssh for instance), is always taken from the passwd entry.

If your is set to a value such as /cygdrive/c, it is likely that it was set in Windows. Start a DOS Command Window and type "set HOME" to verify if this is the case.

Access to shared drives is often restricted when starting from the network, thus Domain users may wish to have a different in the Windows environment (on shared drive) than in Cygwin (on local drive). Note that ssh only considers the account information as retrieved by getpwnam(3), disregarding .

2.18.

How do I uninstall individual packages?

Run Cygwin Setup as you would to install packages. In the list of packages to install, browse the relevant category or click on the ``View'' button to get a full listing. Click on the cycle glyph until the action reads ``Uninstall''. Proceed by clicking ``Next''.

2.19.

How do I uninstall a Cygwin service?

2.20.

How do I uninstall all of Cygwin?

Setup has no automatic uninstall facility. The recommended method to remove all of Cygwin is as follows:

2.21.

How do I install snapshots?

First, are you sure you want to do this? Snapshots are risky. They have not been tested. Use them only if there is a feature or bugfix that you need to try, and you are willing to deal with any problems, or at the request of a Cygwin developer.

You cannot use Cygwin Setup to install a snapshot.

First, you will need to download the snapshot from the snapshots page at https://cygwin.com/snapshots/. Note the directory where you saved the snapshot tarball.

Before installing a snapshot, you must first Close all Cygwin applications, including shells and services (e.g., , ). You will not be able to replace if any Cygwin process is running. You may have to restart Windows to clear the DLL from memory (beware of automatic service startup).

Most of the downloaded snapshot can be installed using . Cygwin won't be able to update (because it's used by itself), but it should succeed with everything else. If you are only installing the DLL snapshot, skip the first tar command. Open a shell (it should be the only running Cygwin process) and issue the following commands:

Exit the bash shell, and use Explorer or the Windows command shell to first rename to and then move to (assuming you installed Cygwin in ).

The operative word in trying the snapshots is "trying". If you notice a problem with the snapshot that was not present in the release DLL (what we call a "regression"), please report it to the Cygwin mailing list (see https://cygwin.com/problems.html for problem reporting guidelines). If you wish to go back to the older version of the DLL, again, close all Cygwin processes, delete , and rename back to (again assuming that your "" is ). To restore the rest of the snapshot files, reinstall the "" package using Setup.

2.22.

Can Cygwin Setup maintain a ``mirror''?

NO. Cygwin Setup cannot do this for you. Use a tool designed for this purpose. See http://rsync.samba.org/, http://www.gnu.org/software/wget/ for utilities that can do this for you. For more information on setting up a custom Cygwin package server, see the Cygwin Setup homepage at https://sourceware.org/cygwin-apps/setup.html.

2.23.

How can I make my own portable Cygwin on CD?

While some users have successfully done this, for example Indiana University's XLiveCD http://racinfo.indiana.edu/research/xlivecd.php, there is no easy way to do it. Full instructions for constructing a portable Cygwin on CD by hand can be found on the mailing list at https://www.cygwin.com/ml/cygwin/2003-07/msg01117.html (Thanks to fergus at bonhard dot uklinux dot net for these instructions.) Please note that these instructions are very old and are referring to the somewhat different setup of a Cygwin 1.5.x release. As soon as somebody set this up for recent Cygwin releases, we might add this information here.

2.24.

How do I save, restore, delete, or modify the Cygwin information stored in the registry?

Cygwin doesn't store anything important in the registry anymore for quite some time. There's no reason to save, restore or delete it.

3. Further Resources

3.1. Where's the documentation?

3.2. What Cygwin mailing lists can I join?

3.3. What if I have a problem? (Or: Why won't you/the mailing list answer my questions?)

3.1.

Where's the documentation?

If you have installed Cygwin, you can find lots of documentation in . Some packages have Cygwin specific instructions in a file . In addition, many packages ship with standard documentation, which you can find in or by using the or tools. (Hint: use to list what man pages the package includes.) Some older packages still keep their documentation in instead of .

There are links to quite a lot of documentation on the main Cygwin project web page, https://cygwin.com/, including this FAQ. Be sure to at least read any 'Release Notes' or 'Readme' or 'read this' links on the main web page, if there are any.

There is a comprehensive Cygwin User's Guide at https://cygwin.com/cygwin-ug-net/cygwin-ug-net.html and an API Reference at https://cygwin.com/cygwin-api/cygwin-api.html.

You can find documentation for the individual GNU tools at http://www.gnu.org/manual/.

3.2.

What Cygwin mailing lists can I join?

Comprehensive information about the Cygwin mailing lists can be found at https://cygwin.com/lists.html.

3.3.

What if I have a problem? (Or: Why won't you/the mailing list answer my questions?)

Comprehensive information about reporting problems with Cygwin can be found at https://cygwin.com/problems.html.

4. Using Cygwin

4.1. Why can't my application locate cygncurses-8.dll? or cygintl-3.dll? or cygreadline6.dll? or ...?

4.2. Starting a new terminal window is slow. What's going on?

4.3. Why is Cygwin suddenly so slow?

4.4. Why can't my services access network shares?

4.5. How should I set my PATH?

4.6. Bash (or another shell) says "command not found", but it's right there!

4.7. How do I convert between Windows and UNIX paths?

4.8. Why doesn't bash read my .bashrc file on startup?

4.9. How can I get bash filename completion to be case insensitive?

4.10. Can I use paths/filenames containing spaces in them?

4.11. Why can't I cd into a shortcut to a directory?

4.12. I'm having basic problems with find. Why?

4.13. Why doesn't su work?

4.14. Why doesn't man -k, apropos or whatis work?

4.15. Why doesn't chmod work?

4.16. Why doesn't my shell script work?

4.17. How do I print under Cygwin?

4.18. Why don't international (Unicode) characters work?

4.19. My application prints international characters but I only see gray boxes

4.20. Is it OK to have multiple copies of the DLL?

4.21. I read the above but I want to bundle Cygwin with a product, and ship it to customer sites. How can I do this without conflicting with any Cygwin installed by the user?

4.22. Can I bundle Cygwin with my product for free?

4.23. But doesn't that mean that if some application installs an older Cygwin DLL on top of a newer DLL, my application will break?

4.24. Why isn't package XYZ available in Cygwin?

4.25. Why is the Cygwin package of XYZ so out of date?

4.26. How can I access other drives?

4.27. How can I copy and paste into Cygwin console windows?

4.28. What firewall should I use with Cygwin?

4.29. How can I share files between Unix and Windows?

4.30. Is Cygwin case-sensitive??

4.31. What about DOS special filenames?

4.32. When it hangs, how do I get it back?

4.33. Why the weird directory structure?

4.34. How do anti-virus programs like Cygwin?

4.35. Is there a Cygwin port of GNU Emacs?

4.36. Is there a Cygwin port of XEmacs?

4.37. Why don't some of my old symlinks work anymore?

4.38. Why don't symlinks work on Samba-mounted filesystems?

4.39. Why does public key authentication with ssh fail after updating to Cygwin 1.7.34 or later?

4.40. Why is my .rhosts file not recognized by rlogin anymore after updating to Cygwin 1.7.34?

4.41. Why do my files have extra permissions after updating to Cygwin 1.7.34?

4.42. Why do my Tk programs not work anymore?

4.43. What applications have been found to interfere with Cygwin?

4.44. How do I fix fork() failures?

4.45. How do I fix find_fast_cwd warnings?

4.1.

Why can't my application locate cygncurses-8.dll? or cygintl-3.dll? or cygreadline6.dll? or ...?

Well, something has gone wrong somehow...

To repair the damage, you must run Cygwin Setup again, and re-install the package which provides the missing DLL package.

If you already installed the package at one point, Cygwin Setup won't show the option to install the package by default. In the ``Select packages to install'' dialog, click on the button. This lists all packages, even those that are already installed. Scroll down to locate the missing package, for instance . Click on the ``cycle'' glyph until it says ``Reinstall''. Continue with the installation.

For a detailed explanation of the general problem, and how to extend it to other missing DLLs and identify their containing packages, see https://cygwin.com/ml/cygwin/2002-01/msg01619.html.

4.2.

Starting a new terminal window is slow. What's going on?

There are many possible causes for this.

If your terminal windows suddenly began starting slowly after a Cygwin upgrade, it may indicate issues in the authentication setup.

For almost all its lifetime, Cygwin has used Unix-like and files to mirror the contents of the Windows SAM and AD databases. Although these files can still be used, since Cygwin 1.7.34, new installations now use the SAM/AD databases directly.

To switch to the new method, move these two files out of the way and restart the Cygwin terminal. That runs Cygwin in its new default mode.

If you are on a system that isn't using AD domain logins, this makes Cygwin use the native Windows SAM database directly, which may be faster than the old method involving and such. At worst, it will only be a bit slower. (The speed difference you see depends on which benchmark you run.) For the AD case, it can be slower than the old method, since it is trading a local file read for a network request. Version 1.7.35 will reduce the number of AD server requests the DLL makes relative to 1.7.34, with the consequence that you will now have to alter in order to change your Cygwin home directory, instead of being able to change it from the AD configuration.

If you are still experiencing very slow shell startups, there are a number of other things you can look into:

If none of the above helps, the best troubleshooting method is to run your startup scripts in debug mode. Right-click your Cygwin Terminal icon, go to Properties, and edit the command. It should be something like C:\cygwin\bin\mintty.exe -i /Cygwin-Terminal.ico -. Assuming you are using Bash for your login shell, change it to C:\cygwin\bin\mintty /bin/bash -lx then try running Cygwin Terminal again. The option tells Bash to write every command it runs to the terminal before launching it. If the terminal immediately starts filling with lines of text but then pauses, the line where the output paused is your clue as to what's going on. The Cygwin DLL proper probably isn't the cause of the slowdown in this case, since those delays happen before the first line of text appears in the terminal.

4.3.

Why is Cygwin suddenly so slow?

If suddenly every command takes a very long time, then something is probably attempting to access a network share. You may have the obsolete notation in your PATH or startup files. Using means to contact the network server, which will slow things down tremendously if it does not exist.

4.4.

Why can't my services access network shares?

If your service is one of those which switch the user context (sshd, inetd, etc), then it depends on the method used to switch to another user. This problem as well as its solution is described in detail in the Cygwin User's Guide, see https://cygwin.com/cygwin-ug-net/ntsec.html.

Workarounds include using public network share that does not require authentication (for non-critical files), providing your password to a net use command, or running the service as your own user with (see for more information).

4.5.

How should I set my PATH?

This is done for you in the file /etc/profile, which is sourced by bash when you start it from the Desktop or Start Menu shortcut, created by . The line is

Effectively, this prepends /usr/local/bin and /usr/bin to your Windows system path. If you choose to reset your PATH, say in $HOME/.bashrc, or by editing etc/profile directly, then you should follow this rule. You must have in your PATH before any Windows system directories. (And you must not omit the Windows system directories!) Otherwise you will likely encounter all sorts of problems running Cygwin applications.

If you're using another shell than bash (say, tcsh), the mechanism is the same, just the names of the login scripts are different.

4.6.

Bash (or another shell) says "command not found", but it's right there!

If you compile a program, you might find that you can't run it:

Unlike the Windows default behaviour, Unix shells like bash do not look for programs in (the current directory) by default. You can add to your PATH (see above), but this is not recommended (at least on UNIX) for security reasons. Just tell bash where to find it, when you type it on the command line:

4.7.

How do I convert between Windows and UNIX paths?

Use the 'cygpath' utility. Type '' for information. For example (on my installation):

Note that bash interprets the backslash '\' as an escape character, so you must type it twice in the bash shell if you want it to be recognized as such.

4.8.

Why doesn't bash read my .bashrc file on startup?

Your .bashrc is read from your home directory specified by the HOME environment variable. It uses /.bashrc if HOME is not set. So you need to set HOME (and the home dir in your passwd account information) correctly.

4.9.

How can I get bash filename completion to be case insensitive?

Add the following to your file:

and add the following to your file:

4.10.

Can I use paths/filenames containing spaces in them?

Cygwin does support spaces in filenames and paths. That said, some utilities that use the library may not, since files don't typically contain spaces in Unix. If you stumble into problems with this, you will need to either fix the utilities or stop using spaces in filenames used by Cygwin tools.

In particular, bash interprets space as a word separator. You would have to quote a filename containing spaces, or escape the space character. For example:

or

4.11.

Why can't I cd into a shortcut to a directory?

Cygwin does not follow MS Windows Explorer Shortcuts (*.lnk files). It sees a shortcut as a regular file and this you cannot "cd" into it.

Cygwin is also capable to create POSIX symlinks as Windows shortcuts (see the CYGWIN environment variable option "winsymlinks"), but these shortcuts are different from shortcuts created by native Windows applications. Windows applications can usually make use of Cygwin shortcuts but not vice versa. This is by choice. The reason is that Windows shortcuts may contain a bunch of extra information which would get lost, if, for example, Cygwin tar archives and extracts them as symlinks.

Changing a Cygwin shortcut in Windows Explorer usually changes a Cygwin shortcut into a Windows native shortcut. Afterwards, Cygwin will not recognize it as symlink anymore.

4.12.

I'm having basic problems with find. Why?

Make sure you are using the find that came with Cygwin and that you aren't picking up the Win32 find command instead. You can verify that you are getting the right one by doing a "type find" in bash.

If the path argument to find, including current directory (default), is itself a symbolic link, then find will not traverse it unless you specify the option. This behavior is different than most other UNIX implementations, but is not likely to change.

If find does not seem to be producing enough results, or seems to be missing out some directories, you may be experiencing a problem with one of find's optimisations. The absence of and directories on some filesystems, such as DVD-R UDF, can confuse find. See the documentation for the option in the man page.

4.13.

Why doesn't work?

The command has been in and out of Cygwin distributions, but it has not been ported to Cygwin and has never worked. It is currently installed as part of the sh-utils, but again, it does not work.

You should rather install and use as a replacement.

For some technical background into why doesn't work, read https://www.cygwin.com/ml/cygwin/2003-06/msg00897.html and related messages.

4.14.

Why doesn't , or work?

Before you can use , or , you must create the whatis database. Just run the command

(it may take a few minutes to complete).

4.15.

Why doesn't work?

If you're using FAT32 instead of NTFS, will fail since FAT32 does not provide any permission information. You should really consider converting the drive to NTFS with . FAT and FAT32 are barely good enough for memory cards or USB sticks to exchange pictures...

For other cases, understand that Cygwin attempts to show UNIX permissions based on the security features of Windows, so the Windows ACLs are likely the source of your problem. See the Cygwin User's Guide at https://cygwin.com/cygwin-ug-net/ntsec.html for more information on how Cygwin maps Windows permissions.

4.16.

Why doesn't my shell script work?

There are two basic problems you might run into. One is the fact that /bin/sh is really bash. It could be missing some features you might expect in /bin/sh, if you are used to /bin/sh actually being zsh (MacOS X "Panther") or ksh (Tru64).

Or, it could be a permission problem, and Cygwin doesn't understand that your script is executable. On NTFS or NFS just make the script executable using . However, may not work due to restrictions of the filesystem (see FAQ entry above). In this case Cygwin must read the contents of files to determine if they are executable. If your script does not start with

(or any path to a script interpreter, it does not have to be /bin/sh) then Cygwin will not know it is an executable script. The Bourne shell idiom

also works.

Note that you can use the filesystem flag in to force Cygwin to treat all files under the mount point as executable. This can be used for individual files as well as directories. Then Cygwin will not bother to read files to determine whether they are executable.

4.17.

How do I print under Cygwin?

lpr is available in the cygutils package. Some usage hints are available courtesy of Rodrigo Medina.

Jason Tishler has written a couple of messages that explain how to use a2ps (for nicely formatted text in PostScript) and ghostscript (to print PostScript files on non-PostScript Windows printers). Start at https://cygwin.com/ml/cygwin/2001-04/msg00657.html. Note that these are old mails and a2ps as well as file are long available as part of the Cygwin distribution.

Alternatively, you can use the Windows print command. Type

for usage instructions (note the must be escaped from the shell).

Finally, you can simply cat the file to the printer's share name:

You may need to press the formfeed button on your printer or append the formfeed character to your file.

4.18.

Why don't international (Unicode) characters work?

Internationalization is a complex issue. The short answer is that Cygwin relies on the setting of the setting of LANG/LC_xxx environment variables. The long answer can be found in the User's Guide in the section Internationalization

Cygwin uses UTF-8 by default. To use a different character set, you need to set the LC_ALL, LC_CTYPE or LANG environment variables.

4.19.

My application prints international characters but I only see gray boxes

In the case of Cygwin programs, this likely means that the character set as determined by the LC_ALL, LC_CTYPE or LANG environment variables does not match the one set on the Text page of the Cygwin Terminal's options. Setting the locale in the terminal's options will set the LANG variable accordingly.

Non-Cygwin programs in the Cygwin Terminal do not usually take heed of the locale environment variables. Instead, they often use the so-called console codepage, which can be determined with the command cmd /c chcp followed by the appropriate Windows codepage number. The codepage number for Cygwin's default UTF-8 character set is 65001.

4.20.

Is it OK to have multiple copies of the DLL?

Yes, as long as they are used in strictly separated installations.

The Cygwin DLL has to handle various sharing situations between multiple processes. It has to keep a process table. It has to maintain a mount table which is based on the installation path of the Cygwin DLL.

For that reason, the Cygwin DLL maintains shared resources based on a hash value created from its own installation path. Each Cygwin DLL on the machine constitutes a Cygwin installation, with the directory the Cygwin DLL resides in treated as "/bin", the parent directory as "/".

Therefore, you can install two or more separate Cygwin distros on a single machine. Each of these installations use their own Cygwin DLL, and they don't share the default POSIX paths, nor process tables, nor any other shared resource used to maintain the installation.

However, a clean separation requires that you don't try to run executables of one Cygwin installation from processes running in another Cygwin installation. This may or may not work, but the chances that the result is not what you expect are pretty high.

If you get the error "shared region is corrupted" or "shared region version mismatch" it means you have multiple versions of cygwin1.dll running at the same time which conflict with each other. Apart from mixing executables of different Cygwin installations, this could also happen if you have one a single Cygwin installation, for example, if you update the Cygwin package without exiting all Cygwin apps (including services like sshd) beforehand.

The only DLL that is sanctioned by the Cygwin project is the one that you get by running setup-x86.exe or setup-x86_64.exe, installed in a directory controlled by this program. If you have other versions on your system and desire help from the cygwin project, you should delete or rename all DLLs that are not installed by .

September 22, 2020

Version 2.12.0

ACR

• Fix #14811 Add support for dockerignore override

AKS

• CLI should tolerate empty kubeconfig
• FIX #12871: az aks enable-addons: Autogenerated help example is wrong for vitual-node option
• Remove legacy aci connector actions
• Support azure policy addon in azure-cli
• Fix case sensitive issue for AKS dashboard addon
• Update mgmt-containerservice to 9.4.0 and enable 09-01 API

APIM

• Support product / productapi / namedValue entity commands && bump sdk version

App Config

• Support enabling/disabling PublicNetworkAccess for existing stores

App Service

• Add support for Premium V3 pricing tier
• Fix #12653: az webapp log config --application-logging false doesn't turn it off
• Fix #14684: access-restriction remove by ip address does not work; #13837-az webapp create - Example for different RSgroups for Plan and WebApp
• functionapp: Add support for custom handlers. Deprecated Powershell 6.2.
• functionapp: Fix issue where app setting was being incorrectly set for linux custom images

ARM

• : Show "Ignore" resource changes last

Compute

• Add new license_type in vm create/update: RHEL_BYOS, SLES_BYOS
• Upgrade disk API version to 2020-06-30
• disk create: add --logical-sector-size, --tier
• disk update: Support --disk-iops-read-only, --disk-mbps-read-only, --max-shares
• New command disk-encryption-set list-associated-resources
• vm boot-diagnostics enable: --storage becomes optional
• New command: vm boot-diagnostics get-boot-log-uris
• vm boot-diagnostics get-boot-log: support managed storage

Config

• Rename local-context to config param-persist

Cosmos DB

• Support for Migration APIs for Throughput resource for Autoscale feature in CosmosDB

Eventhub

Added Cluster commands and trusted_service_access_enabled parameter for Networkruleset

Extension

• : Add option to update the extension if already installed
• Turn on dynamic install by default

IoT

• Enabled minimum TLS version on IoT Hub Create

IoT Central

• App delete operation is now long running operation

Iot Hub

• Deprecated 'show-connection-string' command

Key Vault

• Managed HSM public preview
• Fix the issue that does not take effect while listing resources or resource versions

Kusto

Monitor

• : expose detailed error message to customers

Network

• : Support --disable-private-endpoint-network-policies and --disable-private-link-service-network-policies
• Fix bug while updateing flow-log when its subproperty network_watcher_flow_analytics_configuration is None
• API version bump to 2020-06-01
• Support --tcp-port-behavior while configuring a TCP configuration of a Connection Monitor V2
• Support more types and coverage level while creating Endpoint of Connection Monitor V2
• Support --host-subnet to create VirtualHub underneath as VirtualRouter

RDBMS

• Management Plane updates for PostgreSQL and MySQL

Role

• : Support , and
• : Support to delete specific

Service Fabric

• Add managed cluster and node type commands

SQL

• Upgrade azure-mgmt-sql to 0.20.0
• Add backup storage redundancy optional parameter to MI create cmdlet

Storage

• : Get the usage bytes of the data stored on the share.
• GA release storage blob PITR
• : Support Azure Storage Query Acceleration
• Support Soft Delete for file share
• : Add account credentials support and deprecate , ,
• : Add container delete retention policy support

Synapse

• Fixed typo in example of az synapse role assignment create and delete

August 28, 2020

Version 2.11.1

ACR

• Add Isolated Tier to Agent Pool
• Add OCI Artifact Source Context

AKS

• Fix aks cluster create issue

Cognitive Services

• [BREAKING CHANGE] Show additional legal term for certain APIs

Network

• [BREAKING CHANGE] Allow to create both public and private IP while creating an Application Gateway
• : add details on location parameter use to the help message

Storage

• : Support OR properties with new api version

August 25, 2020

Version 2.11.0

AKS

• Remove preview tag from Virtual Node add-on
• Add AKS CMK argument in cluster creation
• Set network profile when using basic load balancer.
• Remove max pods validation from CLI and let preflight handle it
• Fixing add-ons available in the help message in
• Bring in support for cluster autoscaler profile in core CLI

AppService

• : Add list-instances command
• : Add --instance parameter to connect to a specific instance
• : Add --instance parameter to connect to a specific instance
• Fix #14758: az webapp create errors when creating windows app with --runtime dotnetcore
• Fix #14701: Implement functionapp create --assign-identity
• Fix #11244: : Add optional parameter to update client-secret-certificate-thumbprint
• : Added commands that allow users to manage their function app keys
• : Added commands that allow users to manage their individual functions
• : Added commands that allow users to manage their function keys
• Fix #14788: az webapp create not getting correct webapp when names are substrings
• : Removed ability to create 2.x Functions in regions that don't support it

ARM

• : Extend the return data of , and
• : Add parameter to support using the latest api-version whether this version is preview

ARO

• CLI enhancements, including route table checking permissions

Cloud

• : Fix registering clouds with a config file

Compute

• Update VM SKUs that support accelerated networking
• : Automatic in-guest patching
• : Add --vm-size, --os-disk-size, --vnet, --subnet
• New command az vm assess-patches

Container

• Fix #6235: Update help text for ports parameter in container create

Datalake Store

• Fix issue #14545 for data lake join operation

EventHub

• : Change documentation of destination_name

Extension

• Add command to list all available versions of an extension

HDInsight

• Support creating cluster with autoscale configuration and Support managing autoscale configuration
• Support creating cluster with encryption at host

IoTCentral

• CLI documentation improvements

Monitor

• : support RG and Sub as the scope values

NetAppFiles

• [BREAKING CHANGE] az netappfiles snapshot create: Removed file-system-id from parameters
• [BREAKING CHANGE] az netappfiles snapshot show: Snapshot no longer has parameter file-system-id
• : Model ActiveDirectory has a new parameter backup_operators
• : Model dataProtection has a new parameter snapshot
• : Model Volume has a new parameter snapshot_directory_visible

Network

• : export FQDN for MX, PTR, NS and SRV type instead of relative path
• Support private link for managed disks
• : Add example to demonstrate certificate format
• : support app configuration

RBAC

• : support specify description when creating a group
• : print human readable message instead of exception when assignableScope is an empty array
• [BREAKING CHANGE] : change default permission of created certificate

SQL

• : Add sql server auditing support

Storage

• : Fix #6018 for --source-sas
• : Support storage account object replication policy
• Fix issue #14083 to upgrade azure-multiapi-storage package version for package issue and new api version support
• : add examples for --ip and refine error message
• : Fix next_marker issue

Synapse

• Add workspace, sparkpool, sqlpool related cmdlets
• Add spark job releated commands based on track2 sdk
• Add accesscontrol feature related commands based on track2 sdk

Upgrade

• Add command to upgrade azure cli and extensions

August 11, 2020

Version 2.10.1

App Service

• Fix #9887 webapp and functionapp, support assigning/removing user managed identity
• Fix #1382, #14055: Update error messages for az webapp create and az webapp config container set
• : Fix default ASP selection logic when --plan parameter is not provided

AppConfig

• Support enabling/disabling PublicNetworkAccess during store creation

Compute

• Support associating disk and snapshot with a disk-access resource

Lab

• Fix for issue #7904 date validation bug in lab vm creation

Storage

• : Fix issue #14660 with unpositional arguments

August 04, 2020

Version 2.10.0

AKS

• : Change --enable-aad argument to migrate a RBAC-enabled non-AAD cluster to a AKS-managed AAD cluster
• : Add --kubelogin-version and --kubelogin-install-location arguments to install kubelogin
• Add az aks nodepool get-upgrades command

AMS

• Fix #14021: az ams account sp is not idempotent

APIM

• apim api import: support API import and enchance other api level cli commands

App Service

• Fix #13035: Add validation for az webapp config access-restriction to avoid adding duplicates

AppConfig

• Default to standard sku if not specified
• [BREAKING CHANGE] Support settings with JSON content type

ARM

• : Fix the bug of managedApp tagging and some related test issues
• : Add support to management group and tenant level deployment What-If
• : Add --confirm-with-what-if/-c parameter.
• : Add --what-if-result-format/-r parameter.
• : Add --what-if-exclude-change-types/-x parameter.
• : az tag support for resource id parameter

Backup

• Trigger AFS container/item discovery only when needed

CDN

• Add private link fields to origin

Compute

• : Select a valid username for user if the default username is invalid
• : support cross tenant image
• : Add new command group to operate disk access resource
• Support dedicated host group automatic placement
• Support ppg and spg in VMSS orchestration mode

Config

• : Add new command module

Extension

• Support automatically installing an extension if the extension of a command is not installed

HDInsight

• Add 3 parameters to the command to support private link and encryption in transit feature:

Iot Hub

• Fix #7792: IoT Hub Create is not idempotent

IoT Central

• Add paramater option list for iot central

KeyVault

• : add parameter for explicitly specifing the type of original data

Monitor

• : support event hub namespace as the destination.
• : support namespace and dimensions for --condition

NetAppFiles

• : Add Volume Revert to revert a volume to one of its snapshots.
• [BREAKING CHANGE] Remove .
• : Add site to Active Directory Properties

Network

• : support to specify an existing subnet by ID
• : support version and type

Storage

• Fix #10302: Support guess content-type when synchronizing files
• : Apply new api version for blob lease operations
• : Support AAD credential in managing access control for ADLS Gen2 account
• : add --access-tier to support access tier

July 16, 2020

Version 2.9.1

AKS

• Remove explicit setting of VMSS in Windows example command since it is now default

IoT

• [BREAKING CHANGE] : Remove IoT PNP preview commands from core CLI

REST

• Fix #14152: : Accept ARM URLs without subscription ID

Storage

• Fix #14138: Make some permissions optional

July 14, 2020

Version 2.9.0

ACR

• Handle log artifact link from Registry to stream logs
• Deprecate helm2 commands

AKS

• : add --enable-aad argument
• : add --enable-aad argument

APIM

• Added general az apim api commands

AppConfig

• Add example for using --fields in appconfig revision

AppService

• : Added support for Java 11 and Powershell 7. Added Stacks API Support.
• Fix #14208 multi-container app creation fails
• Fix az webapp create - use hardcoded runtime stacks

ARM

• : Fix the problem of tagging resources with resource type

Compute

• Bump version disks 2020-05-01, compute 2020-06-01
• Double encryption of disk encryption set
• : support specify cross tenant image.
• : support specify cross tenant image.
• vm/vmss create: Encryption of cache & data-in-transit for OS/Data disks and temp disks for VM & VMSS
• Add simulate-eviction operation for VM and VMSS

CosmosDB

• Recent features: Autoscale, IpRules, EnableFreeTier and EnableAnalyticalStorage

EventGrid

• Add CLI support for 2020-04-01-preview and mark preview features with is_Preview=True

Find

• Fix #14094 az find Fix Queries failing when not logged in and when telemetry is disabled

HDInsight

• Add two commands to support hdinsight node reboot feature

Monitor

• Remove preview flag for commands under Log Analytics workspace
• : Support diagnositc settings for subscription
• : support ',' and '|' in metric name
• : support log analytics data export

Network

• : Deprecating the --public-ip-address parameter
• Bump azure-mgmt-network to 11.0.0
• : support routing configuration
• : Support Azure network virtual appliance.
• Application Gateway support private link feature

PolicyInsights

• : add trigger-scan command to trigger policy compliance evaluations
• : expose versions of policy entities in each compliance record

Profile

• : Show expiresOn for Managed Identity

RDBMS

• Support Minimum TLS version
• Add Infrastructure Encryption for Azure Postgres and MySQL

Security

• Add allowed_connections commands
• Add Adaptive network hardeningss commands
• Add adaptive_application_controls commands
• Addition of az security iot-solution/ iot-alerts/iot-recommendations/iot-analytics REST to Azure CLI
• Add regulatory compliance CLI

SignalR

• Add features including managing private endpoint connections, network rules and upstream

SQL

• , : Add parameter to support resource tagging
• : Support failover from primary or secondary point

Storage

• : Add --allow-blob-public-access to allow or disallow public access for blob and containers
• : Add to support setting the minimum TLS version to be permitted on requests to storage.
• Remove check in token credential
• Fix the storage account name in examples

Webapp

• Bugfix: az webapp log deployment show - return deployment logs instead of log metadata
• Bugfix: az webapp vnet-integration add - fix error handling if bad vnet name, support vnet resource ID

June 23, 2020

Version 2.8.0

ACR

• Add support for region endpoint disable / routing disable
• [BREAKING CHANGE] does not accept username and password

ACS

• Remove private cluster and 2019-10-27-preview API

AKS

• Support --yes for az aks upgrade
• Revert "change default vm sku to Standard_D2s_v3 (#13541)"
• Add "az aks update --uptime-sla"
• Fix typo in az aks update command
• Change to support 0 node agent pool and block manual scale for CAS enabled pool
• Fix typo on VirtualMachineScaleSets and update references to Kubernetes versions

AMS

• CHANGE help text for "--expiry" parameter.

AppService

• : Show the latest deployment log, or the deployment logs of a specific deployment if deployment-id is specified
• : List of deployment logs available
• Fix: Surface error when invalid webapp name provided
• Fix #13261 az webapp list-runtimes use static list until new Available Stacks API is available
• : Fix create issue #13361
• : Fix change of SDK #13140.
• Fix webapp/slot creation for Windows Containers
• : Add optional parameter to update runtime-version
• Support list, delete, approve and reject private endpoint connection for webapp in CLI
• Fix #13888 : Add support for Static WebApps: get, list, create commands
• Improved error messages for SSH Tunnel Connection

ARM

• : Add examples for -h
• : Add --exclude-change-types/-x parameter.
• : Add --what-if-exclude-change-types/-x parameter.
• : Show error messages in a better format.
• : Add new parameters and to support skip parameterization
• Add az feature unregister api

ARO

• Add Public, Private to params for help with ingress/apiserver visibility

Batch

• : Add new parameter
• : Add new parameter
• : Add new parameter
• [BREAKING CHANGE] az batch pool create: When creating a pool using a custom image, the --image property of can now only refer to a Shared Image Gallery image.
• [BREAKING CHANGE] az batch pool create: When creating a pool with --json-file option and specifying a networkConfiguration, the publicIPs property has moved in to a new property publicIPAddressConfiguration. This new property also supports a new ipAddressProvisioningType property which specifies how the pool should allocate IP's and a publicIPs property which allows for configuration of a list of PublicIP resources to use in the case ipAddressProvisioningType is set to UserManaged
• : Add support for the Microsoft.Batch batchAccount resource
• : Add support for the Microsoft.Batch batchAccount resource

CDN

• : Add BYOC support.
• : Fix enabling custom HTTPS with CDN managed certificates for Standard_Verizon and Standard_Microsoft SKUs.

Cognitive Services

• [BREAKING CHANGE] now have a unified structure for all commands.
• : Add identity management for Cognitive Services.

Compute

• : Upgrade API version to 2020-02-14
• : Add to support identity configuration
• : Support Windows update customizer
• New command
• Show a warning when a user deploys a VMSS pinned to a specific image version rather than latest

Cosmos DB

• : Add exists command to database and container groups
• Allow creating fixed collections

EventHub

• : Add managed identity parameters

Extension

• Add --version to support to install from a specific version
• Enable CLI extensions to include packages in the 'azure' namespace

Iot Hub

• [BREAKING CHANGE] az iot hub job: Remove deprecated job commands

KeyVault

• : Supports importing from strings via two new parameters.
• Support string/bytes encryption and decryption with stored keys

Monitor

• Support no wait for cluster creation
• : Support new commands for saved search

Network

• : Refine help message and add examples.
• : Support --nsg argument
• : Support create lb backend pool with backend address.
• : Fix for --add argument

RBAC

• : Support name with space, slash and back slash
• : Refine error message when user specify an invalid scope

Security

• Add security assessment commands

SQL

• : update/show long term retention policy, show/delete long term retention backups, restore long term retention backup

Storage

• Fix authentication issue to support get token for --subscription
• : Fix issue #13459 to raise exception for operation failure
• Fix issues #13012, #13632 and #13657 to remove unused arguments for generate-sas related commands
• : Add check for logging version
• : Add more properties for blob with track 2 SDK
• Fix #13708: Refine warning message for credential
• : Add NFS protocol and root squash support
• : Add support for double encryption
• [BREAKING CHANGE] : make --expiry and --permissions required
• : Migrate to Track 2 to support setting rehydrate priority

June 02, 2020

Version 2.7.0

ACR

• Fix a typo in an error message of token creation

AKS

• Change default vm sku to Standard_D2s_v3
• Fix creating role assignment for MSI clsuter plus custom subnet

AppService

• Fix #12739 az appservice list-locations returns some invalid locations

ARM

• : Fix issue #13159 of incorrect message of JSON after removing comments and compressing
• : Fix issue #13255 of tagging resources with resource type
• Improve the examples for the resource module

ARO

• Change CLIError to correct flag for --worker-vm-disk-size-gb

EventHub

• Fix for issue #12406 Argument --capture-interval does not update the "intervalInSeconds"

HDInsight

• Change get_json_object to shell_safe_json_parse

Monitor

• : refine several help messages
• : support --export-to-resource-specific argument
• Support LA workspace recover

Network

• : support - character
• : change the --sa-lifetime and --sa-max-size to larger values in example
• Bump network to 2020-04-01
• : support event grid
• : fix bug that cannot list routes as table

Packaging

RBAC

• : modify credential generation to avoid troublesome special characters

Redis

• Fix #13529: Change documentation of parameter enable_non_ssl_port

Storage

• : Add parameter to support symlinks
• Enable local context for storage account
• : Fix issue #11969 to refine error message

May 19, 2020

Version 2.6.0

ACR

• Add default timeout of 5 minutes for any requests to ACR
• Support disable public network access
• : expose --days argument
• : accept --source argument values which contain login in server name through client end correction

ACS

• Bug fix: remove fields cleanup for fields that no longer exist

AKS

• Update uptime-sla command help context
• Remove range check for updating min count for autoscaler
• Fix that cli doe not fail when user only specifies Windows password

AMS

• : Add ability to create a transform with a FaceDetector preset
• : Add ability to create a FairPlay content key policy with an offline rental configuration

AppConfig

• Bug fix for list key values with fields

AppService

• : AzureWebJobsDashboard will only be set if AppInsights is disabled
• Fix #10664- VNet Integration - Location Check Issue & fix #13257- az webapp up failing when RG needs to be created
• : Lookup key vault across resources groups in subscription and improve help and examples.
• Onboard local context for app service

ARM

• : Fix the problem that the templateLink will not be returned when deploying or validating template-uri
• : Fix the problem that deployment/validate does not support specially encoded character
• : Fix array alignment and error handling
• : Modify the deprecate information

ARO

• Add examples to az aro create, list, list-credentials, show, delete
• Add generate_random_id function

Backup

• Allow FriendlyName in enable protection for AzureFileShare command
• Fix in IaasVM restore-disks Command
• Add "MAB" BackupManagementType to item list command
• Add support for retrying policy update for failed items.
• Add Resume Protection functionality for Azure Virtual Machine
• Add support to specify ResourceGroup for storing instantRP during Create or Modify Policy

CI

Compute

• New command az vm auto-shutdown
• : Update --zone behavior, return all type skus now

Core

• Update local context on/off status to global user level

Extension

• : Add --system to enable installing extensions in a system path
• Support .egg-info to store wheel type extension metadata

IoT

• : Update the IoT command module first run extension awareness message to the accurate, non-deprecated modern Id .

IoT Hub

• Support for 2020-03-01 API and Network Isolation commands

NetAppFiles

• : Adds snapshot-id as a parameter to create volume this will allow users to create a volume from existing snapshot.

Network

• Fix ttl value changed unintended for dns add-record
• : Inform customers of a coming breaking change
• Support generic commands for private link scenario
• : Support mysql, postgre and mariadb types
• : Support cosmosdb types
• : deprecate --group-ids and redirect to --group-id

Output

• Show update instruction in find, feedback and --help

Packaging

• Build MSI/Homebrew packages with dependecies resolved from requirements.txt

RBAC

• : fix weak credential generation

Storage

• : Add File Properties Support for Storage Account
• : Fix #13373 by adding validator for public access
• Add ADLS Gen2 track2 support
• : Support
• : Fix the incorrect error message when azcopy cannot find the installation location

April 30, 2020

Version 2.5.1

ACR

• : Fix "DOCKER_PULL_ERROR" on Windows

Compute

• : Error handling
• Fix a bug of vm create if endpoint_vm_image_alias_doc is not set in cloud profile
• : Add --os-disk-size-gb

Cosmos DB

• : add --enable-public-network support

Extension

• Fix loading wrong metadata for wheel type extension

Packaging

• Add az script for Git Bash/Cygwin on Windows

SQL

• : Add instance pools command group

Storage

• Upgrade package azure-multiapi-storage to 0.3.0
• Support GZRS for storage account creation and update
• : Add support for grs/gzrs storage account failover
• : Add --encryption-scope parameter to support specifying encryption scope information

April 28, 2020

Version 2.5.0

ACS

• [BREAKING CHANGE] az openshift create: remove --vnet-peer parameter.
• : add flags to support private cluster.
• : upgrade to API version.
• : add command.

AKS

• : Add support for Windows

AppService

• : remove sleep after request.get()

ARM

• Add template deployment What-If commands

ARO

CI

• Onboard pytest and deprecate nose for Automation Test

Compute

• : fix data disk NoneType issue
• : Support showing VM list
• : Fix display problem of table format

KeyVault

• Add new parameter during creating or updating

Monitor

• Support LA cluster CMK features
• : supports BYOS features

Network

• : support security partner provider

Privatedns

• Add feature in private DNS zone to import export zone file

April 21, 2020

Version 2.4.0

ACR

• : disable working directory override
• Support dedicated data endpoint

AKS

• should show privateFqdn as fqdn for private clusters
• Add --uptime-sla
• Update containerservice package
• Add node public IP support
• Fix typo in the help command

AppConfig

• Resolve key vault reference for kv list and export commands
• Bug fix for list key values

AppService

• : Changed the way linuxFxVersion was being set for dotnet linux function apps. This should fix a bug that was preventing dotnet linux consumption apps from being created
• [BREAKING CHANGE] : fix to keep existing AppSettings with az webapp create
• [BREAKING CHANGE] : fix to create RG for az webapp up command when using -g flag
• [BREAKING CHANGE] : fix to show values for non-JSON output with az webapp config connection-string list

ARM

• : Add parameter to support skipping the prompt of missing parameters for ARM template
• : Support comments in deployment parameter file
• : Remove for parameter
• : Support cancel deployment for ARM template
• : Improve the error message when deployment verification fails
• : Add new commands for DeploymentScripts
• : Add parameter to support adding tags to resource incrementally

ARO

• : Add Azure RedHat OpenShift V4 aro command module

Batch

Compute

• : Add storage account type Premium_LRS
• : Fix terminate notification update issue
• : Add support for specialized image version
• SIG API Version 2019-12-01
• : Add --target-region-encryption
• Fix tests fail when running in serial due to keyvault name is duplicated in global in-momery cache

CosmosDB

• Support

IoT Central

• Deprecate
• Add command module

Monitor

• Support private link scenario for monitor
• Fix wrong mocking way in test_monitor_general_operations.py

Network

• Deprecate sku for public ip update command
• : Support private dns zone group
• Enable local context feature for vnet/subnet parameter
• Fix wrong usage example in test_nw_flow_log_delete

Packaging

• Drop support for Ubuntu/Disco package

RBAC

• : support --optional-claims as a parameter

RDBMS

• Add Azure active directory administrator commands for PostgreSQL and MySQL

Service Fabric

• Fix #12891: removes old parameters that are not in the request
• Fix #12470 az sf create cluster, fix bugs in update durability and reliability and find vmss correctly through the code given a node type name

SQL

• Add , ,
• : update/show long term retention policy, show/delete long term retention backups, restore long term retention backup

Storage

• Upgrade azure-mgmt-storage to 9.0.0
• : Support turning off logging for a storage account
• : Enable key auto-rotated for CMK
• : Add support to customize encryption scope
• : Add --default-encryption-scope and --deny-encryption-scope-override to set encryption scope for container level

Survey

• Add switch to turn off survey link

April 01, 2020

Version 2.3.1

ACR

• Fix wrong version of azure-mgmt-containerregistry for Linux

Profile

• az login: Fix login failure with cloud profiles other than

March 31, 2020

Version 2.3.0

ACR

• 'az acr task update': null pointer exception
• : Modify help and error message to clarify the usage of --source and --registry
• Add a validator for argument 'registry_name'
• :Remove the preview flag on '--expose-token'
• [BREAKING CHANGE] 'az acr task create/update' Branch parameter is removed
• 'az acr task update' Customer now can update context, git-token, and or triggers individually
• 'az acr agentpool': new feature

AKS

• Fix apiServerAccessProfile when updating --api-server-authorized-ip-ranges
• aks update: Override outbound IPs with input values when update
• Do not create SPN for MSI clusters and support attach acr to MSI clusters

AMS

• Fix #12469: adding Fairplay content-key-policy fails due to problems with 'ask' parameter

AppConfig

• Add --skip-keyvault for kv export

AppService

• Fix #12509: Remove the tag to az webapp up by default
• az functionapp create: Updated --runtime-version help menu and added warning when user specifies --runtime-version for dotnet
• az functionapp create: Updated the way javaVersion was being set for Windows function apps

ARM

• az deployment create/validate: Use --handle-extended-json-format by default
• az lock create: Add examples of creating subresource in the help documentation
• az deployment {group/mg/sub/tenant} list: Support provisioningState filtering
• az deployment: Fix the parse bug for comment under the last argument

Backup

• Added multiple files restore capabilities
• Added support for Backing up OS Disks only
• Added restore-as-unmanaged-disk parameter to specify unmanaged restore

Compute

• az vm create: Add NONE option of --nsg-rule
• az vmss create/update: remove vmss automatic repairs preview tag
• az vm update: Support --workspace
• Fix a bug in VirtualMachineScaleSetExtension initialization code
• Upgrade VMAccessAgent version to 2.4
• az vmss set-orchestration-service-state: support vmss set orchestration service state
• Upgrade disk API version to 2019-11-01
• az disk create: add --disk-iops-read-only, --disk-mbps-read-only, --max-shares, --image-reference, --image-reference-lun, --gallery-image-reference, --gallery-image-reference-lun

Cosmos DB

• Fix missing --type option for deprecation redirections

Docker

• Update to Alpine 3.11 and Python 3.6.10

Extension

• Allow to load extensions in the system path via packages

HDInsight

• (az hdinsight create:) Support customers specify minimal supported tls version by using parameter . The allowed value is 1.0,1.1,1.2

IoT

• Add codeowner
• az iot hub create : Change default sku to S1 from F1
• iot hub: Support IotHub in the profile of 2019-03-01-hybrid

IoTCentral

• Update error details, update default application template and prompt message

KeyVault

• Support certificate backup/restore
• keyvault create/update: Support --retention-days
• No longer display managed keys/secrets while listing
• az keyvault create: support , and for specifying network rules while creating vault

Lock

• az lock delete fix bug: az lock delete does not work on Microsoft.DocumentDB

Monitor

• az monitor clone: support clone metric rules from one resource to another
• Fix IcM179210086: unable to create custom metric alert for their Application Insights metric

NetAppFiles

• az volume create: Allow data protection volumes adding replication operations: approve, suspend, resume, status, remove

Network

• az network application-gateway waf-policy managed-rule rule-set add: support Microsoft_BotManagerRuleSet
• network watcher flow-log show: fix wrong deprecating info
• support host names in application gateway listener
• az network nat gateway: support create empty resource without public ip or public ip prefix
• Support vpn gateway generation
• Support in

Packaging

• Drop support for python 3.5

Profile

• az login: Show warning for MFA error

RDBMS

• Add server data encryption key management commands for PostgreSQL and MySQL

March 10, 2020

Version 2.2.0

ACR

• Fix: wrongly raise error
• Add new command
• Add private link and CMK support
• add 'private-link-resource list' command

AKS

• fix the aks browse in cloud shell
• az aks: Fix monitoring addon and agentpool NoneType errors
• Add --nodepool-tags to node pool when creating azure kubernetes cluster
• Add --tags when adding or updating a nodepool to cluster
• aks create: add
• add --nodepool-labels when creating azure kubernetes cluster
• add --labels when adding a new nodepool to azure kubernetes cluster
• add missing / in the dashboard url
• Support create aks clusters enabling managed identity
• az aks: Validate network plugin to be either "azure" or "kubenet"
• az aks: Add aad session key support
• [BREAKING CHANGE] az aks: support msi changes for GF and BF for omsagent (Container monitoring)(#1)
• az aks use-dev-spaces: Adding endpoint type option to the use-dev-spaces command to customize the endpoint created on an Azure Dev Spaces controller

AppConfig

• Unblock using "kv set" to add keyvault reference and feature …

AppService

• az webapp create : Fix issue when running the command with --runtime
• az functionapp deployment source config-zip: Add an error message if resource group or function name are invalid/don't exist
• functionapp create: Fix the warning message that appears with today which cites a flag but erroneously uses a instead of a in the flag name
• az functionapp create: Updated the way linuxFxVersion and container image name were being set for linux function apps
• az functionapp deployment source config-zip: Fix an issue caused by app settings change racing condition during zip deploy, giving 5xx errors during deployment
• Fix #5720946: az webapp backup fails to set name

ARM

• az resource: Improve the examples of the resource module
• az policy assignment list: Support listing policy assignments at Management Group scope
• Add and for template deployment at resource groups. This is a duplicate of and
• Add and for template deployment at subscription scope. This is a duplicate of and
• Add and for template deployment at management groups
• Add and for template deployment at tenant scope
• az policy assignment create: Add a description to the parameter
• az group deployment create: Add parameter to support cross tenants

CDN

Compute

• az sig image-version: add --data-snapshot-luns
• az ppg show: add --colocation-status to enable fetching the colocation status of all the resources in the proximity placement group
• az vmss create/update: support automatic repairs
• [BREAKING CHANGE] az image template: rename template to builder
• az image builder create: add --image-template

Cosmos DB

• Add Sql stored procedure, udf and trigger cmdlets
• az cosmosdb create: add --key-uri to support adding key vault encryption information

KeyVault

• keyvault create: enable soft-delete by default

Monitor

• az monitor metrics alert create: support in

Network

• az network application-gateway rewrite-rule create: support url configuration
• az network dns zone import: --zone-name will be case insensitive in the future
• az network private-endpoint/private-link-service: remove preview label
• az network bastion: support bastion
• az network vnet list-available-ips: support list available ips in a vnet
• az network watcher flow-log create/list/delete/update: add new commands to manage watcher flow log and exposing --location to identify watcher explicitly
• az network watcher flow-log configure: deprecated
• az network watcher flow-log show: support --location and --name to get ARM-formatted result, deprecated old formatted output

Policy

• az policy assignment create: Fix the bug that automatically generated name of policy assignment exceeds the limit

RBAC

• az ad group show: fix --group value treated as regex problem

RDBMS

• Bump the azure-mgmt-rdbms SDK version to 2.0.0
• az postgres private-endpoint-connection: manage postgres private endpoint connections
• az postgres private-link-resource: manage postgres private link resources
• az mysql private-endpoint-connection: manage mysql private endpoint connections
• az mysql private-link-resource: manage mysql private link resources
• az mariadb private-endpoint-connection: manage mariadb private endpoint connections
• az mariadb private-link-resource: manage mariadb private link resources
• Updating RDBMS Private Endpoint Tests

SQL

• Sql midb Add: list-deleted, show-deleted, update-retention, show-retention
• (sql server create:) Add optional public-network-access 'Enable'/'Disable' flag to sql server create
• (sql server update:) make some customer-facing change
• Add minimal_tls_version property for MI and SQL DB

Storage

• az storage blob delete-batch: Misbehaving flag
• az storage account network-rule add (bug fix): add operation should be idempotent
• az storage account create/update: Add Routing Preference support
• Upgrade azure-mgmt-storage version to 8.0.0
• az storage container immutability create: add --allow-protected-append-write parameter
• az storage account private-link-resource list: Add support to list private link resources for storage account
• az storage account private-endpoint-connection approve/reject/show/delete: Support to manage private endpoint connections
• az storage account blob-service-properties update: add --enable-restore-policy and --restore-days
• az storage blob restore: Add support to restore blob ranges

February 18, 2020

Version 2.1.0

ACR

• Add a new argument for
• Fix the incorrect output of
• az acr login: Throw a CLIError if there are errors returned by docker command

ACS

• aks create/update: add validation

Aladdin

• Parse generated examples into commands' _help.py

AMS

AppConfig

• Revise help message to exclude unsupported key/label filter
• Remove preview tag for most commands excluding managed identity and feature flags
• Add customer managed key when updating stores

AppService

• az webapp list-runtimes: Fix the bug for list-runtimes
• Add az webapp|functionapp config ssl create
• Add support for v3 function apps and node 12

ARM

• az policy assignment create: Fix the error message when the parameter is invalid
• az group deployment create: Fix "stat: path too long for Windows" error when using large parameters.json file

Backup

• Fix for item level recovery flow in OLR
• Add restore as files support for SQL and SAP Databases

Compute

• vm/vmss/availability-set update: add --ppg to allowing updating ProximityPlacementGroup
• vmss create: add --data-disk-iops and --data-disk-mbps
• az vm host: remove preview tag for and
• [BREAKING CHANGE] Fix #10728: : create subnet automatically if vnet is specified and subnet not exists
• Increase robustness of vm image list

Eventhub

• Azure Stack support for 2019-03-01-hybrid profile

KeyVault

• az keyvault key create: add a new value for parameter
• az keyvault key list-versions: support parameter for specifying keys
• Support private endpoint connections

Network

• Bump to azure-mgmt-network 9.0.0
• az network private-link-service update/create: support --enable-proxy-protocol
• Add connection Monitor V2 feature

Packaging

• [BREAKING CHANGE] Drop support for Python 2.7

Profile

• Preview: Add new attributes and to subscription accounts. Please re-run for the changes to take effect
• az login: Show a warning when a subscription is listed from more than one tenants and default to the first one. To select a specific tenant when accessing this subscription, please include in

Role

• az role assignment create: Fix the error that assigning a role to a service principal by display name yields a HTTP 400

SQL

• Update SQL Managed Instance cmdlet with two new parameters: tier and family

Storage

• [BREAKING CHANGE] : Change default storage account kind to StorageV2

February 04, 2020

Version 2.0.81

ACS

• Add support to set outbound allocated ports and idle timeouts on standard load balancer
• Update to API Version 2019-11-01

ACR

• [BREAKING CHANGE] will prompt
• [BREAKING CHANGE] 'az acr task delete' will prompt
• Add a new command group 'az acr taskrun show/list/delete' for taskrun management

AKS

• Each cluster gets a separate service principal to improve isolation

AppConfig

• Support import/export of keyvault references from/to appservice
• Support import/export of all labels from appconfig to appconfig
• Validate key and feature names before setting and importing
• Expose sku modification for configuration store.
• Add command group for managed identity.

AppService

• Azure Stack: surface commands under the profile of 2019-03-01-hybrid
• functionapp: Add ability to create Java function apps in Linux

ARM

• Fix issue #10246: crashes when the parameter passed in is resource group ID
• Fix issue #11658: command does not support and parameters
• Fix issue #10279: The exit code of is 0 when the verification fails
• Fix issue #9916: Improve the error message of the conflict between tag and other filter conditions for command
• Add new parameter to support adding managedBy information for command

Azure Red Hat OpenShift

• Add subgroup to manage Log Analytics monitoring in Azure Red Hat OpensShift cluster

BotService

• Fix issue #11697: is not idempotent
• Change name-correcting tests to run in Live-mode only

CDN

• Add support for rulesEngine feature
• Add new commands group 'cdn endpoint rule' to manage rules
• Update azure-mgmt-cdn version to 4.0.0 to use api version 2019-04-15

Deployment Manager

• Add list operation for all resources.
• Enhance step resource for new step type.
• Update azure-mgmt-deploymentmanager package to use version 0.2.0.

IoT

• Deprecate 'IoT hub Job' commands.

IoT Central

• Support app creation/update with the new sku name ST0, ST1, ST2.

Key Vault

• Add a new command for downloading keys.

Misc

• Fix #6371: Support filename and environment variable completion in Bash

Network

• Fix #2092: az network dns record-set add/remove: add warning when record-set is not found. In the future, an extra argument will be supported to confirm this auto creation.

Policy

• Add new command to retrieve rich policy metadata resources
• : Specify whether compliance should be re-evaluated prior to remediation with the parameter

Profile

• : Add parameter to acquire token for the tenant directly, needless to specify a subscription

RBAC

• [BREAKING CHANGE] Fix #11883: : empty scope will prompt error

Security

• Add new commands and to view and manage advanced threat protection settings for storage accounts.

SQL

• : deprecate and parameters. These parameters do not apply to DataWarehouse.
• [BREAKING CHANGE] : Remove "WideWorldImportersStd" and "WideWorldImportersFull" as documented allowed values for "az sql db create --sample-name". These sample databases would always cause creation to fail.
• Add New commands and to manage sensitivity classifications for SQL databases.
• : Fix for empty audit actions and groups

Storage

• Add a new command group to use the Microsoft.Storage resource provider for Azure file share management operations.
• Fix issue #11415: permission error for
• Integrate Azcopy 10.3.3 and support Win32.
• : Add , , and parameters
• : Change and parameters to , , and parameters
• : Add , and parameters

ServiceFabric

• Add new commands to manage appliaction and services.

January 13, 2020

Version 2.0.80

Compute

• disk update: Add --disk-encryption-set and --encryption-type
• snapshot create/update: Add --disk-encryption-set and --encryption-type

Storage

• Upgrade azure-mgmt-storage version to 7.1.0
• : Add and to support Table and Queue Encryption Service

January 07, 2020

Version 2.0.79

ACR

• [BREAKING CHANGE] Remove '--os' parameter for 'acr build', 'acr task create/update', 'acr run', and 'acr pack'. Use '--platform' instead.

AppConfig

• Add support for importing/exporting feature flags
• Add new command 'az appconfig kv set-keyvault' for creating keyvault reference
• Support various naming conventions when exporting feature flags to file

AppService

• Fix issue #7154: Updating documentation for command <> to use back ticks instead of single quotes
• Fix issue #11287: webapp up: By default make the app created using up 'should be 'SSL enabled'
• Fix issue #11592: Add az webapp up flag for html static sites

ARM

• Fix : Recovery Services Vault tags cannot be updated

Backup

• Added new command 'backup protection undelete' to enable soft-delete feature for IaasVM workload
• Added new parameter '--soft-delete-feature-state' to set backup-properties command
• Added disk exclusion support for IaasVM workload

Compute

• Fix failure in Azure Stack profile.
• vm monitor metrics tail/list-definitions: support query metric and list definitions for a vm.
• Add new reapply command action for az vm

HDInsight

• Support for creating a Kafka cluster with Kafka Rest Proxy
• Upgrade azure-mgmt-hdinsight to 1.3.0

Misc.

• Add preview command to show the versions of Azure CLI modules and extensions in JSON format by default or format configured by --output

Event Hubs

• [BREAKING CHANGE] Remove 'ReceiveDisabled' status option from command 'az eventhubs eventhub update' and 'az eventhubs eventhub create'. This option is not valid for Event Hub entities.

Service Bus

• [BREAKING CHANGE] Remove 'ReceiveDisabled' status option from command 'az servicebus topic create', 'az servicebus topic update', 'az servicebus queue create', and 'az servicebus queue update'. This option is not valid for Service Bus topics and queues.

RBAC

• Fix #11712: does not return exit code 3 when the application or service principal does not exist

Storage

• : Remove preview flag for --enable-hierarchical-namespace parameter
• Update azure-mgmt-storage version to 7.0.0 to use api version 2019-06-01
• Add new parameters and to support managing delete retention policy for storage account blob-service-properties.

December 17, 2019

2.0.78

ACR

• Added support Local context in acr task run

ACS

• [BREAKING CHANGE]az openshift create: rename to .

AMS

• Updated show commands to return 3 when resource not found

AppConfig

• Fixed bug when appending api-version to request url. The existing solution doesn't work with pagination.
• Added support for showing languages besides English as our backend service support unicode for globalization.

AppService

• Fixed issue #11217: webapp: az webapp config ssl upload should support slot parameter
• Fixed issue #10965: Error: Name cannot be empty. Allow remove by ip_address and subnet
• Added support for importing certificates from Key Vault

ARM

• Updated azure-mgmt-resource package to use 6.0.0
• Cross Tenant Support for command by adding new parameter
• Added new parameter to support adding metadata information for policy set definitions.

Backup

• Added Backup support for SQL and SAP Hana workload.

BotService

• [Breaking change] Remove '--version' flag from preview command 'az bot create'. Only v4 SDK bots are supported.
• Added name availability check for 'az bot create'.
• Added support for updating the icon URL for a bot via 'az bot update'.
• Added support for updating a Direct Line channel via 'az bot directline update'.
• Added '--enable-enhanced-auth' flag support to 'az bot directline create'.
• The following command groups are GA and not in preview: 'az bot authsetting'.
• The following commands in 'az bot' are GA and not in preview: 'create', 'prepare-deploy', 'show', 'delete', 'update'.
• Fixed 'az bot prepare-deploy' changing '--proj-file-path' value to lower case (e.g. "Test.csproj" to "test.csproj").

Compute

• vmss create/update: Added --scale-in-policy, which decides which virtual machines are chosen for removal when a VMSS is scaled-in.
• vm/vmss update: Added --priority.
• vm/vmss update: Added --max-price.
• Added disk-encryption-set command group (create, show, update, delete, list).
• disk create: Added --encryption-type and --disk-encryption-set.
• vm/vmss create: Added --os-disk-encryption-set and --data-disk-encryption-sets.

Core

• Removed support for Python 3.4
• Plug in HaTS survey in multiple commands

DLS

• Updated ADLS sdk version (0.0.48).

Install

• Install script support python 3.8

IOT

• [BREAKING CHANGE] Removed --failover-region parameter from manual-failover. Now it will failover to assigned geo-paired secondary region.

Key Vault

• Fixed #8095: : improve the help message
• Fixed #8921: : fix the validation bug on parameter
• Fixed #10512: : improve the error message when none of , or is specified
• Fixed #10846: : when is specified, is not required
• Fixed #11084: : improve the help message of parameter

Network

• az network application-gateway probe: Added support --port option to specify a port for probing backend servers when create and update
• az network application-gateway url-path-map create/update: bug fix for
• az network application-gateway: Added support
• az network list-service-aliases: Added support list service aliases which can be used for Service Endpoint Policies
• az network dns zone import: Added support .@ in record name

Packaging

• Added back edge builds for pip install
• Added Ubuntu eoan package

Policy

• Added support for Policy API version 2019-09-01.
• az policy set-definition: Added support grouping within policy set definitions with parameter

Redis

• Added preview param to command
• Updated azure-mgmt-redis from 6.0.0 to 7.0.0rc1

ServiceFabric

• Fixed in node-type add logic including #10963: Adding new node type with durability level Gold will always throw CLI error
• Updated ServiceFabricNodeVmExt version to 1.1 in creation template

SQL

• Added "--read-scale" and "--read-replicas" parameters to sql db create and update commands, to support read scale management.

Storage

• GA Release Large File Shares property for storage account create and update command
• GA Release User Delegation SAS token Support
• Added new commands and to manage blob service properties for storage account.
• [COMING BREAKING CHANGE] : character is no longer supported as a wildcard in URL, but new parameters --include-pattern and --exclude-pattern will be added with wildcard support.
• Fixed issue #11043: Added support to remove whole container/share in command

November 26, 2019

Version 2.0.77

ACR

• Deprecated parameter from acr task create/update

Azure Red Hat OpenShift

• Added flag to allow creation of Azure Red Hat Openshift cluster with monitoring
• Added to create Azure Red Hat OpenShift cluster with monitoring

AKS

• Added support cluster certificate rotation operation using "az aks rotate-certs".

AppConfig

• Added support for using ":" for 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.

AppService

• Fixed issue #11100: AttributeError for az webapp up when create service plan
• az webapp up: Forcing the creation or deployment to a site for supported languages, no defaults used.
• Added support for App Service Environment: az appservice ase show | list | list-addresses | list-plans | create | update | delete

Backup

• Fixed issue in az backup policy list-associated-items. Added optional BackupManagementType parameter.

Compute

• Upgraded API version of compute, disks, snapshots to 2019-07-01
• vmss create: Improvement for --orchestration-mode
• sig image-definition create: Added --os-state to allow specifying whether the virtual machines created under this image are 'Generalized' or 'Specialized'
• sig image-definition create: Added --hyper-v-generation to allow specifying the hypervisor generation
• sig image-version create: Added support --os-snapshot and --data-snapshots
• image create: Added --data-disk-caching to allow specifying caching setting of data disks
• Upgraded Python Compute SDK to 10.0.0
• vm/vmss create: Added 'Spot' to 'Priority' enum property
• [Breaking change] Renamed '--max-billing' parameter to '--max-price', for both VM and VMSS, to be consistent with Swagger and Powershell cmdlets
• vm monitor log show: Added support for querying log over linked log analytics workspace.

IOT

• Fix #2531: Added convenience arguments for hub update.
• Fix #8323: Added missing parameters to create storage custom endpoint.
• Fix regression bug: Reverted the changes which overrides the default storage endpoint.

Key Vault

• Fixed #11121: When using , passing now doesn't require a value of or

NetAppFiles

• Upgraded azure-mgmt-netapp to 0.7.0 which includes some additional volume properties associated with upcoming replication operations

Network

• application-gateway waf-config: deprecated
• application-gateway waf-policy: Added subgroup managed-rules to manage managed rule sets and exclusion rules
• application-gateway waf-policy: Added subgroup policy-setting to manage global configuration of a waf-policy
• [BREAKING CHANGE] application-gateway waf-policy: Renamed subgroup rule to custom-rule
• application-gateway http-listener: Added --firewall-policy when create
• application-gateway url-path-map rule: Added --firewall-policy when create

Packaging

• Rewrote the az wrapper in Python
• Added support for Python 3.8
• Changed to Python 3 for RPM package

Profile

• Polished error when running with Microsoft account
• Polished when running behind a proxy with self-signed root certificate
• Fixed #10578: hangs when more than one instances are launched at the same time on Windows or WSL
• Fixed #11059: fails if there are subscriptions in the tenant
• Fixed #11238: After renaming a subscription, logging in with MSI will result in the same subscription appearing twice

RBAC

• Fixed #10996: Polish error for in when is not specified

Redis

• Fixed #2902: Avoid setting memory configs while updating Basic SKU cache

Reservations

• Upgraded SDK Version to 0.6.0
• Added billingplan details info after calling Get-Gatalogs
• Added new command to calculate the price for a reservation
• Added new command to purchase a new reservation

Rest

SQL

• Updated azure-mgmt-sql to version 0.15.0.

Storage

• storage account create: Added --enable-hierarchical-namespace to support filesystem semantics in blob service.
• Removed unrelated exception from error message
• Fixed issues with incorrect error message "You do not have the required permissions needed to perform this operation." when blocked by network rules or AuthenticationFailed.

November 4, 2019

Version 2.0.76

ACR

• Added a preview parameter to command .
• Added support for enabling auditing on creating a registry
• Added support for Repository-scoped RBAC

AKS

• Added , and to the command, which enables cluster autoscaler for the node pool.
• Added the above flags as well as and to the command, allowing updates to cluster autoscaler.

AppConfig

• Added appconfig feature command group to manage feature flags stored in an App Configuration.
• Fixed minor bug for appconfig kv export to file command. Stop reading dest file contents during export.

AppService

• : Added support to set 'persitescaling' on appservice plan create.
• Fixed an issue where webapp config ssl bind operation was removing existing tags from the resource
• Added flag for to support remote build action during function app deployment.
• Changed default node version on function apps to ~10 for Windows
• Added property to

ARM

• : Added parameter to support multiline and comments in json template when deployment.
• Bumped azure-mgmt-resource to 2019-07-01

Backup

• Added AzureFiles backup support

Compute

• : Added warning when specifying accelerated networking and an existing NIC together.
• : Added to specify an existing virtual machine scale set that the virtual machine should be assigned to.
• : Added a local copy of image alias file so that it can be accessed in a restricted network environment.
• : Added to specify how virtual machines are managed by the scale set.
• : Added to allow updating ultra SSD setting.
• [BREAKING CHANGE] : Fixed bug where users could not set an extension on a VM with .
• Added new commands to manage Azure Marketplace image terms.
• Updated VMAccessForLinux to version 1.5

CosmosDB

• [BREAKING CHANGE] : Changed to required parameter
• [BREAKING CHANGE] : Changed to required parameter
• : Added and
• : Updated the default schema
• : Added
• : Updated the default schema
• Fixed typo in help message
• database: Added deprecation information
• collection: Added deprecation information

IoT

• Added new routing source type: DigitalTwinChangeEvents
• Fixed missing features in

Key Vault

• Fixed an unexpected error when certificate file does not exist
• Fixed not working

NetAppFiles

• Upgraded azure-mgmt-netapp to 0.6.0 to use API version 2019-07-01. This new API version includes:

  • Volume creation accepts now "NFSv4.1" not "NFSv4"
  • Volume export policy property now named 'nfsv41' not 'nfsv4'
  • Volume renamed to
  • Snapshot creation date now named just 'created'

Network

• : Support cross-tenant virtual network linking.
• [BREAKING CHANGE] : Changed and to be required now.
• : Added support to specify IP address version (IPv4, IPv6) when creation
• Bumped azure-mgmt-network to 7.0.0 and api-version to 2019-09-01
• : Added support for new service virtual router and virtual router peering
• : Added support for

Profile

• Fixed not working
• Removed warning from

RBAC

• Fixed doesn't work

ServiceFabric

• : Fixed an issue by modifying service fabric linux and windows template.json compute vmss from standard to managed disks

SQL

• Added , , and parameters to support CRUD operations for new SQL Database offering: Serverless compute model.

Storage