Entwickeln einer Lösungserweiterung

  • Artikel

Gilt für: Windows Admin Center, Windows Admin Center-Vorschau

Lösungen definieren in erster Linie einen eindeutigen Objekttyp, den Sie über Windows Admin Center verwalten möchten. Die folgenden Lösungen/Verbindungstypen sind standardmäßig in Windows Admin Center enthalten:

  • Windows Server-Verbindungen
  • Windows-PC-Verbindungen
  • Failoverclusterverbindungen
  • Hyperkonvergente Clusterverbindungen

Wenn Sie auf der Windows Admin Center-Verbindungsseite eine Verbindung auswählen, wird die Lösungserweiterung für diesen Verbindungstyp geladen, und Windows Admin Center versucht, eine Verbindung mit dem Zielknoten herzustellen. Kann die Verbindung erfolgreich hergestellt werden, wird die Benutzeroberfläche der Lösungserweiterung geladen, und Windows Admin Center zeigt die Tools für diese Lösung im Navigationsbereich auf der linken Seite an.

Wenn Sie eine GUI für die Verwaltung von Diensten erstellen möchten, die nicht durch die oben genannten Standardverbindungstypen definiert sind, wie etwa einen Netzwerkswitch oder eine andere Hardware, die nicht nach dem Computernamen erkannt werden kann, können Sie eine eigene Lösungserweiterung erstellen.

Hinweis

Sie sind mit den verschiedenen Erweiterungstypen noch nicht vertraut? Weitere Informationen zur Erweiterbarkeitsarchitektur und den Erweiterungstypen finden Sie hier.

Vorbereiten der Umgebung

Falls Sie dies noch nicht getan haben, bereiten Sie Ihre Umgebung vor. Installieren Sie hierzu Abhängigkeiten und globale Voraussetzungen, die für alle Projekte erforderlich sind.

Erstellen einer neuen Lösungserweiterung mit dem Windows Admin Center SDK

Sobald Sie alle Abhängigkeiten installiert haben, können Sie Ihre neue Lösungserweiterung erstellen. Erstellen Sie einen Ordner, der Ihre Projektdateien enthält, oder navigieren Sie dorthin. Öffnen Sie eine Eingabeaufforderung, und legen Sie diesen Ordner als Arbeitsverzeichnis fest. Erstellen Sie mithilfe des zuvor installierten Windows Admin Center SDK eine neue Erweiterung mit der folgenden Syntax:

wac create --company "{!Company Name}" --solution "{!Solution Name}" --tool "{!Tool Name}" --version latest
Wert Erklärung Beispiel
{!Company Name} Name Ihres Unternehmens (mit Leerzeichen) Contoso Inc
{!Solution Name} Name Ihrer Lösung (mit Leerzeichen) Contoso Foo Works Suite
{!Tool Name} Name Ihres Tools (mit Leerzeichen) Manage Foo Works

Beispiel zur Verwendung:

wac create --company "Contoso Inc" --solution "Contoso Foo Works Suite" --tool "Manage Foo Works"

Dadurch wird ein neuer Ordner im aktuellen Arbeitsverzeichnis mit dem Namen erstellt, den Sie für Ihre Lösung angegeben haben. Zudem werden alle erforderlichen Vorlagendateien in Ihr Projekt kopiert und die Dateien mit dem Namen Ihres Unternehmens, Ihrer Lösung und Ihres Tools konfiguriert.

Hinweis

Das Flag „--version“ in diesem Befehl gibt an, welche Version des Windows Admin Center SDK Sie als Ziel verwenden möchten. Lesen Sie, wie Sie eine andere Version des Windows Admin Center SDK als Ziel verwenden, um Ihre Erweiterung mit den neuesten SDK- und Plattformänderungen auf dem neuesten Stand zu halten.

Wechseln Sie als Nächstes in den soeben erstellten Ordner. Führen Sie den folgenden Befehl aus, um die erforderlichen lokalen Abhängigkeiten zu installieren:

npm install

Sie haben nun alle Einrichtungsschritte abgeschlossen, um Ihre neue Erweiterung in Windows Admin Center zu laden.

Hinzufügen von Inhalten zur Erweiterung

Nachdem Sie eine Erweiterung mit dem Windows Admin Center SDK erstellt haben, können Sie nun deren Inhalt anpassen. Beispiele für mögliche Aktionen finden Sie unter:

Weitere Beispiele finden Sie im Entwicklerhandbuch. Das Entwicklerhandbuch ist eine voll funktionsfähige Lösungserweiterung, die in Windows Admin Center quergeladen werden kann. Es enthält eine umfangreiche Sammlung von Beispielfunktionen und -tools, die Sie durchsuchen und in Ihrer eigenen Erweiterung verwenden können.

Aktivieren Sie auf der Seite Erweitert Ihrer Windows Admin Center-Einstellungen die Erweiterung für das Entwicklerhandbuch.

Erstellen und Querladen der Erweiterung

Erstellen Sie als Nächstes die Erweiterung, und laden Sie sie in Windows Admin Center. Öffnen Sie ein Befehlsfenster, und wechseln Sie in Ihr Quellverzeichnis, um die Erweiterung zu erstellen.

  • Führen Sie die Erstellung und Bereitstellung mit gulp aus:

    gulp build
gulp serve --port 4201

Beachten Sie, dass der ausgewählte Port frei sein muss. Stellen Sie sicher, dass Sie nicht den Port verwenden, auf dem Windows Admin Center ausgeführt wird.

Sie können Ihr Projekt zu Testzwecken in eine lokale Windows Admin Center-Instanz querladen, indem Sie das lokal bereitgestellte Projekt an Windows Admin Center anhängen.

  • Starten Sie Windows Admin Center in einem Webbrowser.

  • Öffnen Sie den Debugger (F12).

  • Öffnen Sie die Konsole, und geben Sie den folgenden Befehl ein:

    MsftSme.sideLoad("http://localhost:4201")

  • Aktualisieren Sie den Webbrowser.

Ihr Projekt wird nun in der Liste der verfügbaren Tools mit dem Zusatz „(quergeladen)“ neben dem Namen angezeigt.