-
Notifications
You must be signed in to change notification settings - Fork 523
Add Windows zip document #4045
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add Windows zip document #4045
Changes from 18 commits
4783fd7
71ddfad
c951450
6e27b0a
5de3098
42dd90a
2e2552d
14ad7de
8e2a694
0c730e6
d401de5
6a7de88
ab4479f
6d49d04
82fba7d
2fd82e7
81c2e31
ba5edfc
bb80b73
5285214
9f85da2
26c9d6d
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -16,15 +16,15 @@ keywords: Install azure cli, azure cli download, cli for windows, install azure | |
|
|
||
| The Azure Command-Line Interface (CLI) is a cross-platform command-line tool that can be installed locally on Windows computers. You can use the Azure CLI for Windows to connect to Azure and execute administrative commands on Azure resources. The Azure CLI for Windows can also be used from a browser through the Azure Cloud Shell or run from inside a Docker container. | ||
|
|
||
| For Windows, the Azure CLI is installed via an MSI, which gives you access to the CLI through the Windows Command Prompt (CMD) or PowerShell. | ||
| For Windows, the Azure CLI is installed via an MSI or a ZIP package, which gives you access to the CLI through the Windows Command Prompt (CMD) or PowerShell. | ||
| When you perform an installation for Windows Subsystem for Linux (WSL), packages are available for your Linux distribution. See the [main install page](install-azure-cli.md) | ||
| for the list of supported package managers or how to install manually under WSL. | ||
|
|
||
| [!INCLUDE [current-version](includes/current-version.md)] | ||
|
|
||
| ## 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 updates any existing version. | ||
| The MSI and ZIP distributable are 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 updates any existing version. | ||
|
|
||
| > [!IMPORTANT] | ||
| > After the installation is complete, you will need to **close and reopen any active terminal window to use the Azure CLI**. | ||
|
|
@@ -97,6 +97,35 @@ You can also use `winget`, Microsoft's Package manager for Windows, to install a | |
|
|
||
| The `-e` option is to ensure the official Azure CLI package is installed. This command installs the latest version by default. To specify a version, add a `-v <version>` with your desired version to the command. | ||
|
|
||
| # [ZIP Package](#tab/zip) | ||
|
|
||
| > [!IMPORTANT] | ||
| > This package is currently in preview. | ||
|
|
||
| You can use the ZIP package to install the Azure CLI on Windows. This package is useful when you don't have administrative privilege. | ||
|
|
||
| Unzip the package to a folder, then using Cmd or PowerShell, call the Azure CLI by running `<unzipped folder path>\bin\az.cmd`. | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Same as #4045 (comment), I suggest we do mention how to call it if the path contains space - in both CMD and PowerShell.
Contributor
Author
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The space doc is removed for two reasons:
(The command to call path with spaces is not unified in CMD and PS. I want to keep our doc concise. If many users report this issue in the future, we may add it then.)
Collaborator
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I agree with @jiasli. I don't feel it is possible to have too much clarity. Is is possible to have too many words! :-) Our install docs receive the most negative feedback of any doc group in our repo, so I prefer not to wait for a customer complaint. |
||
|
|
||
| If you want to run the `az` command directly, then follow the steps below to add the Azure CLI to your PATH environment variable. | ||
|
bebound marked this conversation as resolved.
Outdated
|
||
| 1. Open the Start Menu and search for `environment variables`. Click `Edit the system environment variables`. | ||
| 1. Click the `Environment Variables...` button. | ||
| 1. In the `User varibles for <username>` box, select `Path` and click the `Edit...` button. | ||
| 1. Click the `New` button and add the `<unzipped folder path>\bin` to the list. | ||
| 1. **Restart your terminal.** You should now be able to run `az` commands. | ||
|
|
||
| ### Latest version | ||
| > [!div class="nextstepaction"] | ||
|
dbradish-microsoft marked this conversation as resolved.
bebound marked this conversation as resolved.
|
||
| > [Latest release of the Azure CLI (64-bit)](https://aka.ms/installazurecliwindowszipx64) | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. |
||
|
|
||
| ### Specific version | ||
|
bebound marked this conversation as resolved.
|
||
| If you prefer, you can download a specific version of the Azure CLI by using a URL. | ||
|
|
||
| To download the ZIP package for a specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/zip/azure-cli-<version>-x64.zip`. | ||
|
|
||
| For example, to install the 64-bit ZIP of Azure CLI version 2.57.0, your URL would be `https://azcliprod.blob.core.windows.net/zip/azure-cli-2.57.0-x64.zip`. | ||
|
|
||
| Available Azure CLI versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). The ZIP package is available from version 2.57.0. Only 64-bit is available. | ||
|
|
||
| --- | ||
|
|
||
| ## Run the Azure CLI | ||
|
|
@@ -148,6 +177,8 @@ If you have issues after migration, you can uninstall the 64-bit and reinstall t | |
|
|
||
| [!INCLUDE [az upgrade](includes/az-upgrade.md)] | ||
|
|
||
| If you are using ZIP distribution, please delete the old installation folder and extract the new version to the _same location_. | ||
|
|
||
| ## Uninstall | ||
|
|
||
| [!INCLUDE [uninstall-boilerplate.md](includes/uninstall-boilerplate.md)] | ||
|
|
||

There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What is changed?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Newline at the end of file is removed accidentally. 😂