通过

安装和管理扩展

  • 适用于: ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Windows 管理中心构建为可扩展平台，每种连接类型和工具均为可单独安装、卸载和更新的扩展。 可以搜索由 Microsoft 和其他开发者发布的新扩展，单独安装和更新它们，不需更新整个 Windows Admin Center 安装。 也可配置单独的 NuGet 源或文件共享，然后分发在组织内部使用的扩展。

安装扩展

Windows 管理中心显示指定 NuGet 源中可用的扩展。 默认情况下，Windows Admin Center 指向 Microsoft 官方 NuGet 源，其中托管由 Microsoft 和其他开发者发布的扩展。

  1. 选择左窗格中右上角的>按钮，选择“扩展”。
  2. “ 可用扩展 ”选项卡列出了可用于安装的源上的扩展。
  3. 选择扩展以查看“ 详细信息 ”窗格中的扩展说明、版本、发布者和其他信息。
  4. 选择 “安装 ”以安装扩展。 如果网关必须以提升权限运行以进行此更改，则会显示用户帐户控制 (UAC) 提升提示。 安装完成后，浏览器会自动刷新，Windows 管理中心会重新加载并安装新扩展。 如果尝试安装的扩展是以前安装的扩展的更新，则可以选择 “更新到最新 ”按钮来安装更新。 还可以转到“ 已安装的扩展 ”选项卡以查看已安装的扩展，并查看 “状态 ”列中是否有可用的更新。

从另一源安装扩展

Windows Admin Center 支持多个源，你可以一次从多个源查看和管理包。 可以将任何支持 NuGet V2 API 或文件共享的 NuGet 源添加到 Windows Admin Center，方便从其安装扩展。

  1. 选择左窗格中右上角的>按钮，选择“扩展”。
  2. 在右窗格中，选择“ 源 ”选项卡。
  3. 选择 “添加 ”按钮以添加另一个源。 对于 NuGet 源，请输入 NuGet V2 源 URL。 NuGet 源提供者或管理员应该能够提供 URL 信息。 对于文件共享，请输入在其中存储扩展包文件 (.nupkg) 的文件共享的完整路径。 添加文件共享作为源时，必须满足以下条件：
    • 文件访问权限授予 NTAuthority\Network Service。
    • 文件路径不能包含 C:\Users 文件夹。
    • 文件共享上的包必须已签名，除非操作模式设置为“开发”。
  4. 选择 并添加。 如果网关必须以提升权限运行以进行此更改，则会显示 UAC 提升提示。 仅当你在桌面模式下运行 Windows Admin Center 时，才会显示此提示。

“可用扩展”列表显示所有已注册源中的扩展。 可以使用 包源 列检查每个扩展的源。

卸载扩展

你可以卸载之前安装的任何扩展，甚至卸载 Windows 管理中心安装时预装的任何工具。

  1. 选择左窗格中右上角的>按钮，选择“扩展”。
  2. 选择“ 已安装的扩展 ”选项卡以查看所有已安装的扩展。
  3. 选择要卸载的扩展，然后选择“ 卸载”。

卸载完成后，浏览器会自动刷新，Windows 管理中心会重新加载并移除扩展。 如果卸载了作为 Windows Admin Center 的一部分预安装的工具，该工具可在 “可用扩展 ”选项卡中重新安装。

在未连接 Internet 的情况下在计算机上安装扩展

如果 Windows Admin Center 安装在未连接到 Internet 的计算机上或位于代理后面的计算机上，则可能无法访问和安装 Windows Admin Center 源中的扩展。 可以通过手动方式或 PowerShell 脚本方式下载扩展包，并将 Windows Admin Center 配置为从文件共享或本地驱动器检索包。

手动下载扩展包

  1. 在另一台具有 Internet 连接的计算机上，打开 Web 浏览器并导航到以下 URL：https://dev.azure.com/WindowsAdminCenter/Windows%20Admin%20Center%20Feed/_packaging?_a=feed&feed=WAC

    你可能需要创建 Microsoft 帐户并登录以查看扩展包。

  2. 选择要安装的包的名称以查看包详细信息页。

  3. 选择包详细信息页顶部导航栏中的 “下载 ”链接，然后下载 .nupkg 扩展名的文件。

  4. 对所有需要下载的包重复步骤 2 和 3。

  5. 将包文件复制到可以从安装了 Windows Admin Center 的计算机访问的某个文件共享，或者复制到安装了 Windows Admin Center 的计算机上的本地磁盘。

  6. 按照说明从不同的源安装扩展。

通过 PowerShell 脚本下载包

Internet 上提供了用于从 NuGet 源下载 NuGet 包的脚本。 我们使用Microsoft高级项目经理 Jon Galloway 提供的脚本。

  1. 如 博客文章中所述，将脚本安装为 NuGet 包，或将脚本复制并粘贴到 PowerShell ISE 中。

  2. 将脚本的第一行编辑成你的 NuGet 源的 v2 URL。 如果要从 Windows Admin Center 官方源下载包，请使用以下 URL：

    $feedUrlBase = "https://aka.ms/sme-extension-feed"

  3. 运行脚本，它会将所有 NuGet 包从源下载到以下本地文件夹：%USERPROFILE%\Documents\NuGetLocal

  4. 按照说明从不同的源安装扩展。

使用 PowerShell 管理扩展

Windows Admin Center 预览版包含一个用于管理网关扩展的 PowerShell 模块。

# Add the module to the current session
Import-Module "$env:ProgramFiles\windows admin center\PowerShell\Modules\ExtensionTools"
# Available cmdlets: Get-Feed, Add-Feed, Remove-Feed, Get-Extension, Install-Extension, Uninstall-Extension, Update-Extension

# List feeds
Get-Feed "https://wac.contoso.com"

# Add a new extension feed
Add-Feed -GatewayEndpoint "https://wac.contoso.com" -Feed "\\WAC\our-private-extensions"

# Remove an extension feed
Remove-Feed -GatewayEndpoint "https://wac.contoso.com" -Feed "\\WAC\our-private-extensions"

# List all extensions
Get-Extension "https://wac.contoso.com"

# Install an extension (locate the latest version from all feeds and install it)
Install-Extension -GatewayEndpoint "https://wac.contoso.com" "msft.sme.containers"

# Install an extension (latest version from a specific feed, if the feed is not present, it will be added)
Install-Extension -GatewayEndpoint "https://wac.contoso.com" "msft.sme.containers" -Feed "https://aka.ms/sme-extension-feed"

# Install an extension (install a specific version)
Install-Extension "https://wac.contoso.com" "msft.sme.certificate-manager" "0.133.0"

# Uninstall-Extension
Uninstall-Extension "https://wac.contoso.com" "msft.sme.containers"

# Update-Extension
Update-Extension "https://wac.contoso.com" "msft.sme.containers"

Note

必须是网关管理员才能使用 PowerShell 修改 Windows Admin Center 扩展。

了解更多关于使用 Windows 管理中心 SDK 构建扩展的信息。

网关插件扩展

Windows Admin Center 网关插件扩展受现代化网关更改的影响最大。 Windows Admin Center 网关插件支持从工具 UI 或解决方案到目标节点的 API 通信。 Windows Admin Center 托管一个网关服务，该服务从要在目标节点上执行的网关插件中继命令和脚本。 可以扩展网关服务，以包括支持默认协议（PowerShell 和 WMI）以外的协议的自定义网关插件。

由于网关插件与 Windows Admin Center 的后端通信以启用 API 通信，因此网关插件代码可以包含使用 .NET Framework 版本 4.6.2 编写的组件，该组件不适用于 .NET 8。

此外，我们修改了插件使用版本 2410 的方式。 扩展现在将以 IPlugIn的形式编写，而不是开发从命名空间实现Microsoft.ManagementExperience.FeatureInterfaces接口以扩展网关插件的 C# 类。 与简单的 C# 类和广泛的文档相比，这些控制器提高了灵活性。

查看我们的开发人员文档 ，详细了解 Windows Admin Center 中的网关插件开发。

不支持网关扩展

未配置 Windows Admin Center 网关的扩展源。 除非添加扩展源，否则 Windows Admin Center 安装程序中不包含的扩展（包括外部合作伙伴扩展）不可用。

在安装现代化网关版本时，可以使用以下扩展：

  • 应用和功能
  • Azure 备份
  • Azure 文件同步
  • Azure 混合中心
  • Azure Kubernetes 服务
  • 证书
  • 群集创建
  • 群集管理器
  • 开发人员指南
  • 设备
  • 事件
  • 故障转移群集工具
  • 文件和文件共享
  • 防火墙
  • 本地用户和组
  • 网络控制器工具和 SDN 虚拟网络
  • 网络
  • 数据包监视
  • 性能监视器
  • PowerShell
  • Processes
  • Registry
  • 远程桌面
  • 角色和功能
  • 计划任务
  • SDN 网关连接
  • SDN 基础结构
  • SDN 逻辑网络
  • SDN 网络安全组
  • 安全性
  • 服务器管理器和计算机管理
  • Services
  • 存储
  • 存储迁移服务
  • 存储副本
  • System Insights
  • 更新
  • 虚拟机和交换机