安裝 Azure 傳統 CLIInstall the Azure classic CLI

重要

本主題將說明如何安裝 Azure 傳統 CLI。This topic describes how to install the Azure classic CLI. 傳統 CLI 已有替代產品,應只搭配傳統部署模型使用。The classic CLI is deprecated and should only be used with the classic deployment model. 對於所有其他的部署,請使用 Azure CLIFor all other deployments, use the Azure CLI.

快速安裝 Azure 傳統 CLI 以使用一組開放原始碼的命令介面式命令,用於建立和管理 Microsoft Azure 中的資源。Quickly install the Azure classic CLI to use a set of open-source shell-based commands for creating and managing resources in Microsoft Azure. 有數個選項可讓您在電腦上安裝這些跨平台工具︰You have several options to install these cross-platform tools on your computer:

  • npm 套件 - 執行 npm (適用於 JavaScript 的套件管理員) 將 Azure 傳統 CLI 套件安裝在您的 Linux 散發套件或作業系統上。npm package - Run npm (the package manager for JavaScript) to install the Azure classic CLI package on your Linux distribution or OS. 需要 Node.js 和 npm。Requires node.js and npm.
  • 安裝程式 - 下載安裝程式以輕鬆在 macOS 或 Windows 上安裝。Installer - Download an installer for easy installation on macOS or Windows.
  • Docker 容器 - 在已就緒可執行的 Docker 容器中開始使用傳統 CLI。Docker container - Start using the classic CLI in a ready-to-run Docker container. 需要 Docker 主機。Requires a Docker host.

如需詳細的選項和背景,請參閱 GitHub上的專案儲存機制。For more options and background, see the project repository on GitHub.

安裝好 Azure 傳統 CLI 之後,連線至 azure login 並從命令列介面 (Bash、終端機及命令提示字元等) 中執行 azure 命令以使用 Azure 資源。Once the Azure classic CLI is installed, connect with azure login and run the azure commands from your command-line interface (Bash, Terminal, Command prompt, and so on) to work with your Azure resources.

選項 1:安裝 npm 套件Option 1: Install an npm package

若要從 npm 套件安裝傳統 CLI,請確定已下載並安裝最新的 Node.js 和 npmTo install the classic CLI from an npm package, make sure you have downloaded and installed the latest Node.js and npm. 然後,執行 npm install,以安裝 azure-cli 套件:Then, run npm install to install the azure-cli package:

npm install -g azure-cli

在 Linux 散發套件上,建議您使用 sudo,才能順利執行 npm 命令,如下所示:On Linux distributions, you might need to use sudo to successfully run the npm command, as follows:

sudo npm install -g azure-cli

注意

如果您需要在作業系統上安裝或更新 Node.js 和 npm,建議您安裝 Node.js LTS 4.x 版或更新版本。If you need to install or update Node.js and npm on your OS, we recommend that you install Node.js LTS version 4.x or later. 如果您使用較舊的版本,可能會發生安裝錯誤。If you use an older version, you might get installation errors.

根據您的偏好,也可以從 GitHub 版本下載 tar 檔案。If you prefer, you may also download a tar file from the GitHub releases. 然後,安裝下載的 npm 套件,如下所示 (在 Linux 散發套件上,建議您使用 sudo):Then, install the downloaded npm package as follows (on Linux distributions you might need to use sudo):

npm install -g <path to downloaded tar file>

選項 2:使用安裝程式Option 2: Use an installer

如果您使用 Mac 或 Windows 電腦,可從 GitHub 版本中取得 DMG 和 MSI 安裝程式︰If you use a Mac or Windows computer, DMG and MSI installers are available from GitHub releases.

提示

在 Windows 中,您也可以下載 Web Platform Installer 來安裝傳統 CLI。On Windows, you can also download the Web Platform Installer to install the classic CLI. 這個安裝程式可讓您選擇安裝額外的 Azure SDK 和命令列工具。This installer gives you the option to install additional Azure SDK and command-line tools.

選項 3:使用 Docker 容器Option 3: Use a Docker container

如果您已將電腦設定為 Docker 主機,您可以在 Docker 容器中執行 Azure 傳統 CLI。If you have set up your computer as a Docker host, you can run the Azure classic CLI in a Docker container. 執行下列命令 (在 Linux 散發套件上,您可能需要使用 sudo):Run the following command (on Linux distributions you might need to use sudo):

docker run -it microsoft/azure-cli:0.10.17

執行 Azure 傳統 CLIRun Azure classic CLI commands

安裝好傳統 CLI 之後,從命令列使用者介面 (Bash、終端機及命令提示字元等) 中執行 azure 命令。After the classic CLI is installed, run the azure command from your command-line user interface (Bash, Terminal, Command prompt, and so on). 例如,若要執行 [說明] 命令,請輸入下列命令:For example, to run the help command, type the following:

azure help

注意

在某些 Linux 散發套件上,您可能會收到類似 /usr/bin/env: ‘node’: No such file or directory 的錯誤訊息。On some Linux distributions, you may receive an error similar to /usr/bin/env: ‘node’: No such file or directory. 此錯誤訊息是來自最近安裝在 /usr/bin/nodejs 的 Node.js。This error comes from recent installations of Node.js being installed at /usr/bin/nodejs. 若要修正此錯誤,請執行此命令來建立 /usr/bin/node 的符號連結︰To fix it, create a symbolic link to /usr/bin/node by running this command:

sudo ln -s /usr/bin/nodejs /usr/bin/node

若要查看您所安裝的 Azure 傳統 CLI 版本,請輸入下列命令:To see the version of the Azure classic CLI installed, type the following:

azure --version

注意

當您第一次使用 Azure 傳統 CLI 時會看到一則訊息,詢問您是否要允許 Microsoft 收集使用情況資訊。When you first use Azure classic CLI, you see a message asking if you want to allow Microsoft to collect usage information. 參與為自願性質。Participation is voluntary. 如果您選擇參與,只要執行 azure telemetry --disable即可隨時停止參與。If you choose to participate, you can stop at any time by running azure telemetry --disable. 只要執行 azure telemetry --enable即可隨時啟用參與。To enable participation at any time, run azure telemetry --enable.

更新傳統 CLIUpdate the classic CLI

Microsoft 可能會發行 Azure 傳統 CLI 的更新版本。Microsoft may release updated versions of the Azure classic CLI. 請使用適用於您作業系統的安裝程式來重新安裝傳統 CLI,或執行最新的 Docker 容器。Reinstall the classic CLI using the installer for your operating system, or run the latest Docker container. 或者,如果您已安裝最新的 Node.js 和 npm,請輸入下列命令來進行更新 (在 Linux 散發套件上,建議您使用 sudo)。Or, if you have the latest Node.js and npm installed, update by typing the following (on Linux distributions you might need to use sudo).

npm update -g azure-cli

啟用 TAB 鍵自動完成Enable tab completion

針對 Mac 和 Linux 提供傳統 CLI 命令 TAB 鍵自動完成支援。Tab completion of classic CLI commands is supported for Mac and Linux.

若要在 zsh 中啟用它,請執行︰To enable it in zsh, run:

echo '. <(azure --completion)' >> .zshrc

若要在 bash 中啟用它,請執行︰To enable it in bash, run:

azure --completion >> ~/azure.completion.sh
echo 'source ~/azure.completion.sh' >> ~/.bash_profile

後續步驟Next steps