Installieren und Verwalten von Erweiterungen
Windows Admin Center wird als erweiterbare Plattform erstellt, auf der jeder Verbindungstyp und jedes Tool eine Erweiterung ist, die Sie einzeln installieren, deinstallieren und aktualisieren können. Du kannst nach neuen, von Microsoft und anderen Entwicklern veröffentlichten Erweiterungen suchen und diese einzeln installieren und aktualisieren, ohne die gesamte Windows Admin Centers-Installation aktualisieren zu müssen. Du kannst außerdem einen separaten NuGet-Feed oder eine gesonderte Dateifreigabe konfigurieren und Erweiterungen zur internen Verwendung innerhalb deiner Organisation verteilen.
Installieren einer Erweiterung
Windows Admin Center zeigt Erweiterungen an, die über den angegebenen NuGet-Feed verfügbar sind. Das Windows Admin Center verweist standardmäßig auf den offiziellen NuGet-Feed von Microsoft, der von Microsoft und anderen Entwicklern veröffentlichte Erweiterungen hostet.
- Wählen Sie oben rechts im linken Bereich die Schaltfläche "Einstellungen" aus, und wählen Sie "Erweiterungen" aus.>
- Auf der Registerkarte "Verfügbare Erweiterungen " werden die Erweiterungen im Feed aufgeführt, die für die Installation verfügbar sind.
- Wählen Sie eine Erweiterung aus, um die Erweiterungsbeschreibung, Version, Herausgeber und andere Informationen im Detailbereich anzuzeigen.
- Wählen Sie "Installieren" aus, um eine Erweiterung zu installieren. Wenn das Gateway im Modus mit erhöhten Rechten ausgeführt werden muss, um diese Änderung vorzunehmen, wird ihnen eine Eingabeaufforderung zur Erhöhung der Benutzerkontensteuerung (User Account Control, UAC) angezeigt. Nach Abschluss der Installation wird Ihr Browser automatisch aktualisiert, und Windows Admin Center wird neu geladen, wobei die neue Erweiterung installiert ist. Wenn es sich bei der Erweiterung, die Sie installieren möchten, um ein Update für eine zuvor installierte Erweiterung handelt, können Sie die Schaltfläche "Aktualisieren auf neueste Updates" auswählen, um das Update zu installieren. Du kannst auch zur Registerkarte Installierte Erweiterungen wechseln, um installierte Erweiterungen anzuzeigen und in der Spalte Status zu überprüfen, ob ein Update verfügbar ist.
Installieren von Erweiterungen aus einem anderen Feed
Das Windows Admin Center unterstützt mehrere Feeds, und du kannst Pakete aus mehr als einem Feed gleichzeitig anzeigen und verwalten. Jeder NuGet-Feed, der die NuGet V2-APIs unterstützt, oder eine Dateifreigabe, kann dem Windows Admin Center hinzugefügt werden, um daraus Erweiterungen zu installieren.
- Wählen Sie oben rechts im linken Bereich die Schaltfläche "Einstellungen" aus, und wählen Sie "Erweiterungen" aus.>
- Wählen Sie im rechten Bereich die Registerkarte "Feeds " aus.
- Wählen Sie die Schaltfläche "Hinzufügen " aus, um einen anderen Feed hinzuzufügen. Gib für einen NuGet-Feed die URL des NuGet V2-Feeds ein. Der NuGet-Feedanbieter oder -administrator sollte dir die URL-Informationen bereitstellen können. Gib für eine Dateifreigabe den vollständigen Pfad der Dateifreigabe ein, auf der die Erweiterungspaketdateien (NUPKG) gespeichert sind. Wenn Sie eine Dateifreigabe als Feed hinzufügen, muss sie die folgenden Kriterien erfüllen:
- Zugriff auf die Datei muss NTAuthority\Network Service gewährt werden.
- Der Dateipfad kann den Ordner "C:\Users" nicht enthalten.
- Die Pakete auf der Dateifreigabe müssen signiert werden, es sei denn , der Vorgangsmodus ist auf "Entwicklung" festgelegt.
- Wählen Sie Hinzufügen. Wenn das Gateway im Modus mit erhöhten Rechten ausgeführt werden muss, um diese Änderung vorzunehmen, wird ihnen eine UAC-Eingabeaufforderung zur Erhöhung angezeigt. Diese Aufforderung wird nur angezeigt, wenn Sie das Windows Admin Center im Desktopmodus ausführen.
In der Liste "Verfügbare Erweiterungen " werden Erweiterungen aus allen registrierten Feeds angezeigt. Du kannst anhand der Spalte Paketfeed überprüfen, aus welchem Feed die jeweilige Erweiterung stammt.
Deinstallieren einer Erweiterung
Sie können alle Erweiterungen deinstallieren, die Sie zuvor installiert haben, oder sogar alle Tools deinstallieren, die als Teil der Windows Admin Center-Installation vorinstalliert wurden.
- Wählen Sie oben rechts im linken Bereich die Schaltfläche "Einstellungen" aus, und wählen Sie "Erweiterungen" aus.>
- Wählen Sie die Registerkarte "Installierte Erweiterungen " aus, um alle installierten Erweiterungen anzuzeigen.
- Wählen Sie eine zu deinstallierende Erweiterung und dann "Deinstallieren" aus.
Nachdem die Deinstallation abgeschlossen ist, wird Ihr Browser automatisch aktualisiert, und Windows Admin Center wird neu geladen, wobei die Erweiterung entfernt wurde. Wenn Sie ein Tool deinstalliert haben, das als Teil von Windows Admin Center vorinstalliert wurde, steht das Tool zur Neuinstallation auf der Registerkarte "Verfügbare Erweiterungen " zur Verfügung.
Installieren von Erweiterungen auf einem Computer ohne Internetverbindung
Wenn das Windows Admin Center auf einem Computer installiert ist, der nicht mit dem Internet verbunden ist oder sich hinter einem Proxy befindet, kann es möglicherweise nicht auf die Erweiterungen aus dem Windows Admin Center-Feed zugreifen und diese installieren. Du kannst Erweiterungspakete manuell oder mit einem PowerShell-Skript herunterladen und Windows Admin Center so konfigurieren, dass es Pakete von einer Dateifreigabe oder einem lokalen Laufwerk abruft.
Manuelles Herunterladen von Erweiterungspaketen
Öffnen Sie auf einem anderen Computer mit Internetverbindung einen Webbrowser, und navigieren Sie zu folgender URL: https://dev.azure.com/WindowsAdminCenter/Windows%20Admin%20Center%20Feed/_packaging?_a=feed&feed=WAC
- Möglicherweise müssen Sie ein Microsoft-Konto erstellen und sich anmelden, um die Erweiterungspakete anzuzeigen.
Wählen Sie den Namen des Pakets aus, das Sie installieren möchten, um die Seite mit den Paketdetails anzuzeigen.
Wählen Sie in der oberen Navigationsleiste der Paketdetailseite den Downloadlink aus, und laden Sie die nupkg-Datei für die Erweiterung herunter.
Wiederhole die Schritte 2 und 3 für alle Pakete, die du herunterladen möchtest.
Kopiere die Paketdateien auf eine Dateifreigabe, auf die von dem Computer aus, auf dem Windows Admin Center installiert ist, zugegriffen werden kann, oder auf den lokalen Datenträger des Computers, auf dem Windows Admin Center installiert ist.
Befolge die Anweisungen zum Installieren von Erweiterungen aus einem anderen Feed.
Herunterladen von Paketen mit einem PowerShell-Skript
Es sind viele Skripts im Internet verfügbar, um NuGet-Pakete aus einem NuGet-Feed herunterzuladen. Wir verwenden das Skript, das von Jon Galloway, Senior Program Manager bei Microsoft, bereitgestellt wird.
- Wie im Blogbeitrag beschrieben, installiere das Skript als NuGet-Paket, oder kopiere das Skript, und füge es in die PowerShell ISE ein.
- Ändere die erste Zeile des Skripts in die v2-URL deines NuGet-Feeds. Wenn Sie Pakete aus dem offiziellen Feed von Windows Admin Center herunterladen, verwenden Sie die folgende URL:
$feedUrlBase = "https://aka.ms/sme-extension-feed"
- Führen Sie das Skript aus, und laden Sie alle NuGet-Pakete aus dem Feed in den folgenden lokalen Ordner herunter: %USERPROFILE%\Documents\NuGetLocal
- Befolge die Anweisungen zum Installieren von Erweiterungen aus einem anderen Feed.
Verwalten von Erweiterungen mit PowerShell
Windows Admin Center Preview umfasst ein PowerShell-Modul zum Verwalten deiner Gatewayerweiterungen.
# 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"
Hinweis
Du musst Gatewayadministrator sein, um Windows Admin Center-Erweiterungen mit PowerShell zu ändern.
Weitere Informationen zum Erstellen einer Erweiterung mit dem Windows Admin Center SDK.