開始使用 Azure CLI

歡迎使用 Azure Command-Line 介面 (CLI) ! 本文介紹 CLI,並協助您完成一般工作。

注意

在指令碼及 Microsoft 文件網站中,Azure CLI 範例均以 bash 殼層適用的方式撰寫。 單行範例可在任何平台上執行。 包含以行接續 (\) 的較長範例,或變數指派則要加以修改,以便在包括 PowerShell 等其他殼層中使用。

在 Azure Cloud Shell 中安裝或執行

瞭解如何使用 Azure CLI 最簡單的方式,就是透過瀏覽器在 Azure Cloud Shell 環境中執行它。 若要了解 Cloud Shell,請參閱 Azure Cloud Shell 中 Bash 的快速入門

當您準備好要安裝 CLI 時,請參閱安裝指示

第一次安裝 CLI 後,請執行 az --version 來確認已安裝完成,而且版本正確。

注意

若您使用的是 Azure 傳統部署模型,請安裝 Azure 傳統 CLI

如何登入 Azure CLI

在搭配本機安裝使用任何 Azure CLI 命令之前,您需要使用 az login 登入

  1. 執行 login 命令。

    az login
    

    如果 CLI 可以開啟您的預設瀏覽器,它會起始 授權碼流程 ,並開啟預設瀏覽器以載入 Azure 登入頁面。

    否則,它會起始 裝置程式碼流程 ,並告訴您在 開啟 https://aka.ms/devicelogin 瀏覽器頁面,並輸入終端機中顯示的程式碼。

    如果沒有網頁瀏覽器可用,或網頁瀏覽器無法開啟,您可以使用 az login --use-device-code 強制裝置程式碼流程。

  2. 請在瀏覽器中使用您的帳戶認證登入。

登入之後,您會看到一份與 Azure 帳戶相關聯的訂用帳戶清單。 包含 isDefault: true 的訂用帳戶資訊是目前在登入之後會啟動的訂用帳戶。 若要選取另一個訂用帳戶,請使用 az account set 命令搭配訂用帳戶識別碼以進行切換。 如需訂用帳戶選項的詳細資訊,請參閱使用多個 Azure 訂用帳戶

非互動式的登入方法有很多種,透過 Azure CLI 登入中有詳細說明。

常見的 Azure CLI 命令

下表列出 CLI 中使用的一些常用命令,以及其參考文件的連結。

資源類型 Azure CLI 命令群組
資源群組 az group
虛擬機器 az vm
儲存體帳戶 az storage account
金鑰保存庫 az keyvault
Web 應用程式 az webapp
SQL 資料庫 az sql server
CosmosDB az cosmosdb

尋找命令

Azure CLI 命令會組織為 群組命令。 每個群組都代表一項 Azure 服務,以及該服務上運作的命令。

若要搜尋命令,請使用 az find。 例如,若要搜尋包含 secret 的命令名稱,請使用下列命令:

az find secret

使用 --help 引數取得命令的完整清單和群組的子群組。 例如,若要尋找使用網路安全性群組 (NSG) 的 CLI 命令:

az network nsg --help

針對 bash 殼層下的命令,CLI 有完整的 tab 鍵自動完成。

全域可用的引數

有一些引數可供每個命令使用。

  • --help 會輸出有關命令的 CLI 參考資訊命令和其引數,並列出可用的子群組和命令。
  • --output 會變更輸出格式。 可用的輸出格式為 jsonjsonc (以色彩標示的 JSON)、tsv (定位字元分隔值)、table (人類看得懂的 ASCII 資料表) 和 yaml。 根據預設,CLI 會輸出 json。 若要深入了解可用的輸出格式,請參閱 Azure CLI 的輸出格式
  • --query 會使用 JMESPath 查詢語言 來篩選從 Azure 服務傳回的輸出。 若要了解有關查詢的詳細資訊,請參閱使用 Azure CLI 查詢命令結果JMESPath 教學課程
  • --verbose 會輸出作業執行時,在 Azure 中建立的資源相關資訊,以及其他有用的資訊。
  • --debug 會輸出更多 CLI 作業的詳細資訊,以用於偵錯。 如果您發現錯誤,可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。

互動模式

CLI 提供互動模式,會自動顯示說明資訊,並可讓您更輕鬆地選取子命令。 使用 az interactive 命令進入互動模式。

az interactive

如需互動模式的詳細資訊,請參閱 Azure CLI 互動模式

另外還有 Visual Studio Code 外掛程式,提供互動式體驗,包括自動完成和滑鼠移過即顯示內容的文件。

透過快速入門和教學課程了解 CLI 基本概念

若要瞭解如何使用 Azure CLI,請嘗試深入教學課程來設定虛擬機器,並使用 CLI 的強大功能來查詢 Azure 資源。

另外還有其他熱門服務的快速入門。

提供意見反應

歡迎您提供有關 CLI 的意見反應,以協助我們進行改善及解決錯誤。 您可以在 GitHub 上提交問題或使用 CLI 的內建功能,以 az feedback 命令留下一般意見反應。

az feedback

另請參閱