Ändern des Stammnavigationsverhaltens

Artikel
04/10/2023

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

Dieser Artikel enthält Anleitungen zum Ändern des Stammnavigationsverhaltens für Ihre Lösung, um ein anderes Verbindungslistenverhalten zu erreichen. Außerdem erfahren Sie, wie Sie die Liste der Tools aus- oder einblenden.

Öffnen Sie die Datei „manifest.json“ in „{extension root}\src“, und suchen Sie die Eigenschaft „rootNavigationBehavior“. Diese Eigenschaft hat zwei gültige Werte: „connections“ oder „path“. Das Verhalten von „connection“ wird weiter unten in der Dokumentation beschrieben.

Festlegen eines Pfads als „rootNavigationBehavior“

Legen Sie den Wert von rootNavigationBehavior auf path fest, löschen Sie dann die requirements-Eigenschaft, und belassen Sie die path-Eigenschaft als leere Zeichenfolge. Sie haben die minimal erforderliche Konfiguration zum Erstellen einer Lösungserweiterung durchgeführt. Speichern Sie die Datei, führen Sie „gulp build -> gulp serve“ wie bei einem Tool aus, und laden Sie die Erweiterung dann per Querladen in Ihre lokale Windows Admin Center-Erweiterung.

Ein gültiges entryPoints-Array im Manifest sieht wie folgt aus:

    "entryPoints": [
        {
          "entryPointType": "solution",
          "name": "main",
          "urlName": "testsln",
          "displayName": "resources:strings:displayName",
          "description": "resources:strings:description",
          "icon": "sme-icon:icon-win-powerShell",
          "path": "",
          "rootNavigationBehavior": "path"
        }
    ],

Für Tools, die mit einer derartigen Struktur erstellt wurden, müssen keine Verbindungen geladen werden. Diese Tools verfügen allerdings über keinerlei Knotenkonnektivitätsfunktionen.

Festlegen von Verbindungen als „rootNavigationBehavior“

Wenn Sie die rootNavigationBehavior-Eigenschaft auf connections festlegen, teilen Sie der Windows Admin Center-Shell mit, dass es einen verbundenen Knoten (immer ein Server eines Typs) gibt, mit dem eine Verbindung hergestellt und dessen Verbindungsstatus überprüft werden soll. Das Überprüfen einer Verbindung umfasst zwei Schritte.

Windows Admin Center versucht, sich mit Ihren Anmeldeinformationen beim Knoten anzumelden (zum Einrichten der PowerShell-Remotesitzung).
Windows Admin Center führen das von Ihnen bereitgestellte PowerShell-Skript aus, um zu überprüfen, ob sich der Knoten in einem verbindungsfähigen Zustand befindet.

Eine gültige Lösungsdefinition mit Verbindungen sieht wie folgt aus:

        {
          "entryPointType": "solution",
          "name": "example",
          "urlName": "solutionexample",
          "displayName": "resources:strings:displayName",
          "description": "resources:strings:description",
          "icon": "sme-icon:icon-win-powerShell",
          "rootNavigationBehavior": "connections",
          "connections": {
            "header": "resources:strings:connectionsListHeader",
            "connectionTypes": [
                "msft.sme.connection-type.example"
                ]
            },
            "tools": {
                "enabled": false,
                "defaultTool": "solution"
            }
        },

Wenn „rootNavigationBehavior“ auf „connections“ festgelegt ist, müssen Sie die Verbindungsdefinition im Manifest erstellen. Dies umfasst die Eigenschaft „header“ (wird für die Anzeige im Lösungsheader verwendet, wenn ein*e Benutzer*in die Lösung im Menü auswählt), und ein connectionTypes-Array. (Dieses Array gibt an, welche Verbindungstypen in der Lösungen verwendet werden. Weitere Informationen hierzu finden Sie in der connectionProvider-Dokumentation.)

Eine weitere in der Lösungsdefinition verfügbare Eigenschaft ist die Eigenschaft „tools“. Die tools-Eigenschaft gibt an, ob das Menü „Tools“ angezeigt wird und welches Tool geladen wird. Wenn diese Option aktiviert ist, rendert Windows Admin Center das Menü für Tools im linken Bereich. Für „defaultTool“ müssen Sie im Manifest einen Tooleinstiegspunkt hinzufügen, um die entsprechenden Ressourcen zu laden. Der Wert von „defaultTool“ muss die Eigenschaft „name“ des Tools sein, die im Manifest definiert ist.

Ändern des Stammnavigationsverhaltens für eine Lösungserweiterung