開始使用 Azure CLI

發行項
08/22/2024

歡迎使用 Azure 命令列介面（CLI）！本文介紹 CLI，並協助您完成一般工作。

在 Azure Cloud Shell 中安裝或執行

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

當您準備好安裝 Azure CLI 時，請參閱 Windows、Linux、macOS 和 Docker 容器的安裝指示。如果您使用 Azure 傳統部署模型，請安裝 Azure 傳統 CLI。

執行 az --version來檢查您的版本。 Azure Cloud Shell 一律會預安裝最新版的 Azure CLI。

az version

登入 Azure CLI

在搭配本機安裝使用任何 Azure CLI 命令之前，您必須使用 az login 登入。

執行 az login 命令。
```
az login
```
如果 Azure CLI 可以開啟您的預設瀏覽器，它會起始授權碼流程，並開啟預設瀏覽器以載入 Azure 登入頁面。

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

如果沒有可用的網頁瀏覽器，或網頁瀏覽器無法開啟，您可以使用 az login --use-device-code 強制裝置程式代碼流程。
請在瀏覽器中使用您的帳戶認證登入。

登入之後，您會收到與 Azure 帳戶相關聯的訂用帳戶清單。包含 isDefault: true 的訂用帳戶資訊是目前在登入之後會啟動的訂用帳戶。若要選取另一個訂用帳戶，請使用 az account set 命令搭配所需帳戶的訂用帳戶標識符。如需訂用帳戶選取的詳細資訊，請參閱管理 Azure 訂用帳戶。

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

尋找命令

Azure CLI 命令會組織成命令群組。每個群組都代表 Azure 服務的區域。有兩個選項可尋找命令群組：

使用 az find 命令。例如，若要搜尋包含 vm的命令名稱，請使用下列命令：
```
az find vm
```

--help使用自變數來取得參考群組內子群組的完整清單。此範例會傳回虛擬機的所有子群組：

az vm --help

以下是省略行以求簡潔的範例輸出：

Subgroups:
  application            : Manage applications for VM.
  availability-set       : Group resources into availability sets.
  boot-diagnostics       : Troubleshoot the startup of an Azure Virtual Machine.
  ...

以下另一個範例會尋找將虛擬機分組至可用性設定組的 Azure CLI 命令，也就是的az vm子群組：

az vm availability-set --help

也使用 --help 來取得參考命令的參數清單和命令範例。

az vm create --help

以下是省略行以求簡潔的範例輸出：

Arguments
    --name  [Required] : Name of the virtual machine.
    ...
Authentication Arguments
    --admin-password   : Password for the VM if authentication type is 'Password'.
    --admin-username   : Username for the VM...
    ...
Managed Service Identity Arguments
    ...
Examples
    Create a VM from a custom managed image.
      az vm create -g MyResourceGroup -n MyVm --image MyImage
    ...

使用 A 到 Z 參考索引，依字母順序列出所有命令群組。

尋找已發佈的範例和文章

如果您想要查看已測試的已發佈範例來瞭解 Azure CLI 語法，文章內容有兩個索引：

範例索引 A 到 Z。範例索引提供依主體區域、參考群組和 GitHub 存放庫排序的 Azure CLI 範例清單。

發行項索引 A 到 Z。使用鍵盤 find 快捷鍵，例如 Ctrl + F，快速卸除至您感興趣的參考命令群組。例如，發行項索引在中看起來會像這樣 az vm：

參考子群組	顯示參考使用方式的 Azure CLI 文章
az vm	Azure CLI 命令的輸出格式
	如何在 Azure CLI 命令中使用變數
	使用查詢取得 VM 資訊
	{這裡所列的更多文章。}
az vm aem	適用於 SAP 解決方案的 Azure VM 延伸模組新版本
	適用於 SAP 解決方案的 Azure VM 延伸模組標準版本
az vm application	{...}

使用 Tab 鍵自動完成

CLI 具有 Bash 環境中命令的完整索引標籤完成。若要在PowerShell環境中啟用索引標籤自動完成，請參閱在PowerShell中啟用索引標籤完成。

請注意全域可用的自變數

大部分命令都有一些自變數可供使用。

--help 會列印 CLI 參考命令及其自變數的相關信息，並列出可用的子群組和命令。
--output 會變更輸出格式。可用的輸出格式為 json、（彩色 JSON）、（Tab 分隔值）、 tsv table （人類可讀取的 ASCII 資料表）和 yamljsonc 。根據預設，CLI 會輸出 json。若要深入瞭解可用的輸出格式，請參閱 Azure CLI 的輸出格式。
--query 會使用 JMESPath 查詢語言來篩選從 Azure 服務傳回的輸出。若要深入了解查詢，請參閱使用 Azure CLI 和 JMESPath 查詢命令結果教學課程。
--verbose 會列印作業期間在 Azure 中建立之資源的相關信息，以及其他有用的資訊。
--debug 會列印用於偵錯之 CLI 作業的詳細資訊。如果您發現錯誤，可在提交錯誤報告時提供使用 --debug 旗標產生的輸出。例如，它可以用來識別執行之命令在下方叫用的 REST API，以及從服務接收的回應。
--subscription 是訂用帳戶的名稱或標識碼。如需設定預設訂用帳戶的詳細資訊，請參閱使用 Azure CLI 管理 Azure 訂用帳戶。
--only-show-errors 會隱藏命令輸出中的警告，並只顯示錯誤。

使用互動式模式

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

az interactive

如需互動式模式的詳細資訊，請參閱在互動式模式中執行 Azure CLI。

另外還有一個 Visual Studio Code 外掛程式提供互動式體驗，包括自動完成和滑鼠停留檔。

使用快速入門和教學課程瞭解 Azure CLI 基本概念

若要瞭解如何使用 Azure CLI，請嘗試我們的上線教學課程，在處理 Azure 儲存體時教導您下列技能：

尋找並變更您的預設訂用帳戶。
在名稱中建立包含隨機標識碼的 Azure 資源。
設定環境變數。
瞭解Bash、PowerShell和 Cmd 之間的語法差異。
對 Azure CLI 參考命令進行偵錯。
從本機 JSON 檔案取得屬性。此範例示範如何取得開發、階段和生產環境的組態值。
使用腳本刪除多個資源。

注意

在腳本和 Microsoft 文件網站上，Azure CLI 範例是針對 Bash 殼層所撰寫。大部分的單行範例都會在任何平台上執行。包含行接續（\）、變數指派 或引號 的較長範例必須修改，才能在其他殼層中運作，包括 PowerShell。如需環境間語法差異的詳細資訊，請參閱瞭解Bash、PowerShell和 Cmd之間的語法差異。

提供意見反應

歡迎您對 CLI 的意見反應，以協助我們改進並解決 Bug。您可以在 GitHub 上提出問題，或使用 CLI 的內建功能，以使用 az feedback 命令留下一般意見反應。

az feedback

共用方式為