安裝和管理擴充功能

發行項
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 一部分的工具，此工具可在 [可用的擴充功能] 索引卷標中重新安裝。

在沒有網際網路連線的電腦上安裝擴充功能

如果 Windows Admin Center 安裝在未連線到網際網路或位於 Proxy 後方的電腦上，則可能無法從 Windows Admin Center 摘要存取並安裝擴充功能。您可以透過手動方式或使用 PowerShell 指令碼下載擴充套件，並將 Windows Admin Center 設定為從檔案共用或本機磁碟機擷取套件。

手動下載擴充套件

在另一台有網路連線的電腦上，打開網路瀏覽器並瀏覽至下列 URL：https://dev.azure.com/WindowsAdminCenter/Windows%20Admin%20Center%20Feed/_packaging?_a=feed&；訊息摘要=WAC
- 您可能需要建立Microsoft帳戶和登入，才能檢視擴充功能套件。
選取您要安裝的套件名稱，以檢視套件詳細數據頁面。
選取套件詳細數據頁面頂端導覽列中的 [ 下載 ] 鏈接，然後下載擴展名的 .nupkg 檔案。
針對您想要下載的所有套件，重複步驟 2 和 3。
將套件檔案複製到檔案共用 (可從安裝 Windows Admin Center 的電腦進行存取)，或複製到 Windows Admin Center 安裝所在電腦的本機磁碟。
請遵循指示，從不同的摘要中安裝擴充功能。

使用 PowerShell 指令碼下載套件

網際網路上有許多可用來從 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 建置擴充功能。

共用方式為