# 使用 Azure CLI 管理 Azure DevOps Server 2019 服務

去年六月的時候，寫了一篇 [使用 Azure CLI 管理 Azure DevOps Services 服務](/post/2019/06/01/Manage-Azure-DevOps-Services-using-Azure-CLI) 文章，當時我也想透過 Azure CLI 命令列工具連接 Azure DevOps Server 2019 進行管理，不過那時還尚未支援 Azure DevOps Server，所以無法登入成功。這幾天想說再試一次，結果發現可以用了！由於大部分的操作步驟都差不多，本篇文章我只概要簡介開始使用的過程，較為詳細的參數與命令可以參考我[去年的文章](/post/2019/06/01/Manage-Azure-DevOps-Services-using-Azure-CLI)。

### 首次安裝與設定

1.  [安裝 Azure CLI 命令列工具](https://learn.microsoft.com/zh-tw/cli/azure/install-azure-cli?view=azure-cli-latest)
    
    ```bash
    choco install azure-cli -y
    ```
    
2.  [安裝 Azure DevOps 擴充](https://learn.microsoft.com/en-us/azure/devops/cli/?view=azure-devops)
    
    ```bash
    az extension add --name azure-devops
    ```
    
    你可以透過以下命令確認是否安裝成功：
    
    ```bash
    az extension show --name azure-devops
    ```
    
3.  [建立 PAT (Personal Access Token) 權杖](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=current-page) (Azure DevOps Server 2019)
    
    請參考 [Authenticate access with personal access tokens](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=current-page) 文件。
    
4.  透過 Azure CLI 登入
    
    執行以下命令後，會出現 `Token:` 提示，此時輸入你先前建立的 PAT 權杖 (Token) 即可登入成功。
    
    ```bash
    az devops login --org http://localhost/DefaultCollection
    ```
    
    > 假設你的**專案集合**路徑為 `http://localhost/DefaultCollection`
    
    也可以透過以下命令一口氣完成登入
    
    ```bash
    echo EnterYourPATHere | az devops login --org http://localhost/DefaultCollection
    ```
    
5.  設定預設專案
    
    ```bash
    az devops configure --defaults organization=http://localhost/DefaultCollection project=YourProjectName
    ```
    
    > 假設你經常管理的**專案名稱**為 `YourProjectName` (有需要再來設定即可)
    

### 相關連結

-   [Get started with Azure DevOps CLI](https://learn.microsoft.com/en-us/azure/devops/cli/?view=azure-devops)
-   [Authenticate access with personal access tokens](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops&tabs=current-page)
-   [azure-devops | Microsoft Docs](https://learn.microsoft.com/en-us/cli/azure/devops)