Install and manage extensions
Windows Admin Center is built as an extensible platform where each connection type and tool is an extension that you can install, uninstall, and update individually. You can search for new extensions published by Microsoft and other developers, and install and update them individually without having to update the entire Windows Admin Center installation. You can also configure a separate NuGet feed or file share and distribute extensions to use internally within your organization.
Installing an extension
Windows Admin Center shows extensions available from the specified NuGet feed. By default, Windows Admin Center points to the Microsoft official NuGet feed which hosts extensions published by Microsoft and other developers.
- Select the Settings button in the top-right > In the left pane, select Extensions.
- The Available Extensions tab lists the extensions on the feed that are available for installation.
- Select on an extension to view the extension description, version, publisher and other information in the Details pane.
- Select Install to install an extension. If the gateway must run in elevated mode to make this change, you're presented with a User Account Control (UAC) elevation prompt. After installation is complete, your browser automatically refreshes and Windows Admin Center reloads with the new extension installed. If the extension you are trying to install is an update to a previously installed extension, you can select the Update to latest button to install the update. You can also go to the Installed Extensions tab to view installed extensions and see if an update is available in the Status column.
Installing extensions from a different feed
Windows Admin Center supports multiple feeds and you can view and manage packages from more than one feed at a time. Any NuGet feed that supports the NuGet V2 APIs or a file share can be added to Windows Admin Center for installing extensions from.
- Select the Settings button in the top-right > In the left pane, select Extensions.
- On the right pane, select the Feeds tab.
- Select the Add button to add another feed. For a NuGet feed, enter the NuGet V2 feed URL. The NuGet feed provider or administrator should be able to provide the URL information. For a file share, enter the full path of the file share in which the extension package files (.nupkg) are stored. If adding a file share as a feed, it must meet the following criteria:
- Access to the file must be granted to NTAuthority\Network Service
- The file path can't include the C:\Users folder
- The packages on the file share must be signed, unless your operation mode is set to "Development"
- Select Add. If the gateway must run in elevated mode to make this change, you're presented with a UAC elevation prompt. This prompt will only be presented if you are running Windows Admin Center in desktop mode.
The Available Extensions list shows extensions from all registered feeds. You can check which feed each extension is from using the Package Feed column.
Uninstalling an extension
You can uninstall any extensions you have previously installed, or even uninstall any tools that were preinstalled as part of the Windows Admin Center installation.
- Select the Settings button in the top-right > In the left pane, select Extensions.
- Select the Installed Extensions tab to view all installed extensions.
- Choose an extension to uninstall, then select Uninstall.
After uninstall is complete, your browser automatically refreshes and Windows Admin Center reloads with the extension removed. If you uninstalled a tool that was preinstalled as part of Windows Admin Center, the tool is available for reinstallation in the Available Extensions tab.
Installing extensions on a computer without internet connectivity
If Windows Admin Center is installed on a computer that isn't connected to the internet or is behind a proxy, it may not be able to access and install the extensions from the Windows Admin Center feed. You can download extension packages manually or with a PowerShell script, and configure Windows Admin Center to retrieve packages from a file share or local drive.
Manually downloading extension packages
On another computer that has internet connectivity, open a web browser and navigate to the following URL: https://dev.azure.com/WindowsAdminCenter/Windows%20Admin%20Center%20Feed/_packaging?_a=feed&feed=WAC
- You may need to create a Microsoft account and sign-in to view the extension packages.
Select on the name of the package you want to install to view the package details page.
Select on the Download link in the top navigation bar of the package details page and download the .nupkg file for the extension.
Repeat steps 2 and 3 for all the packages you want to download.
Copy the package files to a file share that can be accessed from the computer Windows Admin Center is installed on, or to the local disk of the computer on which Windows Admin Center is installed.
Follow the instructions to install extensions from a different feed.
Downloading packages with a PowerShell script
There are many scripts available on the Internet for downloading NuGet packages from a NuGet feed. We'll use the script provided by Jon Galloway, Senior Program Manager at Microsoft.
- As described in the blog post, install the script as a NuGet package, or copy and paste the script into the PowerShell ISE.
- Edit the first line of the script to your NuGet feed's v2 URL. If you are downloading packages from the Windows Admin Center official feed, use the following URL:
$feedUrlBase = "https://aka.ms/sme-extension-feed"
- Run the script and it downloads all the NuGet packages from the feed to the following local folder: %USERPROFILE%\Documents\NuGetLocal
- Follow the instructions to install extensions from a different feed.
Manage extensions with PowerShell
Windows Admin Center Preview includes a PowerShell module to manage your gateway extensions.
# 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
You must be gateway administrator to modify Windows Admin Center extensions with PowerShell.
Learn more about building an extension with the Windows Admin Center SDK.