安裝擴充功能

發行項
03/17/2025

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

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

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

必要條件

類別	需求
許可	Project Collection Administrators 群組的成員。組織擁有者自動成為這個群組的成員。如果您沒有權限，可以改為要求延伸項目，或是查詢專案集合管理員。
擴充功能的分享	私人擴充套件已與您的組織共用。

類別	需求
許可	屬於專案集合管理員群組或具有編輯集合層級資訊許可權的成員。組織擁有者自動成為這個群組的成員。如果您沒有權限，可以改為要求延伸項目，或是查詢專案集合管理員。
擴展模組分享	私人延伸模組已與貴組織共用。

注意事項

若要使用現有的 Azure 訂用帳戶進行計費，請至少擁有該訂用帳戶的共同管理員許可權。如果您沒有許可權，Azure 帳戶管理員或服務管理員可以在 Azure 入口網站中的 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：指定要在市集中搜尋的字詞。

範例

下列命令會搜尋 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：擴充功能發行者的名稱。
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

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

擴充位置：

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

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

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

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

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

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

高風險擴充套件

某些擴充功能會標示為高風險。如需詳細資訊並瞭解此分類背後的原因，請參閱高風險延伸模組。

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

針對擴充功能安裝進行疑難排解

若要解決常見問題，請遵循下列疑難解答步驟：

無法安裝 擴充功能：
- 檢查許可權： 若要安裝延伸模組，請確定您是專案集合管理員，或具有系統管理員授與的必要許可權。
- 確認擴充功能相容性： 確定擴充功能與您的 Azure DevOps 版本相容。如需相容性資訊，請查看延伸模組的詳細數據頁面。
- 網路問題： 確認您的網路連線穩定，且沒有防火牆或 Proxy 設定封鎖安裝程式。
擴充功能損毀或造成錯誤：
- 收集診斷資訊： 如果擴充功能當機或造成錯誤，請收集診斷資訊以協助識別問題。此資訊包括問題的錯誤訊息、記錄和螢幕快照。
- 檢查擴充功能記錄： 某些延伸模組提供可協助診斷問題的記錄。如需如何存取和解譯這些記錄的資訊，請參閱延伸模組的檔。
- 連絡支持人員： 如果您無法解決問題，請連絡擴充功能的支持小組，以取得收集的診斷資訊。盡可能提供詳細數據，以協助他們針對問題進行疑難解答。
安裝後看不到 擴充功能：
- 重新整理頁面： 有時，擴充功能可能不會在安裝后立即出現。
- 檢查許可權： 確定您具有檢視和使用延伸模組的必要許可權。某些延伸模組可能需要顯示特定許可權。
- 重新安裝擴充功能： 如果延伸模組仍然看不到，請嘗試卸載再重新安裝。

常見問題集 (FAQ)

問：為什麼我在 Marketplace 安裝頁面上找不到我的組織？

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

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

提示

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

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

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

成為 專案集合系統管理員 群組的成員，或是 組織擁有者。如果您沒有許可權，但您是項目成員，您可以改為要求延伸模組。
如遇到「已安裝或要求」的錯誤，請聯繫您的專案集合管理員，並請他們為您分配擴充功能。

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

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

大部分的擴充功能都需要使用者至少具有基本存取權，而不是項目關係人。例如，您可以安裝免費的程式代碼搜尋延伸模組，但每個使用者至少必須有基本存取權才能搜尋程序代碼。若要協助小組改善應用程式品質，您可以安裝免費的測試與意見反應延伸模組。您可以根據存取層級，以及離線工作或連線到 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 上的「編輯實例層級資訊」許可權。

下一步

管理延伸項目權限

共用方式為

安裝擴充功能

必要條件

安裝擴充功能

搜尋擴充功能

參數

範例

安裝擴充功能

參數

範例

高風險擴充套件

解除安裝或停用延伸模組

解除安裝延伸模組

參數 - 卸載擴充功能

範例 - 移除擴充功能

停用延伸模組

參數 - 停用擴充功能

範例 - 停用擴充功能

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

參數 - 啟用擴充功能

範例 - 啟用擴充功能

列出擴充功能

選擇性參數 - 列表擴展

範例 - 列出擴充功能

列出擴充套件資訊

參數 - 列出擴展資訊

範例 - 列出擴充套件資訊

針對擴充功能安裝進行疑難排解

常見問題集 (FAQ)

問：為什麼我在 Marketplace 安裝頁面上找不到我的組織？

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

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

問：我的預覽擴充功能怎麼了？

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

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

問：為什麼我想要的擴充功能在（內部部署）環境下不顯示下載按鈕？

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

下一步

意見反應

其他資源

共用方式為

安裝擴充功能

必要條件

安裝擴充功能

高風險擴充套件

解除安裝或停用延伸模組

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

參數 - 啟用擴充功能

範例 - 啟用擴充功能

列出擴充功能

選擇性參數 - 列表擴展

範例 - 列出擴充功能

列出擴充套件資訊

參數 - 列出擴展資訊

範例 - 列出擴充套件資訊

針對擴充功能安裝進行疑難排解

常見問題集 (FAQ)

問：為什麼我在 Marketplace 安裝頁面上找不到我的組織？

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

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

問：我的預覽擴充功能怎麼了？

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

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

問：為什麼我想要的擴充功能在（內部部署）環境下不顯示下載按鈕？

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

下一步

相關文章

意見反應

其他資源