クイック スタート: Azure DevOps CLI の概要

Azure DevOps サービス

このクイック スタートでは、Azure コマンド ライン インターフェイス (CLI) 用の Azure DevOps 拡張機能をインストールして使用を開始する方法について説明します。 この拡張機能では、コマンド ラインから Azure DevOps Services を管理するためのコマンドが追加されるため、一般的なタスクをスクリプト化および自動化できます。

このクイックスタートでは、次の方法について説明します。

• Azure CLI 用の Azure DevOps 拡張機能をインストールする
• サインイン、既定値の構成、コマンドのヘルプへのアクセス
• CLI を使用してブラウザーで Azure DevOps 項目を開く

簡単な手順:

1. Azure CLI をインストールする (まだインストールされていない場合)
2. Azure DevOps 拡張機能を追加または更新する
3. サインインして既定の組織とプロジェクトを設定する
4. az devops --helpを使用するか、アイテムを開く--open

インストールと更新

1. Azure CLI をインストールします。 「Azure CLI のインストール」の手順に従います。 インストール後、バージョンを確認します。

az --version

1. Azure DevOps 拡張機能を追加します。

   az extension add --name azure-devops
   

   拡張機能が既にインストールされていて、最新バージョンであることを確認する場合は、update コマンドを実行します。

   az extension update --name azure-devops
   

2. インストールを確認するには、コマンド az extension list または az extension show --name azure-devopsを実行します。

3. サインインするには、 az login コマンドを実行します。 Azure CLI では、 az loginでユーザー名とパスワードを使用した対話型サインインのみがサポートされます。 個人用アクセス トークン (PAT) を使用してサインインするには、「 Azure DevOps PAT を使用したサインイン」を参照してください。

   Important

   リスクの高い個人用アクセス トークンよりも安全な Microsoft Entraトークンを使用することを検討してください。 詳細については、「 PAT 使用量の削減」を参照してください。 認証ガイダンスを確認して、ニーズに適した認証メカニズムを選択します。

   注

   Azure DevOps CLI 拡張機能では、対話型認証 (Microsoft Entra) と PAT 認証がサポートされています。 サービス プリンシパルとマネージド ID の場合は、REST API を直接使用するか、クライアント ライブラリを使用します。 詳細については、 認証ガイダンスを参照してください。

4. 組織とプロジェクトの既定の構成を設定します。 それ以外の場合は、個々のコマンド自体の値を指定します。

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

Azure DevOps の AI サポートを有効にする

Azure DevOps ワークフロー全体の生産性を向上させるために、Azure DevOps MCP Server を使用して、プロジェクト データに対する AI 支援を有効にします。 AI アシスタントへの自然言語クエリを通じて、毎日のスタンドアップ、スプリント計画、コード レビュー、プロジェクト レポート、プル要求分析、作業項目管理に関するインテリジェントな分析情報を得ることができます。 詳細とインストール手順については、 Azure DevOps MCP サーバーの概要を参照してください。

コマンドを使用する

Azure DevOps 拡張機能を追加すると、 devops、 pipelines、 artifacts、 boards、および repos グループが取得されます。

任意のコマンドの使用法とヘルプ コンテンツを取得するには、 --help パラメーターを指定します。 例えば次が挙げられます。

az devops --help

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 to use for a particular organization.
    logout           : Clear the credential for all or a particular organization.

ブラウザーで項目を開く

既定のブラウザーで Azure DevOps ポータルで成果物を開くには、 --open パラメーターを使用します。

az pipelines build show --id 1 --open

このコマンドは、コマンド プロンプト ウィンドウに --id 1 を使用してビルドの詳細を表示し、既定のブラウザーで開きます。

関連コンテンツ

• Azure CLI コマンドの出力形式
• az devops CLI の例のインデックス
• Azure DevOps CLI 拡張機能の GitHub リポジトリ