安裝擴充功能

文章
07/03/2024

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

安裝、指派、停用和卸載擴充功能，以新增 Azure DevOps 的新功能。

如需延伸模組的詳細資訊，請參閱開發和發佈概觀。

必要條件

您必須是專案集合 Administrator 群組的成員，才能安裝延伸項目。組織擁有者自動成為這個群組的成員。如果您沒有權限，可以改為要求延伸項目，或是查詢專案集合管理員。
私人擴充功能必須與組織共用才能安裝。如需如何共用私人擴充功能的相關資訊，請參閱發佈文件。

只有 Project Collection Administrators 群組的成員或具有「編輯集合層級資訊」許可權的成員才能安裝延伸模組。組織擁有者自動成為這個群組的成員。如果您沒有權限，可以改為要求延伸項目，或是查詢專案集合管理員。
私人擴充功能必須與組織共用才能安裝。如需如何共用私人擴充功能的相關資訊，請參閱發佈文件。

注意

若要使用現有的 Azure 訂用帳戶進行計費，您必須至少擁有該訂用帳戶的共同管理員許可權。如果您沒有許可權，Azure 帳戶管理員或服務管理員可以將您新增為 Azure 入口網站中的 Azure 訂用帳戶的共同管理員。

您的專案集合會針對未來的 Marketplace 購買重複使用您的 Azure 訂用帳戶。哪裡可以找到有關 Azure 計費的詳細資訊？

安裝擴充功能

執行下列步驟，將擴充功能安裝到您的組織。

瀏覽器
Azure DevOps CLI

登入您的組織 (https://dev.azure.com/{yourorganization})。
選取購物袋圖示，然後選取 [ 流覽 Marketplace]。
尋找您要安裝的延伸模組，然後選取 [ 免費取得]。
從下拉功能表中選取您的組織，然後選取 [ 安裝 ] 以安裝延伸模組。
- 為什麼我看不到任何組織？
- 為什麼我無法安裝此延伸模組？

您的延伸模組現在已安裝！您現在可以移至您的組織以使用擴充功能。此外，請告知小組此延伸模組，讓他們能夠開始使用其功能。

已安裝擴充功能

使用 az devops extension install 命令來安裝擴充功能。若要開始使用，請參閱開始使用 Azure DevOps CLI。

搜尋延伸模組

如有必要，請先使用 az devops extension search 命令搜尋延伸模組。

az devops extension search --search-query

參數

search-query：指定要在市集中搜尋的字詞。

範例

下列命令會搜尋 Marketplace 中的 Timetracker 一詞，並以表格格式傳回發行者標識符和延伸模組識別碼。

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：擴充功能發行者的名稱。
組織：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

如果未安裝擴充功能，擴充功能命令會傳回「找不到命令」錯誤。

擴充位置：

安裝擴充功能之後，您可以在殼層變數的值 $AZURE_EXTENSION_DIR 下找到它。如果此變數未設定，則值預設位於 $HOME/.azure/cliextensions Linux和macOS上，以及 %USERPROFILE%\\.azure\\cliextensions Windows 上。

移至 [Marketplace.visualstudio.com]。
使用您的 Azure DevOps 認證登入。
尋找您要安裝的延伸模組。使用搜尋方塊來篩選延伸模組清單。
選取延伸模組，然後選取 [取得] 或 [免費取得]。或者，針對某些第三方延伸模組，選取 [ 開始使用] 以顯示定價資訊和延伸模組特定的安裝指示。

如果您沒有安裝延伸模組的許可權，您可以要求系統管理員為您安裝。您的要求會儲存在 Azure DevOps Server 中，並已準備好讓系統管理員注意。
選取 [ 下載 ] 以下載 vsix 檔案。
將 vsix 上傳至您的內部部署本機 Marketplace。開啟您的 Azure DevOps Server 首頁（https://{server}:DefaultCollection）。
移至 [集合設定>] 瀏覽本機擴充功能。
選取 [ 管理延伸模組 ]，然後上傳 vsix 檔案。
在 [管理延伸模組] 頁面上，在您的專案集合中 安裝延伸模組 。選取您要安裝延伸模組的專案集合，然後選擇 [ 安裝]。

選取專案集合並選擇 [安裝] 的螢幕快照。

安裝完成之後，請移至專案集合，或返回 Marketplace 以尋找其他延伸模組。

顯示延伸模組已完成安裝的螢幕快照。

登入您的組織 (https://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：擴充功能發行者的名稱。
組織：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：擴充功能發行者的名稱。
組織：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：擴充功能發行者的名稱。
組織：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。
組織：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：擴充功能發行者的名稱。
組織：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)

問：為什麼我看不到我的組織從 Marketplace 安裝頁面？

答：如果您在從 Azure DevOps Marketplace 購買時看不到您的組織，請嘗試下列步驟：

檢查您用來登入 Visual Studio Marketplace 的身分識別。在右上角，選取您的使用者名稱以檢視您的配置檔。
請確定您的電子郵件地址和目錄正確無誤。
關閉所有瀏覽器視窗。
開啟私人或無痕瀏覽會話。
登入 Visual Studio Marketplace。使用您想要之組織中使用者的身分識別。

提示

Azure DevOps 可能會要求您選擇「公司或學校帳戶」或「個人帳戶」。如果是，則您使用的電子郵件位址與Microsoft帳戶相同，以及貴組織在 Microsoft Entra 標識符中管理的「公司或學校帳戶」。雖然這些身分識別具有相同的電子郵件位址，但它們仍會以不同的配置檔、安全性設定和許可權來分隔身分識別。選擇您要選取之組織中使用者的身分識別。

問：為什麼我無法安裝擴充功能？

答：基於下列其中一個原因，您無法安裝擴充功能。

您必須是 Project Collection Administrators 群組的成員，或是組織擁有者。 如果您沒有許可權，但您是項目成員，您可以改為要求延伸模組。
如需「已安裝或要求」錯誤，請洽詢您的 Project Collection Administrator，並要求他們指派延伸模組給您。

問：為什麼用戶無法存取擴充功能？

答：使用者因下列其中一個原因而無法存取擴充功能。

大部分的擴充功能都需要使用者至少具有基本存取權，而不是項目關係人。例如，您可以安裝免費的程式代碼搜尋延伸模組，但每個使用者至少必須有基本存取權才能搜尋程序代碼。若要協助小組改善應用程式品質，您可以安裝免費的測試與意見反應延伸模組。您可以根據存取層級，以及離線工作或連線到 Azure DevOps Services 或內部部署 Azure DevOps Server，體驗不同的功能。如需詳細資訊，請參閱Visual Studio Marketplace、Azure DevOps 索引標籤中的擴充功能描述。
如果您使用組織並開始免費試用，您的試用版可能會過期。檢查您的試用版是否已過期。
1. 在您的組織工具列上，選取 [ 使用者]。
2. 移至延伸模組窗格。
3. 檢查到期訊息，以尋找您的延伸模組是否或何時過期。
如果您使用組織且已為此延伸模組付費，請確定您已將此延伸模組指派給使用者。
1. 在您的組織工具列上，移至 [ 使用者]。
2. 移至延伸模組窗格。
3. 檢查延伸模組是否已指派給使用者。如果不是，請將擴充功能指派給使用者。

如需詳細資訊，請參閱將擴充功能指派給使用者。

問：我的預覽延伸模組發生什麼事？

答：您的延伸模組可能處於預覽狀態。預覽期間之後，延伸模組通常會以付費延伸模組的形式提供。您可能必須在購買延伸模組之前提供寬限期。所有預覽延伸模組都會在您購買延伸模組之前自動轉換為免費試用。

問：為什麼我無法安裝適用於 Azure DevOps Server 的擴充功能？

答：由於下列其中一個原因，您無法為 Azure DevOps Server 安裝擴充功能：

您必須是 [專案集合管理員] 群組的成員，或將 [編輯集合層級資訊] 權限設定為 [允許] 在您要安裝延伸模組的專案集合中。如果您沒有許可權，您可以改為要求擴充功能。
您可能會收到錯誤，指出您已安裝或要求擴充功能。如果是，請洽詢 Project Collection Administrators 群組的成員，並要求他們指派延伸模組給您。如需詳細資訊，請參閱要求增加許可權等級。

問：為什麼我看不到我想要的專案集合（內部部署）？

答：您必須是專案集合的成員。請遵循下列步驟來檢查您用來登入 Marketplace 的身分識別。

在 Azure DevOps Server 入口網站首頁（https://{server}:8080/tfs/），移至頁面右上角，然後選取您的使用者名稱以檢視您的設定檔。
在設定檔左側，請確定您的電子郵件地址和目錄正確無誤。
關閉所有瀏覽器視窗。
開啟私人或無痕瀏覽會話。
使用您要安裝擴充功能之專案集合中的使用者身分識別登入您的 Azure DevOps Server 首頁（https://{server}:8080/tfs/）。

Azure DevOps 可能會要求您選擇「公司或學校組織」或「個人帳戶」。此訊息表示您在 Microsoft Entra 識別符中，針對Microsoft帳戶和貴組織管理的「公司或學校帳戶」使用相同的電子郵件位址。雖然這些身分識別具有相同的電子郵件位址，但它們仍會以不同的配置檔、安全性設定和許可權來分隔身分識別。選擇您專案集合中使用者身分識別。
從您的專案集合，移至 Marketplace。

問：為什麼我不想顯示下載按鈕的延伸模組（內部部署）？

答：某些擴充功能僅適用於 Azure DevOps Services，原因如下：

此延伸模組使用尚未針對 Azure DevOps Server 發行的 Azure DevOps 功能。
延伸模組指令清單指出延伸模組僅適用於 Azure DevOps Services（targets = Microsoft.Visualstudio.Services.Cloud）。
延伸模組指令清單指出延伸模組是整合（targets = Microsoft.Visualstudio.Services.Integration）。

問：為什麼我無法將擴充功能上傳至 Azure DevOps Server？

答：您必須是 Team Foundation Administrators 群組的成員。您也必須擁有 您想要上傳擴充功能之 Azure DevOps Server 的編輯實例層級信息 許可權。

問：如何? 取得 Azure 訂用帳戶、計費和 Marketplace 的支援？

答：視您需要的支援而定，從下列文章中選擇：

注意

Azure DevOps 支援小組不支援 Visual Studio Marketplace 擴充功能。若要取得 Marketplace 延伸模組的支援，請在 Visual Studio Marketplace 中找出您所使用的延伸模組。在延伸模組頁面上，您可以找到 GitHub 存放庫的連結，您可以在其中建立問題，或取得取得社群支持的連結。

下一步

管理延伸項目權限

分享方式：

安裝擴充功能

必要條件

安裝擴充功能

搜尋延伸模組

參數

範例

安裝擴充功能

參數

範例

解除安裝或停用延伸模組

解除安裝延伸模組

參數 - 卸載擴充功能

範例 - 卸載延伸模組

停用延伸模組

參數 - 停用擴充功能

範例 - 停用擴充功能

透過命令行啟用或列出延伸模組

參數 - 啟用擴充功能

範例 - 啟用擴充功能

列出延伸模組

選擇性參數 - 列表延伸模組

範例 - 清單延伸模組

列出延伸模組資訊

參數 - 列出延伸模組資訊

範例 - 列出延伸模組資訊

常見問題集 (FAQ)

問：為什麼我看不到我的組織從 Marketplace 安裝頁面？

問：為什麼我無法安裝擴充功能？

問：為什麼用戶無法存取擴充功能？

問：我的預覽延伸模組發生什麼事？

問：為什麼我無法安裝適用於 Azure DevOps Server 的擴充功能？

問：為什麼我看不到我想要的專案集合（內部部署）？

問：為什麼我不想顯示下載按鈕的延伸模組（內部部署）？

問：為什麼我無法將擴充功能上傳至 Azure DevOps Server？

問：如何? 取得 Azure 訂用帳戶、計費和 Marketplace 的支援？

下一步

意見反映

更多資源

分享方式：

安裝擴充功能

必要條件

安裝擴充功能

解除安裝或停用延伸模組

透過命令行啟用或列出延伸模組

參數 - 啟用擴充功能

範例 - 啟用擴充功能

列出延伸模組

選擇性參數 - 列表延伸模組

範例 - 清單延伸模組

列出延伸模組資訊

參數 - 列出延伸模組資訊

範例 - 列出延伸模組資訊

常見問題集 (FAQ)

問：為什麼我看不到我的組織從 Marketplace 安裝頁面？

問：為什麼我無法安裝擴充功能？

問：為什麼用戶無法存取擴充功能？

問：我的預覽延伸模組發生什麼事？

問：為什麼我無法安裝適用於 Azure DevOps Server 的擴充功能？

問：為什麼我看不到我想要的專案集合（內部部署）？

問：為什麼我不想顯示下載按鈕的延伸模組（內部部署）？

問：為什麼我無法將擴充功能上傳至 Azure DevOps Server？

問：如何? 取得 Azure 訂用帳戶、計費和 Marketplace 的支援？

下一步

相關文章

意見反映

更多資源