開始使用 Azure DevOps CLI

  • 發行項

Azure DevOps Services

透過適用于 Azure 命令列介面的 Azure DevOps 擴充功能 (CLI) ，您可以從命令列管理許多Azure DevOps Services。 CLI 命令可讓您使用更快速且彈性的互動式畫布簡化工作，略過使用者介面工作流程。

注意

Azure DevOps 命令列介面 (CLI) 僅適用于Azure DevOps Services。 Azure CLI 的 Azure DevOps 擴充功能不支援任何版本的 Azure DevOps Server。

若要開始使用適用于 Azure CLI 的 Azure DevOps 擴充功能，請執行下列步驟：

  1. 安裝 Azure CLI：遵循 安裝 Azure CLI 中提供的指示來設定 Azure CLI 環境。 您的 Azure CLI 版本至少必須是 2.10.1。 您可以使用 az --version 來驗證。

  2. 新增 Azure DevOps 擴充功能：

     az extension add --name azure-devops

    您可以使用 az extension list 或 az extension show --name azure-devops 來確認安裝。

  3. 登入：執行 az login 以登入。 請注意，我們僅支援使用使用者名稱和密碼搭配 az login 的互動式或登入。 若要使用個人存取權杖 (PAT) 登入，請參閱 透過 Azure DevOps Personal Access Token 登入 (PAT) 。

  4. 設定預設值：建議您為組織和專案設定預設組態。 否則，您可以在個別命令本身內設定這些專案。

     az devops configure --defaults organization=https://dev.azure.com/contoso project=ContosoWebApp

命令使用方式

新增 Azure DevOps 擴充功能會新增 devops 、 pipelines 、 artifacts 、 boards 和 repos 群組。 針對任何命令的使用方式和說明內容，輸入 -h 參數，例如：

az devops -h

Group
    az devops : Manage Azure DevOps organization level operations.
        Related Groups
        az pipelines: Manage Azure Pipelines
        az boards: Manage Azure Boards
        az repos: Manage Azure Repos
        az artifacts: Manage Azure Artifacts.
   
Subgroups:
    admin            : Manage administration operations.
    extension        : Manage extensions.
    project          : Manage team projects.
    security         : Manage security related operations.
    service-endpoint : Manage service endpoints/service connections.
    team             : Manage teams.
    user             : Manage users.
    wiki             : Manage wikis.

Commands:
    configure        : Configure the Azure DevOps CLI or view your configuration.
    feedback         : Displays information on how to provide feedback to the Azure DevOps CLI team.
    invoke           : This command will invoke request for any DevOps area and resource. Please use
                       only json output as the response of this command is not fixed. Helpful docs -
                       https://learn.microsoft.com/rest/api/azure/devops/.
    login            : Set the credential (PAT) to use for a particular organization.
    logout           : Clear the credential for all or a particular organization.

在瀏覽器中開啟專案

您可以使用 --open 參數，在預設瀏覽器中開啟 Azure DevOps 入口網站中的任何成品。

例如：

az pipelines build show --id 1 --open

此命令會顯示在命令列上使用 建 id 1 置的詳細資料，也會在預設瀏覽器中開啟它。