拡張機能のインストール

2025-04-30

Azure DevOps Services |Azure DevOps Server 2022 - Azure DevOps Server 2019

拡張機能のインストール、割り当て、無効化、アンインストールを行い、Azure DevOps の新機能を追加します。

拡張機能の詳細については、開発と発行の概要を参照してください。

前提条件

カテゴリ	必要条件
権限	プロジェクトコレクション管理者グループのメンバー。組織の所有者は、自動的にこのグループのメンバーになります。アクセス許可がない場合は、代わりに拡張機能を要求するか、プロジェクトコレクション管理者を検索できます。
拡張機能の共有	組織と共有されているプライベート拡張機能。

カテゴリ	必要条件
権限	プロジェクトコレクション管理者グループのメンバーまたはコレクションレベルの情報を編集する権限。組織の所有者は、自動的にこのグループのメンバーになります。アクセス許可がない場合は、代わりに拡張機能を要求するか、プロジェクトコレクション管理者を検索できます。
拡張機能の共有	組織と共有されているプライベート拡張機能。

注

既存の Azure サブスクリプションを課金に使用するには、そのサブスクリプションに対する少なくとも共同管理者のアクセス許可を持ちます。アクセス許可がない場合は、Azure アカウント管理者またはサービス管理者が、Azure portal の Azure サブスクリプションに共同管理者として追加できます。

プロジェクトコレクションは、将来の Marketplace 購入のために Azure サブスクリプションを再利用します。 Azure の課金に関する詳細情報はどこで確認できますか?

拡張機能のインストール

次の手順を実行して、拡張機能を組織にインストールします。

ブラウザー
Azure DevOps CLI

組織(https://dev.azure.com/{Your_Organization})にサインインします。
ショッピングバッグアイコンを選択し、[Marketplace の参照] を選択します。
インストールする拡張機能を見つけて、[ 無料で入手] を選択します。
ドロップダウンメニューから組織を選択し、[ インストール ] を選択して拡張機能をインストールします。
- 組織が表示されないのはなぜですか?
- この拡張機能をインストールできないのはなぜですか?

拡張機能がインストールされました。これで、組織に移動して拡張機能を使用できるようになりました。また、この拡張機能の使用を開始できるように、チームにこの拡張機能について伝えます。

拡張機能がインストールされている

az devops extension install コマンドを使用して拡張機能をインストールします。開始するには、 Azure DevOps CLI の概要に関するページを参照してください。

拡張機能を検索する

必要に応じて、最初に az devops extension search コマンドを使用して拡張機能を検索します。

az devops extension search --search-query

パラメーター

search-query: マーケットプレースで検索する用語を指定します。

例

次のコマンドは、マーケットプレースで Timetracker という用語を検索し、テーブル形式で パブリッシャー ID と 拡張機能 ID を 返します。

az devops extension search --search-query Timetracker --output table

Publisher Id    Extension Id    Name
--------------  --------------  -----------
7pace           Timetracker     Timetracker
7pacelabs       kitten          Kitten

拡張機能のインストール

az devops extension install --extension-id
                            --publisher-id
                            [--org]

パラメーター

extension-id: インストールする拡張機能の名前。
publisher-id: 拡張機能の発行元の名前。
org: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。既定として設定されていない場合、または git config を使用して取得された場合は必須です。例: --org https://dev.azure.com/MyOrganizationName/.

例

次のコマンドは 、Timetracker 拡張機能をインストールし、結果を YAML 形式で表示します。

az devops extension install --extension-id Timetracker --publisher-id 7pace --output yaml

baseUri: null
constraints: null
contributionTypes: null
contributions: null
demands: null
eventCallbacks: null
extensionId: Timetracker
extensionName: Timetracker
fallbackBaseUri: null
files: null
flags: null
installState:
  flags: none
  installationIssues: null
  lastUpdated: '2019-11-26T16:04:32.907000+00:00'
language: null
lastPublished: '2019-11-13T11:58:37.890000+00:00'
licensing: null
manifestVersion: null
publisherId: 7pace
publisherName: 7pace
registrationId: null
restrictedTo: null
scopes: null
serviceInstanceType: null
version: 5.0.1.34507

手動インストール:

次のコマンドを使用して、インストールする拡張機能を取得します。

az extension add --name <extension-name>
<extension-name>をインストールする拡張機能の実際の名前に置き換えます。
- 拡張機能のソースが外部リソースであるか、その拡張機能への直接リンクがある場合は、ソース URL またはローカルパスを指定します。
az extension add --source <URL-or-path>

index.jsonの形式に従ってプライベート拡張機能インデックスを作成し、バージョン 2.20.0 以降の Azure CLI で使用される拡張機能インデックスの URL を設定することもできます。その後、拡張機能を名前でプライベート拡張機能インデックスからインストールできます。

自動インストール (動的インストール):

インストールされていない拡張機能コマンドを実行すると、実行したコマンドが Azure CLI によって認識され、拡張機能が自動的にインストールされます (バージョン 2.10.0 以降)。この機能は動的インストールと呼ばれ、2.12.0 以降では既定で有効になっています。サポートされている以前のバージョンの構成を使用して有効にすることもできます。

az config set extension.use_dynamic_install=yes_prompt

プロンプトなしで動的インストールを有効にするには、次の構成コマンドを使用します。

az config set extension.use_dynamic_install=yes_without_prompt

次の構成コマンドを使用して、動的インストール機能をオフにして、既定の動作に戻します。

az config set extension.use_dynamic_install=no

拡張機能がインストールされていない場合、拡張機能コマンドは "command-not-found" エラーを返します。

拡張機能の場所:

拡張機能がインストールされると、 $AZURE_EXTENSION_DIR シェル変数の値の下で見つけることができます。この変数が設定されていない場合、既定では、この値は $HOME/.azure/cliextensions (Linux と macOS の場合) または %USERPROFILE%\\.azure\\cliextensions (Windows の場合) になります。

高い特権、パイプラインデコレーター、非公開の拡張機能

高い特権スコープ、パイプラインデコレーター、または未発行の状態の拡張機能は、適切に審査されていない場合、潜在的なセキュリティリスクを引き起こす可能性があります。高い特権スコープでは、組織のリソースへの広範なアクセスが許可されますが、パイプラインデコレーターは組織内のすべてのパイプラインを変更できます。公開されていない拡張機能は、発行元によって管理されなくなる可能性があります。これらの種類の拡張機能の管理の詳細については、「高い特権スコープ、パイプラインデコレーター、および発行されていない拡張機能の管理」を参照してください。

組織(https://dev.azure.com/{Your_Organization})にサインインします。
[組織の設定] を選択します。
[ 拡張機能] を選択し、アンインストールまたは無効にする拡張機能を選択します。
[ アンインストール ] を選択するか、省略記号 (...) を選択し、[ 無効] を選択します。

拡張機能をアンインストールします | 拡張機能を無効にする

拡張機能をアンインストールする

az devops extension uninstall コマンドを使用して拡張機能をアンインストールします。開始するには、 Azure DevOps CLI の概要に関するページを参照してください。

az devops extension uninstall --extension-name
                              --publisher-name
                              [--org]
                              [--yes]

パラメーター - 拡張機能のアンインストール

extension-name: アンインストールする拡張機能の名前。
publisher-name: 拡張機能の発行元の名前。
org: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URLを使用して既定の組織を構成します。既定として設定されていない場合、または git config を使用して取得された場合は必須です。例: --org https://dev.azure.com/MyOrganizationName/.
はい: 省略可能。確認を求めるプロンプトを表示しません。

例 - 拡張機能のアンインストール

次のコマンドは、確認を求めずに "Timetracker" 拡張機能をアンインストールします。

az devops extension uninstall --extension-name Timetracker --publisher-name 7pace --yes

拡張機能を無効にする

az devops extension disable コマンドを使用して拡張機能を無効にします。開始するには、 Azure DevOps CLI の概要に関するページを参照してください。

az devops extension disable --extension-name
                            --publisher-name
                            [--org]

パラメーター - 拡張機能を無効にする

extension-name: 無効にする拡張機能の名前。
publisher-name: 拡張機能の発行元の名前。
org: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URLを使用して既定の組織を構成します。既定として設定されていない場合、または git config を使用して取得された場合は必須です。例: --org https://dev.azure.com/MyOrganizationName/.

例 - 拡張機能を無効にする

次のコマンドは 、Timetracker 拡張機能を無効にし、結果をテーブル形式で表示します。

az devops extension disable --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       disabled

コレクション内の拡張機能をアンインストールするには、次の手順を実行します。

ローカルギャラリー管理ポータル (http://{server}:8080/tfs/_gallery/manage) に移動します。
必要な拡張機能については、省略記号 (...) を選択し、[削除] を選択します。

コマンドラインを使用して拡張機能を有効または一覧表示する

az devops extension enable コマンドを使用して拡張機能を有効にします。開始するには、 Azure DevOps CLI の概要に関するページを参照してください。

az devops extension enable --extension-name
                           --publisher-name
                           [--org]

パラメーター - 拡張機能を有効にする

extension-name: 有効にする拡張機能の名前。
publisher-name: 拡張機能の発行元の名前。
org: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URLを使用して既定の組織を構成します。既定として設定されていない場合、または git config を使用して取得された場合は必須です。例: --org https://dev.azure.com/MyOrganizationName/.

例 - 拡張機能を有効にする

次のコマンドは 、Timetracker 拡張機能を有効にし、結果をテーブル形式で表示します。

az devops extension enable --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       none

拡張機能を一覧表示する

az devops extension list コマンドを使用して、組織にインストールされている拡張機能を一覧表示できます。開始するには、 Azure DevOps CLI の概要に関するページを参照してください。

az devops extension list [--include-built-in {false, true}]
                         [--include-disabled {false, true}]
                         [--org]

省略可能なパラメーター - 拡張機能の一覧表示

include-built-in: 組み込みの拡張機能を含めます。指定できる値は true (既定値) と false です。
include-disabled: 無効になっている拡張機能を含めます。指定できる値は true (既定値) と false です。
org: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。既定として設定されていない場合、または git config を使用して取得された場合は必須です。例: --org https://dev.azure.com/MyOrganizationName/.

例 - 拡張機能を一覧表示する

次のコマンドは、組織内の拡張機能を一覧表示します。無効になっている拡張機能と組み込みの拡張機能が除外され、結果がテーブル形式で表示されます。

az devops extension list --include-built-in false --include-disabled false -output table

Publisher Id    Extension Id             Name                     Version              Last Updated     States         		 Flags
--------------  -----------------------  -----------------------  -------------------  ---------------  -----------------------  -------
ms              vss-analytics            Analytics                18.160.0.2130149925  2019-11-22       multiVersion, truste...  trusted
ms              vss-code-search          Code Search              18.160.0.1640944814  2019-11-22       multiVersion, truste...  trusted
ms              vss-plans                Delivery Plans           18.160.0.1266795967  2019-11-25       multiVersion, truste...  trusted
ms-eswm         dependencytracker        Dependency Tracker       2.1910.12801         2019-10-28       none
ms-devlabs      workitem-feature-tim...  Feature timeline and...  0.0.357              2019-10-14       none
AgileParts      gantt                    GANTT chart              1.0.79               2019-10-25       none
gordon-bee...   github                   GitHub Widget            0.10.0               2016-03-16       none
ms-devlabs      vsts-extensions-mult...  Multivalue control       2.2.26               2019-11-15       none
agile-exte...   product-vision           Product Vision           2.0.6                2019-06-04       none
mohitbagra      related-workitems        Related Work items       2.0.4                2017-11-12       none
YodLabs         TagsManager2             Tags Manager             0.9.31               2019-02-04       none
ms-devlabs      team-calendar            Team Calendar            2.0.15               2019-11-01       none
ms              vss-testmanager-web      Test Manager for TFS...  18.160.0.2130893445  2019-11-25       multiVersion, truste...  trusted
mmanela         vsts-workitem-recent...  Who recently viewed ...  1.0.4                2019-03-22       none
ottostreif...   wiql-editor              Wiql Editor              2.0.90               2019-06-21       none
mohitbagra      workitem-checklist       Work item checklist      3.2.4                2019-06-24       none
mohitbagra      witoneclickactions       Work item form one c...  2.3.2                2018-04-03       none
ms-devlabs      WorkItemVisualizatio...  Work Item Visualizat...  1.4.64               2018-04-03       none

拡張機能の情報を一覧表示する

az devops extension show コマンドを使用して、拡張機能に関する詳細を一覧表示できます。開始するには、 Azure DevOps CLI の概要に関するページを参照してください。

az devops extension show --extension-name
                         --publisher-name
                         [--org]

パラメーター - 拡張機能の情報を一覧表示する

extension-name: 拡張機能の名前。
publisher-name: 拡張機能の発行元の名前。
org: Azure DevOps 組織の URL。 az devops configure -d organization=ORG_URL を使用して、既定の組織を構成できます。既定として設定されていない場合、または git config を使用して取得された場合は必須です。例: --org https://dev.azure.com/MyOrganizationName/.

例 - 拡張機能の情報を一覧表示する

次のコマンドは、 Timetracker 拡張機能に関する情報を表形式で示しています。

az devops extension show --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       disabled

拡張機能のインストールのトラブルシューティング

一般的な問題を解決するには、次のトラブルシューティング手順に従います。

拡張機能のインストールに失敗する:
- アクセス許可を確認します。 拡張機能をインストールするには、プロジェクトコレクション管理者であるか、管理者によって必要なアクセス許可が付与されていることを確認します。
- 拡張機能の互換性を確認します。 拡張機能が Azure DevOps のバージョンと互換性があることを確認します。拡張機能の詳細ページで互換性情報を確認します。
- ネットワークの問題: ネットワーク接続が安定していること、およびインストールプロセスをブロックするファイアウォールまたはプロキシ設定がないことを確認します。
拡張機能がクラッシュするか、エラーが発生します。
- 診断情報を収集します。 拡張機能がクラッシュした場合やエラーが発生した場合は、問題の特定に役立つ診断情報を収集します。この情報には、エラーメッセージ、ログ、問題のスクリーンショットが含まれます。
- 拡張機能ログを確認します。 一部の拡張機能では、問題の診断に役立つログが提供されます。これらのログにアクセスして解釈する方法については、拡張機能のドキュメントを参照してください。
- サポートにお問い合わせください。 問題を解決できない場合は、収集された診断情報を拡張機能のサポートチームに問い合わせてください。問題のトラブルシューティングに役立つできるだけ詳しい情報を提供してください。
インストール後に拡張機能が表示されない:
- ページを更新します。 場合によっては、インストール直後に拡張機能が表示されないことがあります。
- アクセス許可を確認します。 拡張機能を表示して使用するために必要なアクセス許可があることを確認します。一部の拡張機能では、特定のアクセス許可を表示する必要がある場合があります。
- 拡張機能を再インストールします。 拡張機能がまだ表示されない場合は、アンインストールして再インストールしてみてください。

よく寄せられる質問 (FAQ)

Q: Marketplace のインストールページから組織が表示されないのはなぜですか?

A: Azure DevOps Marketplace から購入するときに組織が表示されない場合は、次の手順を試してください。

Visual Studio Marketplace へのサインインに使用する ID を確認します。右上隅で、ユーザー名を選択してプロファイルを表示します。
メールアドレスとディレクトリが正しいことを確認します。
ブラウザーのウィンドウをすべて閉じます。
プライベートまたはシークレット閲覧セッションを開きます。
Visual Studio Marketplace にサインインします。必要な組織内のユーザーの ID を使用します。

ヒント

Azure DevOps では、"職場または学校アカウント" または "個人用アカウント" のどちらかを選択するように求められる場合があります。その場合は、Microsoft アカウントと、組織が Microsoft Entra ID で管理する "職場または学校アカウント" と同じメールアドレスを使用しました。これらの ID は同じメールアドレスを持ちますが、プロファイル、セキュリティ設定、アクセス許可が異なる個別の ID です。選択する組織内のユーザーの ID を選択します。

Q: 拡張機能をインストールできないのはなぜですか?

A: 次のいずれかの理由で拡張機能をインストールすることはできません。

プロジェクトコレクション管理者グループのメンバーであるか、組織の所有者である。アクセス許可を持っていないが、プロジェクトメンバーである場合は、代わりに拡張機能を要求できます。
"既にインストール済みまたは要求済み" エラーが発生した場合は、プロジェクトコレクション管理者に確認し、拡張機能を割り当てるように依頼してください。

Q: ユーザーが拡張機能の機能にアクセスできないのはなぜですか?

A: ユーザーは、次のいずれかの理由で拡張機能にアクセスできません。

ほとんどの拡張機能では、ユーザーが利害関係者ではなく、少なくとも Basic アクセス権を持っている必要があります。たとえば、無料の Code Search 拡張機能をインストールできますが、各ユーザーは少なくともコードを検索するための Basic アクセス権を持っている必要があります。チームがアプリの品質を向上させるために、無料のテストおよびフィードバック拡張機能をインストールできます。アクセスレベルや、オフラインで作業するか、Azure DevOps Services またはオンプレミスの Azure DevOps Server に接続しているかに基づいて、さまざまな機能が発生します。詳細については、 Visual Studio Marketplace の [Azure DevOps] タブの拡張機能の説明を参照してください。
組織を使用していて、無料の延長試用版を開始した場合、試用版の有効期限が切れている可能性があります。試用版の有効期限が切れているかどうかを確認します。
1. 組織のツールバーで、[ ユーザー] を選択します。
2. 拡張機能ウィンドウに移動します。
3. 有効期限メッセージを確認して、拡張機能の有効期限が切れたかどうかを確認します。
組織を使用していて、この拡張機能に対して支払った場合は、この拡張機能をユーザーに割り当てられていることを確認してください。
1. 組織のツールバーで、[ユーザー] に移動 します。
2. 拡張機能ウィンドウに移動します。
3. 拡張機能がユーザーに割り当てられているかどうかを確認します。そうでない場合は、拡張機能をユーザーに割り当てます。

詳細については、「拡張機能をユーザーに割り当てる」を参照してください。

Q: プレビュー拡張機能はどうなりましたか?

A: 拡張機能がプレビューから外れている可能性があります。プレビュー期間が経過すると、拡張機能は有料の拡張として一般に提供されます。延長を購入する前に猶予期間が提供される場合があります。すべてのプレビュー拡張機能は、拡張機能を購入する前に無料試用版に自動的に変換されます。

Q: Azure DevOps Server の拡張機能をインストールできないのはなぜですか?

A: 次のいずれかの理由により、Azure DevOps Server の拡張機能をインストールすることはできません。

プロジェクトコレクション管理者グループのメンバーであるか、拡張機能をインストールするプロジェクト コレクションの [コレクションレベルの情報の編集] 権限を [許可] に設定します。アクセス許可がない場合は、代わりに拡張機能を要求できます。
拡張機能を既にインストールまたは要求したことを示すエラーが表示される場合があります。その場合は、 プロジェクトコレクション管理者 グループのメンバーに確認し、拡張機能を割り当てるように依頼します。詳細については、「アクセス許可レベルの引き上げを要求する」を参照してください。

Q: 必要なプロジェクトコレクション (オンプレミス) が表示されないのはなぜですか?

A: プロジェクトコレクションのメンバーになります。 Marketplace へのサインインに使用する ID を確認するには、次の手順に従います。

Azure DevOps Server Web ポータルのホームページ (https://{server}:8080/tfs/) で、ページの右上隅に移動し、ユーザー名を選択してプロファイルを表示します。
プロファイルの左側で、メールアドレスとディレクトリが正しいことを確認します。
ブラウザーのウィンドウをすべて閉じます。
プライベートまたはシークレット閲覧セッションを開きます。
拡張機能をインストールするプロジェクトコレクション内のユーザーの ID を使用して、Azure DevOps Server ホームページ (https://{server}:8080/tfs/) にサインインします。
Azure DevOps では、"職場または学校の組織" または "個人用アカウント" を選択するように求められる場合があります。このメッセージは、Microsoft アカウントと Microsoft Entra ID で組織が管理する "職場または学校アカウント" に同じメールアドレスを使用したことを意味します。これらの ID は同じメールアドレスを持ちますが、プロファイル、セキュリティ設定、アクセス許可が異なる個別の ID です。プロジェクトコレクション内のユーザーである ID を選択します。
プロジェクトコレクションから Marketplace に移動します。

Q: 必要な拡張機能にダウンロードボタン (オンプレミス) が表示されないのはなぜですか?

A: 一部の拡張機能は、次のいずれかの理由で Azure DevOps Services でのみ機能します。

この拡張機能では、Azure DevOps Server 用にまだリリースされていない Azure DevOps 機能が使用されます。
拡張機能マニフェストは、拡張機能が Azure DevOps Services でのみ使用可能であることを示します (ターゲット = Microsoft.Visualstudio.Services.Cloud)。
拡張機能マニフェストは、拡張機能が統合であることを示します (ターゲット = Microsoft.Visualstudio.Services.Integration)。

Q: 拡張機能を Azure DevOps Server にアップロードできないのはなぜですか?

A: Team Foundation Administrators グループのメンバーになる。拡張機能をアップロードする Azure DevOps Server でインスタンスレベルの情報を編集する権限も必要です。

次のステップ

拡張機能のアクセス許可を管理する

次の方法で共有

拡張機能のインストール

前提条件

拡張機能のインストール

高い特権、パイプライン デコレーター、非公開の拡張機能

拡張機能をアンインストールするか、無効にする

コマンド ラインを使用して拡張機能を有効または一覧表示する

パラメーター - 拡張機能を有効にする

例 - 拡張機能を有効にする

拡張機能を一覧表示する

省略可能なパラメーター - 拡張機能の一覧表示

例 - 拡張機能を一覧表示する

拡張機能の情報を一覧表示する

パラメーター - 拡張機能の情報を一覧表示する

例 - 拡張機能の情報を一覧表示する

拡張機能のインストールのトラブルシューティング

よく寄せられる質問 (FAQ)

Q: Marketplace のインストール ページから組織が表示されないのはなぜですか?

Q: 拡張機能をインストールできないのはなぜですか?

Q: ユーザーが拡張機能の機能にアクセスできないのはなぜですか?

Q: プレビュー拡張機能はどうなりましたか?

Q: Azure DevOps Server の拡張機能をインストールできないのはなぜですか?

Q: 必要なプロジェクト コレクション (オンプレミス) が表示されないのはなぜですか?

Q: 必要な拡張機能にダウンロード ボタン (オンプレミス) が表示されないのはなぜですか?

Q: 拡張機能を Azure DevOps Server にアップロードできないのはなぜですか?

次のステップ

関連記事

フィードバック

その他のリソース

高い特権、パイプラインデコレーター、非公開の拡張機能

コマンドラインを使用して拡張機能を有効または一覧表示する

Q: Marketplace のインストールページから組織が表示されないのはなぜですか?

Q: 必要なプロジェクトコレクション (オンプレミス) が表示されないのはなぜですか?

Q: 必要な拡張機能にダウンロードボタン (オンプレミス) が表示されないのはなぜですか?