From a39257b82ee8a19af43cdba6fe497f633b2adaf1 Mon Sep 17 00:00:00 2001 From: Hang Lei Date: Tue, 27 Jun 2023 16:13:08 +0800 Subject: [PATCH 01/16] Init --- .../install-azure-cli-windows.md | 20 +++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index 8511ed317e..204637a2bc 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -36,11 +36,12 @@ The MSI distributable is used for installing or updating the Azure CLI on Window Download and install the latest release of the Azure CLI. When the installer asks if it can make changes to your computer, click the "Yes" box. > [!div class="nextstepaction"] -> [Latest release of the Azure CLI](https://aka.ms/installazurecliwindows) +> [Latest release of the Azure CLI (32-bit)](https://aka.ms/installazurecliwindows) +> [Latest release of the Azure CLI (64-bit)](https://aka.ms/installazurecliwindowsx64) ### Specific version -To download the MSI installer for specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` and download it. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). +To download the MSI installer for specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. 64-bit version is available from 2.xx. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). # [Microsoft Installer (MSI) with Command](#tab/powershell) @@ -58,9 +59,9 @@ To install the Azure CLI using PowerShell, start PowerShell **as administrator** $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi ``` -This will download and install the latest version of the Azure CLI for Windows. If you already have a version installed, the installer will update the existing version. +This will download and install the latest 32-bit version of the Azure CLI for Windows. If you prefer 64-bit one, please change URL to `https://aka.ms/installazurecliwindowsx64`. If you already have a version installed, the installer will update the existing version. -To install specific version, replace the `-Uri` argument with `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` with version segment changed. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). +To install specific version, replace the `-Uri` argument with `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) with version segment changed. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). ### Azure CLI Command (for update only) @@ -144,6 +145,17 @@ In order to get the MSI, your proxy needs to allow HTTPS connections to the foll * `https://aka.ms/` * `https://azcliprod.blob.core.windows.net/` +### Migrate to 64-bit CLI +Starting from 2.xx, Azure CLI also releases 64-bit version which is recommended for better performance. + +If you are using 32-bit version, you can migrate to 64-bit version by following these steps: +1. Check your current CLI version and installed extensions by running `az --version`. +2. If the extension folder `~\.azure\cliextensions` exists, backup it by renaming it. This folder will be created again after migration. +3. Download and install 64-bit version from [here](https://aka.ms/installazurecliwindowsx64). Please note that this will uninstall 32-bit version automatically. +4. Install extensions by running `az extension add --name --version `. + +If you have any issue after migration, you can roll back to 32-bit version by uninstalling 64-bit version, installing 32-bit one and restoring the extension folder. + ## Uninstall [!INCLUDE [uninstall-boilerplate.md](includes/uninstall-boilerplate.md)] From 5e2fff3737b230f4f3049713ba67f2f0ed20c893 Mon Sep 17 00:00:00 2001 From: Hang Date: Wed, 26 Jul 2023 15:37:38 +0800 Subject: [PATCH 02/16] Minor fix --- docs-ref-conceptual/install-azure-cli-windows.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index 204637a2bc..a8a98d1ec9 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -41,7 +41,7 @@ Download and install the latest release of the Azure CLI. When the installer ask ### Specific version -To download the MSI installer for specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. 64-bit version is available from 2.xx. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). +To download the MSI installer for specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). (64-bit version is available from 2.51.0.) # [Microsoft Installer (MSI) with Command](#tab/powershell) @@ -146,15 +146,15 @@ In order to get the MSI, your proxy needs to allow HTTPS connections to the foll * `https://azcliprod.blob.core.windows.net/` ### Migrate to 64-bit CLI -Starting from 2.xx, Azure CLI also releases 64-bit version which is recommended for better performance. +Starting from 2.51.0, Azure CLI also provides 64-bit version which is recommended for better performance. If you are using 32-bit version, you can migrate to 64-bit version by following these steps: 1. Check your current CLI version and installed extensions by running `az --version`. -2. If the extension folder `~\.azure\cliextensions` exists, backup it by renaming it. This folder will be created again after migration. -3. Download and install 64-bit version from [here](https://aka.ms/installazurecliwindowsx64). Please note that this will uninstall 32-bit version automatically. +2. If the extension folder `%userprofile%\.azure\cliextensions` exists, backup it by renaming. This folder will be created again after migration. +3. Download and install latest 64-bit version from [here](https://aka.ms/installazurecliwindowsx64). Please note that this will uninstall 32-bit version automatically. 4. Install extensions by running `az extension add --name --version `. -If you have any issue after migration, you can roll back to 32-bit version by uninstalling 64-bit version, installing 32-bit one and restoring the extension folder. +If you have any issue after migration, you can uninstall the 64-bit version and reinstall 32-bit one, then restore the extension folder. ## Uninstall From c6c9da3bb5e6291cacc191b7e9b619085978a9b4 Mon Sep 17 00:00:00 2001 From: Hang Date: Wed, 26 Jul 2023 15:44:38 +0800 Subject: [PATCH 03/16] Minor fix --- docs-ref-conceptual/install-azure-cli-windows.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index a8a98d1ec9..fd4dd208f8 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -61,7 +61,7 @@ To install the Azure CLI using PowerShell, start PowerShell **as administrator** This will download and install the latest 32-bit version of the Azure CLI for Windows. If you prefer 64-bit one, please change URL to `https://aka.ms/installazurecliwindowsx64`. If you already have a version installed, the installer will update the existing version. -To install specific version, replace the `-Uri` argument with `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) with version segment changed. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). +To install specific version, replace the `-Uri` argument with `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) with version segment changed. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). (64-bit version is available from 2.51.0.) ### Azure CLI Command (for update only) @@ -145,13 +145,13 @@ In order to get the MSI, your proxy needs to allow HTTPS connections to the foll * `https://aka.ms/` * `https://azcliprod.blob.core.windows.net/` -### Migrate to 64-bit CLI +### Migrate to 64-bit Azure CLI Starting from 2.51.0, Azure CLI also provides 64-bit version which is recommended for better performance. If you are using 32-bit version, you can migrate to 64-bit version by following these steps: 1. Check your current CLI version and installed extensions by running `az --version`. 2. If the extension folder `%userprofile%\.azure\cliextensions` exists, backup it by renaming. This folder will be created again after migration. -3. Download and install latest 64-bit version from [here](https://aka.ms/installazurecliwindowsx64). Please note that this will uninstall 32-bit version automatically. +3. Download and install latest 64-bit version following the [Install or update](#install-or-update) guide. Please note that 32-bit version will be uninstalled automatically. 4. Install extensions by running `az extension add --name --version `. If you have any issue after migration, you can uninstall the 64-bit version and reinstall 32-bit one, then restore the extension folder. From be78f8aacc56513a67ca90740e79b6eafea70e4b Mon Sep 17 00:00:00 2001 From: Hang Date: Tue, 1 Aug 2023 16:02:53 +0800 Subject: [PATCH 04/16] Apply suggestions from code review Co-authored-by: Jiashuo Li <4003950+jiasli@users.noreply.github.com> Co-authored-by: Delora Bradish --- docs-ref-conceptual/install-azure-cli-windows.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index fd4dd208f8..36813a0f1f 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -41,7 +41,7 @@ Download and install the latest release of the Azure CLI. When the installer ask ### Specific version -To download the MSI installer for specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). (64-bit version is available from 2.51.0.) +To download the MSI installer for specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). (64-bit MSI is available from 2.51.0.) # [Microsoft Installer (MSI) with Command](#tab/powershell) @@ -61,7 +61,7 @@ To install the Azure CLI using PowerShell, start PowerShell **as administrator** This will download and install the latest 32-bit version of the Azure CLI for Windows. If you prefer 64-bit one, please change URL to `https://aka.ms/installazurecliwindowsx64`. If you already have a version installed, the installer will update the existing version. -To install specific version, replace the `-Uri` argument with `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) with version segment changed. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). (64-bit version is available from 2.51.0.) +To install specific version, replace the `-Uri` argument with `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) with version segment changed. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). (64-bit MSI is available from 2.51.0.) ### Azure CLI Command (for update only) @@ -146,15 +146,16 @@ In order to get the MSI, your proxy needs to allow HTTPS connections to the foll * `https://azcliprod.blob.core.windows.net/` ### Migrate to 64-bit Azure CLI -Starting from 2.51.0, Azure CLI also provides 64-bit version which is recommended for better performance. + +Starting from 2.51.0, Azure CLI also provides 64-bit MSI which is recommended for better performance. If you are using 32-bit version, you can migrate to 64-bit version by following these steps: 1. Check your current CLI version and installed extensions by running `az --version`. -2. If the extension folder `%userprofile%\.azure\cliextensions` exists, backup it by renaming. This folder will be created again after migration. -3. Download and install latest 64-bit version following the [Install or update](#install-or-update) guide. Please note that 32-bit version will be uninstalled automatically. +2. If the extension folder `%userprofile%\.azure\cliextensions` exists, make a backup by renaming it. This folder will be created again after migration. +3. Download and install latest 64-bit version following the [Install or update](#install-or-update) guide. Please note that 32-bit MSI will be uninstalled automatically. 4. Install extensions by running `az extension add --name --version `. -If you have any issue after migration, you can uninstall the 64-bit version and reinstall 32-bit one, then restore the extension folder. +If you have issues after migration, you can uninstall the 64-bit MSI and reinstall the 32-bit MSI. If you have made a backup of your 32-bit extension folder, restore your extension folder after the change. ## Uninstall From 8591bd768eed200742592f03e3e53e6b31a22e59 Mon Sep 17 00:00:00 2001 From: Hang Date: Tue, 1 Aug 2023 16:04:35 +0800 Subject: [PATCH 05/16] Update docs-ref-conceptual/install-azure-cli-windows.md --- docs-ref-conceptual/install-azure-cli-windows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index 36813a0f1f..4434731fd3 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -59,7 +59,7 @@ To install the Azure CLI using PowerShell, start PowerShell **as administrator** $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi ``` -This will download and install the latest 32-bit version of the Azure CLI for Windows. If you prefer 64-bit one, please change URL to `https://aka.ms/installazurecliwindowsx64`. If you already have a version installed, the installer will update the existing version. +This will download and install the latest 32-bit installer of the Azure CLI for Windows. If you prefer 64-bit one, please change URL to `https://aka.ms/installazurecliwindowsx64`. If you already have a version installed, the installer will update the existing version. To install specific version, replace the `-Uri` argument with `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) with version segment changed. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). (64-bit MSI is available from 2.51.0.) From fd7ce79280f7d9aa113a2379c48890c40db530a3 Mon Sep 17 00:00:00 2001 From: Hang Date: Wed, 2 Aug 2023 15:06:58 +0800 Subject: [PATCH 06/16] Update docs-ref-conceptual/install-azure-cli-windows.md Co-authored-by: Damien Caro --- docs-ref-conceptual/install-azure-cli-windows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index 4434731fd3..c6250b4660 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -151,7 +151,7 @@ Starting from 2.51.0, Azure CLI also provides 64-bit MSI which is recommended fo If you are using 32-bit version, you can migrate to 64-bit version by following these steps: 1. Check your current CLI version and installed extensions by running `az --version`. -2. If the extension folder `%userprofile%\.azure\cliextensions` exists, make a backup by renaming it. This folder will be created again after migration. +2. Extensions will need to be reinstalled. It is recommended to perform a backup of the current extension folder `%userprofile%\.azure\cliextensions` by renaming it in case you need to revert to the 32-bit version. This folder will be created again after migration. 3. Download and install latest 64-bit version following the [Install or update](#install-or-update) guide. Please note that 32-bit MSI will be uninstalled automatically. 4. Install extensions by running `az extension add --name --version `. From 044cdc370225ac3ec79d892c285eca51baee35ca Mon Sep 17 00:00:00 2001 From: Hang Date: Fri, 4 Aug 2023 14:57:56 +0800 Subject: [PATCH 07/16] Update docs-ref-conceptual/install-azure-cli-windows.md Co-authored-by: Delora Bradish --- docs-ref-conceptual/install-azure-cli-windows.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index c6250b4660..1e2f865e25 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -39,6 +39,8 @@ Download and install the latest release of the Azure CLI. When the installer ask > [Latest release of the Azure CLI (32-bit)](https://aka.ms/installazurecliwindows) > [Latest release of the Azure CLI (64-bit)](https://aka.ms/installazurecliwindowsx64) +If you have previously installed the Azure CLI, running either the 32-bit or 64-bit MSI will overwrite an existing installation. + ### Specific version To download the MSI installer for specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). (64-bit MSI is available from 2.51.0.) From 09e3d00e11a09ada5417bd0aa8bd9d4dca13930b Mon Sep 17 00:00:00 2001 From: Hang Date: Fri, 4 Aug 2023 15:06:49 +0800 Subject: [PATCH 08/16] Apply suggestions from code review Co-authored-by: Delora Bradish --- docs-ref-conceptual/install-azure-cli-windows.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index 1e2f865e25..10ec709352 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -61,7 +61,7 @@ To install the Azure CLI using PowerShell, start PowerShell **as administrator** $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi ``` -This will download and install the latest 32-bit installer of the Azure CLI for Windows. If you prefer 64-bit one, please change URL to `https://aka.ms/installazurecliwindowsx64`. If you already have a version installed, the installer will update the existing version. +This will download and install the latest 32-bit installer of the Azure CLI for Windows. If you prefer a 64-bit install, change URL to `https://aka.ms/installazurecliwindowsx64`. If the Azure CLI is already installed, the installer will overwrite the existing version. To install specific version, replace the `-Uri` argument with `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) with version segment changed. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). (64-bit MSI is available from 2.51.0.) @@ -151,13 +151,13 @@ In order to get the MSI, your proxy needs to allow HTTPS connections to the foll Starting from 2.51.0, Azure CLI also provides 64-bit MSI which is recommended for better performance. -If you are using 32-bit version, you can migrate to 64-bit version by following these steps: +Follow these steps to migrate to Azure CLI 64-bit: 1. Check your current CLI version and installed extensions by running `az --version`. -2. Extensions will need to be reinstalled. It is recommended to perform a backup of the current extension folder `%userprofile%\.azure\cliextensions` by renaming it in case you need to revert to the 32-bit version. This folder will be created again after migration. -3. Download and install latest 64-bit version following the [Install or update](#install-or-update) guide. Please note that 32-bit MSI will be uninstalled automatically. +1. Extensions will need to be reinstalled. It is recommended to perform a backup of the current extension folder `%userprofile%\.azure\cliextensions` by renaming it in case you choose to revert back to 32-bit. This folder is created automatically when you reinstall an extension. +1. Download and install latest 64-bit installer as described in [Install or update](#install-or-update). The 32-bit MSI will be automatically uninstalled. 4. Install extensions by running `az extension add --name --version `. -If you have issues after migration, you can uninstall the 64-bit MSI and reinstall the 32-bit MSI. If you have made a backup of your 32-bit extension folder, restore your extension folder after the change. +If you have issues after migration, you can uninstall the 64-bit and reinstall the 32-bit MSI. If you have made a backup of your 32-bit extension folder, restore (rename) your extension folder after the change. ## Uninstall From e25d09830cd390bee49aec284c26d3dd8e89f4f0 Mon Sep 17 00:00:00 2001 From: Hang Date: Mon, 7 Aug 2023 10:14:24 +0800 Subject: [PATCH 09/16] Update docs-ref-conceptual/install-azure-cli-windows.md Co-authored-by: Delora Bradish --- docs-ref-conceptual/install-azure-cli-windows.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index 10ec709352..d44ebbff15 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -63,7 +63,10 @@ To install the Azure CLI using PowerShell, start PowerShell **as administrator** This will download and install the latest 32-bit installer of the Azure CLI for Windows. If you prefer a 64-bit install, change URL to `https://aka.ms/installazurecliwindowsx64`. If the Azure CLI is already installed, the installer will overwrite the existing version. -To install specific version, replace the `-Uri` argument with `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) with version segment changed. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). (64-bit MSI is available from 2.51.0.) +To install a specific version, replace the `-Uri` argument with the URL described in [Specific version](#specific-version). Here is an example of using the 32-bit installer of the Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023) in PowerShell: + + ```PowerShell + $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi ### Azure CLI Command (for update only) From be866459af92cf7c1b7f71d612d14de49e5ae9ac Mon Sep 17 00:00:00 2001 From: Hang Date: Mon, 7 Aug 2023 10:25:28 +0800 Subject: [PATCH 10/16] Update docs-ref-conceptual/install-azure-cli-windows.md Co-authored-by: Delora Bradish --- docs-ref-conceptual/install-azure-cli-windows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index d44ebbff15..dfd8430c06 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -158,7 +158,7 @@ Follow these steps to migrate to Azure CLI 64-bit: 1. Check your current CLI version and installed extensions by running `az --version`. 1. Extensions will need to be reinstalled. It is recommended to perform a backup of the current extension folder `%userprofile%\.azure\cliextensions` by renaming it in case you choose to revert back to 32-bit. This folder is created automatically when you reinstall an extension. 1. Download and install latest 64-bit installer as described in [Install or update](#install-or-update). The 32-bit MSI will be automatically uninstalled. -4. Install extensions by running `az extension add --name --version `. +1. Install extensions by running `az extension add --name --version `. If you don't want to reinstall extensions manually, the Azure CLI will prompt you to install an extension on first use. For more information on installing extensions, see [How to install extensions](/cli/azure/azure-cli-extensions-overview#how-to-install-extensions). If you have issues after migration, you can uninstall the 64-bit and reinstall the 32-bit MSI. If you have made a backup of your 32-bit extension folder, restore (rename) your extension folder after the change. From 6e7865d6f407419e9ac0566afb30280ea9a6caca Mon Sep 17 00:00:00 2001 From: Delora Bradish Date: Mon, 7 Aug 2023 20:35:32 -0400 Subject: [PATCH 11/16] Update docs-ref-conceptual/install-azure-cli-windows.md --- docs-ref-conceptual/install-azure-cli-windows.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index dfd8430c06..a2470318ce 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -43,7 +43,9 @@ If you have previously installed the Azure CLI, running either the 32-bit or 64- ### Specific version -To download the MSI installer for specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. Available versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). (64-bit MSI is available from 2.51.0.) +To download the MSI installer for a specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. For example, to install the 32-bit MSI of Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023), your URL would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi`. The corresponding 64-bit install would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0x64.msi`. + +Available Azure CLI versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). The 64-bit MSI is available from version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023). # [Microsoft Installer (MSI) with Command](#tab/powershell) From 790c8e64e834dda4587f4f59f05ed7ca828cd220 Mon Sep 17 00:00:00 2001 From: Delora Bradish Date: Mon, 7 Aug 2023 20:37:34 -0400 Subject: [PATCH 12/16] Update install-azure-cli-windows.md --- docs-ref-conceptual/install-azure-cli-windows.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index a2470318ce..0a248ce7ab 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -43,7 +43,7 @@ If you have previously installed the Azure CLI, running either the 32-bit or 64- ### Specific version -To download the MSI installer for a specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. For example, to install the 32-bit MSI of Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023), your URL would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi`. The corresponding 64-bit install would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0x64.msi`. +To download the MSI installer for a specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. For example, to install the 32-bit MSI of Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023), your URL would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi`. The corresponding 64-bit install would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi`. Available Azure CLI versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). The 64-bit MSI is available from version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023). @@ -63,7 +63,7 @@ To install the Azure CLI using PowerShell, start PowerShell **as administrator** $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://aka.ms/installazurecliwindows -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi ``` -This will download and install the latest 32-bit installer of the Azure CLI for Windows. If you prefer a 64-bit install, change URL to `https://aka.ms/installazurecliwindowsx64`. If the Azure CLI is already installed, the installer will overwrite the existing version. +This will download and install the latest 32-bit installer of the Azure CLI for Windows. If you prefer a 64-bit install, change URL to `https://aka.ms/installazurecliwindowsx64`. If the Azure CLI is already installed, the installer will overwrite the existing version. To install a specific version, replace the `-Uri` argument with the URL described in [Specific version](#specific-version). Here is an example of using the 32-bit installer of the Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023) in PowerShell: From 0cb7aaec55f2d22eae6bd5c4eeb2d61a6be1f772 Mon Sep 17 00:00:00 2001 From: Hang Date: Tue, 8 Aug 2023 10:16:21 +0800 Subject: [PATCH 13/16] Fix code block --- docs-ref-conceptual/install-azure-cli-windows.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index 0a248ce7ab..2827550aff 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -69,6 +69,7 @@ To install a specific version, replace the `-Uri` argument with the URL describe ```PowerShell $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi + ``` ### Azure CLI Command (for update only) From f609686a9a96d50a77a3d5f82111763b8bd3152b Mon Sep 17 00:00:00 2001 From: Hang Date: Tue, 8 Aug 2023 17:07:39 +0800 Subject: [PATCH 14/16] Test --- docs-ref-conceptual/install-azure-cli-windows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index 2827550aff..e58ab9869f 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -65,7 +65,7 @@ To install the Azure CLI using PowerShell, start PowerShell **as administrator** This will download and install the latest 32-bit installer of the Azure CLI for Windows. If you prefer a 64-bit install, change URL to `https://aka.ms/installazurecliwindowsx64`. If the Azure CLI is already installed, the installer will overwrite the existing version. -To install a specific version, replace the `-Uri` argument with the URL described in [Specific version](#specific-version). Here is an example of using the 32-bit installer of the Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023) in PowerShell: +To install a specific version, replace the `-Uri` argument with the URL described in [Specific version](#tab/azure-cli/specific-version). Here is an example of using the 32-bit installer of the Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023) in PowerShell: ```PowerShell $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi From b628af5c989d063d9edd0596e28893264609694d Mon Sep 17 00:00:00 2001 From: Hang Date: Tue, 8 Aug 2023 17:34:27 +0800 Subject: [PATCH 15/16] Include specific-version --- docs-ref-conceptual/includes/specific-version.md | 11 +++++++++++ docs-ref-conceptual/install-azure-cli-windows.md | 10 ++++++---- 2 files changed, 17 insertions(+), 4 deletions(-) create mode 100644 docs-ref-conceptual/includes/specific-version.md diff --git a/docs-ref-conceptual/includes/specific-version.md b/docs-ref-conceptual/includes/specific-version.md new file mode 100644 index 0000000000..d1ed6cc7c8 --- /dev/null +++ b/docs-ref-conceptual/includes/specific-version.md @@ -0,0 +1,11 @@ +--- +author: dbradish-microsoft +ms.author: dbradish +manager: barbkess +ms.date: 08/08/2023 +ms.topic: include +ms.custom: devx-track-azurecli +--- +To download the MSI installer for a specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. For example, to install the 32-bit MSI of Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023), your URL would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi`. The corresponding 64-bit install would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi`. + +Available Azure CLI versions can be found at [Azure CLI release notes](../release-notes-azure-cli.md). The 64-bit MSI is available from version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023). \ No newline at end of file diff --git a/docs-ref-conceptual/install-azure-cli-windows.md b/docs-ref-conceptual/install-azure-cli-windows.md index e58ab9869f..04e4221a9e 100644 --- a/docs-ref-conceptual/install-azure-cli-windows.md +++ b/docs-ref-conceptual/install-azure-cli-windows.md @@ -43,9 +43,7 @@ If you have previously installed the Azure CLI, running either the 32-bit or 64- ### Specific version -To download the MSI installer for a specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. For example, to install the 32-bit MSI of Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023), your URL would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi`. The corresponding 64-bit install would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi`. - -Available Azure CLI versions can be found at [Azure CLI release notes](./release-notes-azure-cli.md). The 64-bit MSI is available from version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023). +[!INCLUDE [specific version](includes/specific-version.md)] # [Microsoft Installer (MSI) with Command](#tab/powershell) @@ -65,12 +63,16 @@ To install the Azure CLI using PowerShell, start PowerShell **as administrator** This will download and install the latest 32-bit installer of the Azure CLI for Windows. If you prefer a 64-bit install, change URL to `https://aka.ms/installazurecliwindowsx64`. If the Azure CLI is already installed, the installer will overwrite the existing version. -To install a specific version, replace the `-Uri` argument with the URL described in [Specific version](#tab/azure-cli/specific-version). Here is an example of using the 32-bit installer of the Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023) in PowerShell: +To install a specific version, replace the `-Uri` argument with the URL described in [Specific version](#specific-version-1). Here is an example of using the 32-bit installer of the Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023) in PowerShell: ```PowerShell $ProgressPreference = 'SilentlyContinue'; Invoke-WebRequest -Uri https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi -OutFile .\AzureCLI.msi; Start-Process msiexec.exe -Wait -ArgumentList '/I AzureCLI.msi /quiet'; Remove-Item .\AzureCLI.msi ``` +### Specific version + +[!INCLUDE [specific version](includes/specific-version.md)] + ### Azure CLI Command (for update only) [!INCLUDE [az upgrade](includes/az-upgrade.md)] From a984d393c5068e2875ceeae6753fcb8788b05a9a Mon Sep 17 00:00:00 2001 From: Hang Date: Tue, 8 Aug 2023 17:55:07 +0800 Subject: [PATCH 16/16] Minor fix --- docs-ref-conceptual/includes/specific-version.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs-ref-conceptual/includes/specific-version.md b/docs-ref-conceptual/includes/specific-version.md index d1ed6cc7c8..72da97178c 100644 --- a/docs-ref-conceptual/includes/specific-version.md +++ b/docs-ref-conceptual/includes/specific-version.md @@ -6,6 +6,8 @@ ms.date: 08/08/2023 ms.topic: include ms.custom: devx-track-azurecli --- -To download the MSI installer for a specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. For example, to install the 32-bit MSI of Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023), your URL would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi`. The corresponding 64-bit install would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi`. +To download the MSI installer for a specific version, change the version segment in URL `https://azcliprod.blob.core.windows.net/msi/azure-cli-.msi` (32-bit) or `https://azcliprod.blob.core.windows.net/msi/azure-cli--x64.msi` (64-bit) and download it. + +For example, to install the 32-bit MSI of Azure CLI version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023), your URL would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0.msi`. The corresponding 64-bit install would be `https://azcliprod.blob.core.windows.net/msi/azure-cli-2.51.0-x64.msi`. Available Azure CLI versions can be found at [Azure CLI release notes](../release-notes-azure-cli.md). The 64-bit MSI is available from version [2.51.0](/cli/azure/release-notes-azure-cli#august-01-2023). \ No newline at end of file