拡張機能のインストール

[アーティクル]
04/04/2024

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

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

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

前提条件

拡張機能をインストールするには、プロジェクトコレクション管理者グループのメンバーである必要があります。組織の所有者は、自動的にこのグループのメンバーになります。アクセス許可がない場合は、代わりに拡張機能をリクエストするか、プロジェクトコレクション管理者を検索することができます。
非公開の拡張機能をインストールするには、組織と共有する必要があります。非公開の拡張機能を共有する方法については、ドキュメントの発行に関するページを参照してください。

Project Collection 管理istrators グループのメンバー、または "コレクションレベルの情報の編集" 権限を持つメンバーのみが拡張機能をインストールできます。組織の所有者は、自動的にこのグループのメンバーになります。アクセス許可がない場合は、代わりに拡張機能をリクエストするか、プロジェクトコレクション管理者を検索することができます。
非公開の拡張機能をインストールするには、組織と共有する必要があります。非公開の拡張機能を共有する方法については、ドキュメントの発行に関するページを参照してください。

Note

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

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

拡張機能のインストール

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

ブラウザー
Azure DevOps CLI

organizationhttps://dev.azure.com/{yourorganization} () にサインインします。
ショッピングバッグアイコンを選択し、[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 の場合) になります。

Marketplace.visualstudio.com に移動します。
Azure DevOps 資格情報を使用してサインインします。
インストールする拡張機能を見つけます。検索ボックスを使用して、拡張機能の一覧をフィルター処理します。
拡張機能を選択し、[取得] または [無料で入手] を選択します。または、一部のサードパーティの拡張機能については、[はじめに] を選択して、価格情報と拡張機能固有のインストール手順を表示します。

拡張機能をインストールするアクセス許可がない場合は、管理者にインストールを依頼できます。要求は Azure DevOps Server に格納され、管理者から注意を引く準備ができています。
[ダウンロード] を選択して vsix ファイルをダウンロードします。
オンプレミスのローカル Marketplace に vsix をアップロードします。 Azure DevOps Server のホームページ (https://{server}:DefaultCollection) を開きます。
[コレクションの設定>] に移動します。ローカル拡張機能を参照します。
[拡張機能の管理] を選択し、vsix ファイルをアップロードします。
[拡張機能の管理] ページで、プロジェクトコレクションに拡張機能をインストールします。拡張機能をインストールするプロジェクトコレクションを選択し、[インストール] を選択します。

[プロジェクトコレクションの選択] のスクリーンショット。[インストール] を選択します。

インストールが完了したら、プロジェクトコレクションに移動するか、Marketplace に戻って他の拡張機能を見つけます。

拡張機能のインストールが完了したことを示すスクリーンショット。

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

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

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

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/.
yes: 省略可能。確認を求めるプロンプトを表示しません。

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

次のコマンドは、確認を求めずに "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

よく寄せられる質問 (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: 次のいずれかの理由で拡張機能をインストールすることはできません。

Project Collection 管理istrators グループのメンバーであるか、組織の所有者である必要があります。アクセス許可を持っていないが、プロジェクトメンバーである場合は、代わりに拡張機能を要求できます。
"既にインストール済みまたは要求済み" エラーの場合は、Project Collection 管理istrator とチェックし、拡張機能を割り当てるように依頼します。

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 の拡張機能をインストールすることはできません。

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

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 管理istrators グループのメンバーである必要があります。拡張機能を アップロードする Azure DevOps Server のインスタンスレベルの情報 の編集アクセス許可も必要です。

Q: Azure サブスクリプション、課金、Marketplace のサポートを受ける操作方法は?

A: 必要なサポートに応じて、次の記事から選択します。

Note

Azure DevOps サポートチームは、Visual Studio Marketplace 拡張機能をサポートしていません。 Marketplace 拡張機能のサポートを受けるためには、 Visual Studio Marketplace で使用している拡張機能を見つけます。拡張機能ページには、GitHub リポジトリへのリンクがあり、そこで問題を作成したり、コミュニティのサポートを受けたりするためのリンクを取得したりできます。

次のステップ

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

拡張機能のインストール

前提条件

拡張機能のインストール

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

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

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

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

拡張機能を一覧表示する

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Q: Azure サブスクリプション、課金、Marketplace のサポートを受ける操作方法は?

次のステップ

関連記事

フィードバック

フィードバック

その他のリソース

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

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

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

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