Изменение поведения корневой навигации

Статья
11/02/2024
Применяется к:

✅ Windows Admin Center, ✅ Windows Admin Center Preview

В этой статье содержатся инструкции по изменению поведения корневой навигации для решения, который будет отличаться от поведения списка подключений. Вы также узнаете, как скрыть или показать список инструментов.

Откройте файл manifest.json в {extension root}\src и найдите свойство rootNavigationBehavior. Это свойство имеет два допустимых значения: "подключения" или "путь". Поведение "подключения" подробно описано далее в документации.

Задание пути в качестве корневого элементаNavigationBehavior

Задайте значение rootNavigationBehavior path, а затем удалите requirements свойство и оставьте path свойство пустым. Вы выполнили минимальную необходимую конфигурацию для создания расширения решения. Сохраните файл, сборка gulp —> gulp служит как средство, а затем загрузите расширение в локальное расширение Windows Admin Center.

Допустимый массив entryPoints манифеста выглядит следующим образом:

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

Средства, созданные с такой структурой, не требуют подключения для загрузки, но не имеют функциональных возможностей подключения к узлам.

Настройка подключений в качестве корневого элементаNavigationBehavior

При установке rootNavigationBehavior свойства connectionsвы сообщаете оболочке Windows Admin Center, что есть подключенный узел (всегда сервер определенного типа), который он должен подключиться, чтобы проверить состояние подключения. Существует два шага при проверке подключения.

Windows Admin Center пытается войти в узел с помощью учетных данных (для установки удаленного сеанса PowerShell).
Windows Admin Center выполняет скрипт PowerShell, который вы предоставляете, чтобы проверить, находится ли узел в подключенном состоянии.

Допустимое определение решения с подключениями выглядит следующим образом:

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

Если для rootNavigationBehavior задано значение connections, необходимо создать определение подключений в манифесте. Это включает свойство header (отображается в заголовке решения, когда пользователь выбирает его из меню), а также массив connectionTypes (указывает, какие типы подключения используются в решении. Дополнительные сведения см. в документации по connectionProvider.

Другое свойство, доступное в определении решения, — это свойство Tools. Свойство Tools определяет, отображается ли меню "Сервис" и какое средство будет загружено. При включении Windows Admin Center отображает меню инструментов слева. При использовании defaultTool необходимо добавить точку входа средства в манифест, чтобы загрузить соответствующие ресурсы. Значение "defaultTool" должно быть свойством "name" средства, так как оно определено в манифесте.

Поделиться через

Изменение поведения корневой навигации для расширения решения