Modyfikowanie zachowania nawigacji głównej dla rozszerzenia rozwiązania

Ten artykuł zawiera wskazówki dotyczące modyfikowania zachowania nawigacji głównej dla rozwiązania w celu zachowania innej listy połączeń. Dowiesz się również, jak ukryć lub pokazać listę narzędzi.

Modyfikowanie zachowania nawigacji głównej

Otwórz plik manifest.json w folderze {extension root}\src i znajdź właściwość "rootNavigationBehavior". Ta właściwość ma dwie prawidłowe wartości: "connections" lub "path". Zachowanie "połączeń" zostało szczegółowo opisane w dalszej części dokumentacji.

Ustawianie ścieżki jako rootNavigationBehavior

Ustaw wartość rootNavigationBehavior na wartość path, a następnie usuń właściwość requirements i pozostaw właściwość path jako pusty ciąg. Ukończono minimalną wymaganą konfigurację do utworzenia rozszerzenia rozwiązania. Zapisz plik, kompilacja gulp —> gulp służy jako narzędzie, a następnie ładowania rozszerzenia do lokalnego rozszerzenia Windows Admin Center.

Prawidłowa tablica entryPoints manifestu wygląda następująco:

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

Narzędzia utworzone z tego rodzaju strukturą nie wymagają połączeń do ładowania, ale nie mają też funkcji łączności węzłów.

Ustawianie połączeń jako rootNavigationBehavior

Po ustawieniu właściwości rootNavigationBehavior na connectionsinformujesz powłokę Centrum administracyjnego systemu Windows, że istnieje połączony węzeł (zawsze serwer typu), z którym powinien się połączyć, aby zweryfikować stan połączenia. Podczas weryfikowania połączenia są wykonywane dwa kroki.

1. Windows Admin Center próbuje zalogować się do węzła przy użyciu twoich poświadczeń (w celu ustanowienia zdalnej sesji PowerShell).
2. Centrum administracyjne systemu Windows wykonuje skrypt programu PowerShell, który należy podać, aby sprawdzić, czy węzeł jest w stanie umożliwiającym połączenie.

Prawidłowa definicja rozwiązania z połączeniami wygląda następująco:

        {
          "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"
            }
        },

Gdy właściwość rootNavigationBehavior jest ustawiona na "połączenia", musisz utworzyć definicję połączeń w manifeście. Obejmuje to właściwość "header" (wyświetlaną w nagłówku rozwiązania, gdy użytkownik wybierze ją z menu) oraz tablicę connectionTypes (określa, które typy połączeń są używane w rozwiązaniu). Więcej informacji na ten temat znajduje się w dokumentacji connectionProvider.

Włączanie i wyłączanie menu narzędzi

Inną właściwością dostępną w definicji rozwiązania jest właściwość Tools. Właściwość Narzędzia decyduje, czy jest wyświetlane menu Narzędzia, i które narzędzie zostanie załadowane. Po włączeniu program Windows Admin Center renderuje menu Narzędzia po lewej stronie. W przypadku narzędzia defaultTool wymagane jest dodanie punktu wejścia narzędzia do manifestu w celu załadowania odpowiednich zasobów. Wartość "defaultTool" musi być właściwością "name" narzędzia, ponieważ jest ona zdefiniowana w manifeście.