安装扩展
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018
了解如何安装、分配、禁用和卸载扩展，从而为 Azure DevOps 添加新特性和功能。
先决条件
注意
若要使用现有 Azure 订阅进行计费，必须至少具有该订阅的共同管理员权限。 如果没有权限，Azure 帐户管理员或服务管理员可以将你作为共同管理员添加到Azure 门户中的 Azure 订阅。
项目集合将重复使用 Azure 订阅以用于将来的市场购买。 在哪里可以找到有关 Azure 计费的详细信息？
安装扩展
执行以下步骤，将扩展安装到组织。
登录组织 (
https://dev.azure.com/{yourorganization})。选择购物袋图标，然后选择“ 浏览市场”。
找到要安装的扩展，然后选择“ 免费获取”。
从下拉菜单中选择组织，然后选择 “安装 ”以安装扩展。
扩展现已安装！ 现在可以转到组织以使用扩展。 此外，请告知团队有关此扩展的信息，以便他们能够开始使用其功能。
() 打开Azure DevOps Server
https://{server}:DefaultCollection主页。打开扩展菜单，然后选择 “浏览市场”。
找到要安装的扩展。 使用搜索框筛选扩展列表。
选择扩展，然后选择 “获取 ”或“ 免费获取”。 或者，对于某些第三方扩展，选择 “入门” 以显示定价信息和特定于扩展的安装说明。
如果你没有安装扩展的权限，可以请求管理员为你安装它。 你的请求存储在 Azure DevOps Server 中，可供管理员注意。
选择要在其中安装此扩展的项目集合，然后选择 “安装”。
安装完成后，请转到项目集合或返回到市场以查找其他扩展。
从Azure DevOps Server主页 (
https://{server}:8080/tfs/) ，转到要在其中安装扩展的项目集合。打开扩展菜单，然后选择 “浏览市场”。
找到并选择要安装的扩展。
选择扩展，然后选择 “安装”。
确认要安装此扩展的项目集合。
完成扩展的安装。
将扩展分配给需要访问权限的用户。 否则，可以转到项目集合以使用扩展。 告知团队有关此扩展的信息，以便他们也可以开始使用其功能。
断开连接时安装扩展
断开与Azure DevOps Server的连接后，可以安装免费扩展和预览版扩展。 首先，下载扩展，然后将其上传到Azure DevOps Server，然后将其安装在项目集合中。
从市场下载
登录到 市场 > Azure DevOps。
找到要安装的扩展。
下载并保存扩展。
将扩展上传到 Azure DevOps
浏览下载的扩展 (
https://{server}:8080/tfs/_gallery) 。选择 “管理扩展”。
选择 “上传新扩展”。
提示
上传的最大大小为 25MB。 如果无法解决此要求，请在开发者社区中报告问题。
在项目集合中安装扩展
选择并安装已上传的扩展。
选择要在其中安装扩展的项目集合。
查看扩展在安装时获得的权限。 完成扩展的安装。
现在可以转到项目集合以使用扩展。 告知团队有关此扩展的信息，以便他们也可以开始使用其功能。
为断开连接的 TFS (第一方) 安装预安装的扩展
注意
本部分仅适用于 (第一方) 添加预安装的扩展，如果要安装未使用 TFS 预安装的扩展，请参阅 断开连接时安装扩展部分。
对于随 TFS 预安装的第一方扩展，下面是防止兼容性问题的替代安装方法。
将鼠标悬停在购物袋上，然后选择 “管理扩展”
进入“扩展”页后，选择“ 浏览本地扩展”
向下滚动，直到看到“计划和跟踪”类别，其中包括 交付计划。 选择“ 传递计划”。
你将重定向到“交付计划”的本地扩展页，在其中选择“ 安装”。 当处于联机和脱机状态时，安装将正常工作。
从本地库安装扩展
本地扩展库中预安装了多个扩展。 用户可以安装这些扩展，而无需与市场或 Internet 建立外部连接。
提示
以前从市场安装的扩展会自动显示在本地库中，以便可以轻松地将其安装到其他项目集合中。
打开“扩展”菜单，然后选择“ 管理扩展”。
在“扩展”页中，选择“ 浏览本地扩展”
选择要安装的扩展。
选择要在其中安装此扩展的项目集合，然后选择 “安装”。
安装完成后，请转到项目集合或返回到市场以查找其他扩展。
卸载或禁用扩展
登录组织 (
https://dev.azure.com/{yourorganization})。选择
“组织设置”。
选择“ 扩展”，然后选择要卸载或禁用的扩展。
选择“ 卸载 ”或选择省略号 (...) ，然后选择“ 禁用”。
若要卸载集合中的扩展，请执行以下步骤。
转到本地库管理门户 (
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)
问：为什么我在市场安装页面看不到我的组织？
答：如果在从 Azure DevOps 市场购买时看不到组织，请尝试以下步骤：
- 检查用于登录 Visual Studio 市场的标识。 在右上角，选择用户名以查看个人资料。
- 在左侧，请确保电子邮件地址和目录正确。
- 关闭所有浏览器窗口。
- 打开专用或隐身浏览会话。
- 登录到 Visual Studio 市场。 使用组织中所需用户的标识。
提示
Azure DevOps 可能会要求你在“工作或学校帐户”或“个人帐户”之间进行选择。 如果是这样，则你使用了 Microsoft 帐户和组织在 Azure Active Directory 中管理的“工作或学校帐户”相同的电子邮件地址。 尽管这些标识具有相同的电子邮件地址，但它们仍然是具有不同配置文件、安全设置和权限的单独标识。 选择要选择的组织中的用户的标识。
问：为什么无法安装扩展？
答：由于以下原因之一，无法安装扩展。
- 您必须是 Project 集合管理员 组 的成员或 组织所有者。 如果你没有权限，但你是项目成员，则可以 改为请求扩展 。
- 对于“已安装或请求”错误，检查与 Project 集合管理员联系，并要求他们为你分配扩展。
问：为什么用户无法访问扩展功能？
答：由于以下原因之一，用户无法访问扩展：
大多数扩展要求用户至少具有基本访问权限，而不是利益干系人。 例如，可以安装免费的 代码搜索扩展，但每个用户必须至少具有基本访问权限才能搜索代码。 为了帮助团队提高应用质量，可以安装免费的 测试 & 反馈扩展。 根据访问级别以及是脱机工作还是连接到Azure DevOps Services或本地Azure DevOps Server，你将体验不同的功能。 有关详细信息，请参阅 Visual Studio Marketplace，Azure DevOps 选项卡中的扩展说明。
如果你使用的是组织，并且启动了免费扩展试用版，则你的试用版可能已过期。 若要检查试用版是否已过期，
- 在组织工具栏上，选择“ 用户”。
- 转到扩展窗格。
- 检查过期消息，以查找扩展是否过期或何时过期。
如果你使用的是组织，并且为此扩展付费，请确保已将此扩展分配给用户。
- 在组织工具栏上，转到 “用户”。
- 转到扩展窗格。
- 检查扩展是否已分配给用户。 如果不是，请将扩展分配给用户。
有关详细信息，请参阅 向用户分配扩展。
问：我的预览版扩展发生了什么情况？
答：你的扩展可能已移出预览版。 预览期过后，较长的扩展通常作为付费扩展提供。 在购买扩展之前，可能会提供宽限期。 在购买扩展之前，所有预览版扩展会自动转换为 免费试用版 。
问：为什么无法安装Azure DevOps Server的扩展？ (本地)
答：由于以下原因之一，无法为 Azure DevOps Server 安装扩展：
- 您必须是 项目集合管理员 组的成员，或者必须在要安装扩展的项目集合中将 “编辑集合级别信息” 权限设置为 “允许 ”。 如果没有权限，可以 改为请求扩展 。
- 你可能会收到一个错误，指出你已安装或请求了扩展。 如果是这样，检查项目集合管理员组的成员，并要求他们为你分配扩展。 有关详细信息，请参阅 请求增加权限级别。
问：为什么看不到所需的项目集合？ (本地)
答：必须是项目集合的成员。 按照以下步骤检查用于登录市场的标识。
在Azure DevOps Server Web 门户主页 (
https://{server}:8080/tfs/) ，转到页面右上角，然后选择用户名以查看个人资料。在配置文件左侧，确保电子邮件地址和目录正确无误。
关闭所有浏览器窗口。
打开专用或隐身浏览会话。
使用要安装扩展的项目集合中的用户的标识登录到Azure DevOps Server主页 (
https://{server}:8080/tfs/) 。Azure DevOps 可能会要求你在“工作或学校组织”或“个人帐户”之间进行选择。此消息表示你使用的电子邮件地址与 Microsoft 帐户相同，以及组织在 Azure Active Directory 中管理的“工作或学校帐户”。 尽管这些标识具有相同的电子邮件地址，但它们仍然是具有不同配置文件、安全设置和权限的单独标识。 选择项目集合中用户的身份。
从项目集合中，转到市场。
问：为什么我想要的扩展不显示下载按钮？ (本地)
答：由于以下原因之一，某些扩展仅适用于 Azure DevOps Services：
- 该扩展使用尚未针对Azure DevOps Server发布的 Azure DevOps 功能。
- 扩展清单指示扩展仅适用于Azure DevOps Services (目标 = Microsoft.Visualstudio.Services.Cloud) 。
- 扩展清单指示扩展是集成 (目标 = Microsoft.Visualstudio.Services.Integration) 。
问：为什么无法将扩展上传到 Azure DevOps Server？ (本地)
答：必须是 Team Foundation 管理员组的成员。 还必须对要在其中上传扩展的Azure DevOps Server拥有“编辑实例级信息”权限。
问：如何实现获取对 Azure 订阅、计费和市场的支持？
答：根据所需的支持，从以下文章中进行选择：
注意
Azure DevOps 支持团队无法支持 Visual Studio 市场扩展。 若要获取市场扩展方面的支持，请在 Visual Studio Marketplace 中找到所使用的扩展。 在扩展页上，你可以找到指向 GitHub 存储库（可在其中创建问题）的链接，或获取社区支持的链接。