安装和管理扩展

项目
11/13/2024
适用于:

✅ Windows Admin Center, ✅ Windows Admin Center Preview

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

安装扩展

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

选择左窗格中右上角>的“设置”按钮，选择“扩展”。
“ 可用扩展 ”选项卡列出了可用于安装的源上的扩展。
选择扩展以查看“详细信息”窗格中的扩展说明、版本、发布服务器和其他信息。
选择“安装”以安装扩展。如果网关必须以提升模式运行才能进行此更改，则会看到用户帐户控制（UAC）提升提示。安装完成后，浏览器会自动刷新，Windows Admin Center 会随新扩展一起重新加载。如果尝试安装的扩展是以前安装的扩展的更新，则可以选择“ 更新到最新 ”按钮来安装更新。也可转到“已安装的扩展”选项卡来查看已安装的扩展，以及查看某个更新在“状态”列中是否可用。

从另一源安装扩展

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

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

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

卸载扩展

可以卸载以前安装的任何扩展，甚至卸载预安装为 Windows Admin Center 安装一部分的任何工具。

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

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

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

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

手动下载扩展包

在另一台具有互联网连接的计算机上，打开 Web 浏览器并导航到以下 URL：https://dev.azure.com/WindowsAdminCenter/Windows%20Admin%20Center%20Feed/_packaging?_a=feed&feed=WAC
- 可能需要创建Microsoft帐户并登录才能查看扩展包。
选择要安装的包的名称以查看包详细信息页。
选择包详细信息页顶部导航栏中的“下载”链接，然后下载扩展名的 .nupkg 文件。
对所有需要下载的包重复步骤 2 和 3。
将包文件复制到可以从安装了 Windows Admin Center 的计算机访问的某个文件共享，或者复制到安装了 Windows Admin Center 的计算机上的本地磁盘。
按说明从另一源安装扩展。

通过 PowerShell 脚本下载包

可以使用 Internet 上提供的许多脚本从 NuGet 源下载 NuGet 包。我们将使用 Microsoft 高级项目经理 Jon Galloway 提供的脚本。

如博客文章中所述，将脚本作为 NuGet 包安装，或者将脚本复制并粘贴到 PowerShell ISE 中。
将脚本的第一行编辑成你的 NuGet 源的 v2 URL。如果要从 Windows Admin Center 官方源下载包，请使用以下 URL：

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

运行脚本，并将源中的所有 NuGet 包下载到以下本地文件夹： %USERPROFILE%\Documents\NuGetLocal
按说明从另一源安装扩展。

使用 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"

注意

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

详细了解如何使用 Windows Admin Center SDK 构建扩展。

通过