拡張機能のインストール

  • [アーティクル]

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

Azure DevOps の新機能を追加する拡張機能をインストール、割り当て、無効化、アンインストールする方法について説明します。

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

前提条件

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

注意

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

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

拡張機能のインストール

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

  1. 組織にサインインします (https://dev.azure.com/{yourorganization})。

  2. ショッピング バッグ アイコンを選択し、[ Marketplace の参照] を選択します。

    強調表示されたショッピング バッグ アイコンと [Marketplace の参照] ボタンの選択を示すスクリーンショット。

  3. インストールする拡張機能を見つけて、[ 無料で入手] を選択します。

    [無料で入手] ボタンが強調表示されている赤い四角形を示すスクリーンショット。

  4. ドロップダウン メニューから組織を選択し、[ インストール ] を選択して拡張機能をインストールします。

    この拡張機能の組織を選択する

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

インストールされた拡張機能

  1. Azure DevOps Serverホーム ページ (https://{server}:DefaultCollection) を開きます。

  2. 拡張機能メニューを開き、[ Marketplace の参照] を選択します。

    Marketplace を参照する

  3. インストールする拡張機能を見つけます。 検索ボックスを使用して、拡張機能の一覧をフィルター処理します。

    拡張機能を選択する

  4. 拡張機能を選択し、[ 取得 ] または [ 無料で入手] を選択します。 または、一部のサード パーティ製拡張機能の場合は、[ 作業の開始 ] を選択して、価格情報と拡張機能固有のインストール手順を表示します。

    拡張機能を取得する

    拡張機能をインストールするアクセス許可がない場合は、管理者にインストールを依頼できます。 要求はAzure DevOps Serverに格納され、管理者から注意を払う準備ができています。

  5. この拡張機能をインストールするプロジェクト コレクションを選択し、[インストール] を選択 します。

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

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

    インストールが完了しました

  1. Azure DevOps Serverホーム ページ (https://{server}:8080/tfs/) から、拡張機能をインストールするプロジェクト コレクションに移動します。

  2. 拡張機能メニューを開き、[ Marketplace の参照] を選択します。

    強調表示された [Marketplace の参照] ボタンを示すスクリーンショット。

  3. インストールする拡張機能を見つけて選択します。

    選択した拡張機能の例を示すスクリーンショット。

  4. 拡張機能を選択し、[インストール] を 選択します。

  5. この拡張機能をインストールするプロジェクト コレクションを確認します。

    Project コレクションを示す選択。

  6. 拡張機能のインストールを完了します。

  7. アクセスが必要なユーザーに拡張機能を割り当てます。 それ以外の場合は、プロジェクト コレクションに移動して拡張機能を使用できます。 この拡張機能についてチームに伝えて、機能の使用も開始できるようにします。

    インストールされている拡張機能の確認を示すスクリーンショット。

切断時に拡張機能をインストールする

Azure DevOps Serverから切断された場合は、無料の拡張機能とプレビュー拡張機能をインストールできます。 まず、拡張機能をダウンロードし、Azure DevOps Serverにアップロードしてから、プロジェクト コレクションにインストールします。

Marketplace からダウンロードする

  1. Marketplace > Azure DevOps にサインインします。

  2. インストールする拡張機能を見つけます。

    Marketplace での拡張機能の検索を示すスクリーンショット。

    拡張機能の検索を示すスクリーンショット。

  3. 拡張機能をダウンロードして保存します。

    拡張機能のダウンロードを示すスクリーンショット。

拡張機能を Azure DevOps にアップロードする

  1. ダウンロードした拡張機能を参照します (https://{server}:8080/tfs/_gallery)。

  2. [ 拡張機能の管理] を選択します。

    選択した [拡張機能の管理] ボタンを示すスクリーンショット。

  3. [ 新しい拡張機能のアップロード] を選択します。

    選択した [新しい拡張機能のアップロード] ボタンを示すスクリーンショット。

    拡張機能をアップロードできないのはなぜですか?

ヒント

アップロードの最大サイズは 25 MB です。 この要件を回避できない場合は、Developer Communityで問題を報告してください。

プロジェクト コレクションに拡張機能をインストールする

  1. アップロードした拡張機能を選択してインストールします。

    拡張機能の選択を示すスクリーンショット。

  2. 拡張機能をインストールするプロジェクト コレクションを選択します。

    [続行] ボタンの選択を示すスクリーンショット。

  3. 拡張機能のインストール時に取得するアクセス許可を確認します。 拡張機能のインストールを完了します。

    拡張機能に付与されたアクセス許可のレビューを示すスクリーンショット。

    これで、プロジェクト コレクションに移動して拡張機能を使用できるようになりました。 この拡張機能についてチームに伝えて、機能の使用も開始できるようにします。

切断された TFS 用にプレインストールされた拡張機能 (ファースト パーティ) をインストールする

注意

このセクションは、プレインストールされた拡張機能 (ファースト パーティ) を追加することのみを目的としています。TFS でプレインストールされていない拡張機能をインストールする場合は、「 切断時に拡張機能をインストールする」セクションを参照してください。

TFS と共にプレインストールされるファースト パーティの拡張機能の場合、互換性の問題を防ぐ別のインストール方法を次に示します。

  1. ショッピング バッグの上にマウス ポインターを合わせ、[拡張機能の管理] を選択します

    [拡張機能の管理] を選択します。

  2. [拡張機能] ページで、[ローカル拡張機能の参照] を選択します

    [拡張機能] ページで、ローカル拡張機能を参照します

  3. [プランと追跡] カテゴリ ( 配信プランを含む) が表示されるまで下にスクロールします。 [ 配信プラン] を選択します。

    拡張機能を選択する

  4. [ インストール] を選択した配信プランのローカル拡張機能ページにリダイレクトされます。 インストールは、オンラインとオフラインの場合に機能します。

    配信プラン拡張機能ギャラリー

ローカル拡張機能ギャラリーには、いくつかの拡張機能がプレインストールされています。 ユーザーは、Marketplace またはインターネットへの外部接続を必要とせずに、これらの拡張機能をインストールできます。

ヒント

Marketplace から以前にインストールされた拡張機能は、他のプロジェクト コレクションに簡単にインストールできるように、ローカル ギャラリーに自動的に表示されます。

  1. 拡張機能メニューを開き、[ 拡張機能の管理] を選択します。

    [拡張機能] メニューの [拡張機能の管理] を選択します。

  2. [拡張機能] ページで、[ローカル拡張機能の参照] を選択します

    ローカル拡張機能を参照する

  3. インストールする拡張機能を選択します。

    ローカル拡張機能を選択する

  4. この拡張機能をインストールするプロジェクト コレクションを選択し、[インストール] を選択 します。

    この拡張機能をインストールするプロジェクト コレクションを選択し、[インストール] を選択します。

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

    インストールが完了しました

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

注意

拡張機能のすべての ユーザーをゼロ (0) に減らすまで、有料拡張機能の料金は続きます。

  1. 組織にサインインします (https://dev.azure.com/{yourorganization})。

  2. 歯車アイコン[組織の設定] を選択します。

    組織の設定を開く

  3. [ 拡張機能] を選択し、アンインストールまたは無効にする拡張機能を選択します。

    拡張機能のアンインストールまたは無効化を選択する

  4. [ アンインストール] を選択するか、省略記号 (...) を選択し、[ 無効にする] を選択します。

    拡張機能を無効またはアンインストールする

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

  1. ローカル ギャラリー管理ポータル (http://{server}:8080/tfs/_gallery/manage) に移動します。

  2. 目的の拡張機能に対して省略記号 (...) を選択し、[ 削除] を選択します。

    拡張機能を削除する

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

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 から購入するときに組織が表示されない場合は、次の手順を試してください。

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

ヒント

Azure DevOps では、"職場または学校アカウント" または "個人用アカウント" のどちらかを選択するように求められる場合があります。 その場合は、Microsoft アカウントと、組織が Azure Active Directory で管理する "職場または学校アカウント" に同じメール アドレスを使用しました。 これらの 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 を確認するには、次の手順に従います。

  1. Azure DevOps Server Web ポータルのホーム ページ (https://{server}:8080/tfs/) で、ページの右上隅に移動し、ユーザー名を選択してプロファイルを表示します。

  2. プロファイルの左側で、メール アドレスとディレクトリが正しいことを確認します。

  3. すべてのブラウザー ウィンドウを閉じます。

  4. プライベートまたはシークレットブラウズセッションを開きます。

  5. 拡張機能をインストールするプロジェクト コレクションのユーザーである ID を使用して、Azure DevOps Serverホーム ページ (https://{server}:8080/tfs/) にサインインします。

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

  6. プロジェクト コレクションから Marketplace に移動します。

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

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

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

Q: 拡張機能をAzure DevOps Serverにアップロードできないのはなぜですか? (オンプレミス)

A: Team Foundation Administrators グループのメンバーである必要があります。 拡張機能をアップロードするAzure DevOps Serverのインスタンス レベルの情報の編集アクセス許可も必要です。

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

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

注意

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

次のステップ

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