Azure CLI tools for Windows
- A Microsoft Azure account.
Use this link to create a free one.
Create your Azure free account today | Microsoft Azure
Get started with 12 months of free services and 200 USD in credit. Create your free account today with Microsoft Azure.
Or else use this link to create one.
Install or update
The MSI distributable is used for installing or updating the Azure CLI on Windows. You don’t need to uninstall current versions before using the MSI installer because the MSI will update any existing version.
When the installer asks if it can make changes to your computer, click
Azure CLI current version
Download and install the current release of the Azure CLI.
Azure CLI beta version
The beta version of the Azure CLI supports all commands and will stay in sync with the current released version. For installation instructions, see Install Azure CLI beta version.
Setting up Azure CLI
- Open the downloaded file.
- Check in the check box
I accept the terms in the License Agreement
- Then click
- Wait till the green color fills in the bar.
- Then click
Run the Azure CLI
You can now run the Azure CLI with the
az command from either Windows Command Prompt or PowerShell. PowerShell offers some tab completion features not available from Windows Command Prompt. To sign in, run the az login command.
- Run the
- Azure CLI
- If the CLI can open your default browser, it will do so and load an Azure sign-in page.
Otherwise, open a browser page at https://aka.ms/devicelogin and enter the authorization code displayed in your terminal.
If no web browser is available or the web browser fails to open, use device code flow with az login — use-device-code.
- Sign in with your account credentials in the browser.
To learn more about different authentication methods, see Sign in with Azure CLI.
Sign in with the Azure CLI
There are several authentication types for the Azure CLI. The easiest way to get started is with Azure Cloud Shell…
- Wait till the page get redirected.
- Once it’s over, you can see this page in the browser.
- Simultaneously in the Windows Command Prompt, you can see the below details too.
If you experience a problem not covered here, file an issue on GitHub.
Proxy blocks connection
If you can’t download the MSI installer because your proxy is blocking the connection, make sure that you have your proxy properly configured. For Windows 10, these settings are managed in the
Settings > Network & Internet > Proxy pane. Contact your system administrator for the required settings, or for situations where your machine may be configuration-managed or require advanced setup.
These settings are also required to be able to access Azure services with the CLI, from both PowerShell or the Command Prompt. In PowerShell, you do this with the following command:
(New-Object System.Net.WebClient).Proxy.Credentials = `
In order to get the MSI, your proxy needs to allow HTTPS connections to the following addresses:
If you found a bug, we'd appreciate it if you file a GitHub issue.
You uninstall the Azure CLI from the Windows “Apps and Features” list. To uninstall:
Start > Settings > AppsWindows 8 and Windows 7Start > Control Panel > Programs > Uninstall a program
Once on this screen type Azure CLI into the program search bar. The program to uninstall is listed as Microsoft CLI 2.0 for Azure. Select this application, then click the
Azure CLI features and common commands.