修改根导航行为

项目
11/02/2024
适用于:

✅ Windows Admin Center, ✅ Windows Admin Center Preview

本文指导你修改解决方案的根导航行为，使其具有不同的连接列表行为。你还将了解如何隐藏或显示工具列表。

打开 {扩展根目录}\src 中的 manifest.json 文件，然后找到“rootNavigationBehavior”属性。此属性有两个有效值：“connections”或“path”。本文档稍后将详细介绍“connections”值的行为。

将路径设置为 rootNavigationBehavior

将 rootNavigationBehavior 的值设置为 path，然后删除 requirements 属性，并将 path 属性保留为空字符串。你已经完成了生成解决方案扩展所需的最低配置。保存文件，像使用工具一样执行 gulp build -> gulp serve，然后将扩展侧载到本地 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"
        }
    ],

使用这种结构构建的工具不需要连接便可加载，但也不具有节点连接功能。

将 connections 设置为 rootNavigationBehavior

将 rootNavigationBehavior 属性设置为 connections 时，你告诉 Windows Admin Center Shell，它将连接到一个已连接的节点（始终是某种类型的服务器），以验证连接状态。验证连接需要执行两个步骤。

Windows Admin Center 会尝试使用你的凭据登录到节点（用于建立远程 PowerShell 会话）。
Windows Admin Center 会执行你提供的 PowerShell 脚本，以验证节点是否处于可连接状态。

具有 connections 的有效解决方案定义如下所示：

        {
          "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 数组（指定在解决方案中使用哪些 ConnectionTypes）。在 connectionProvider 文档中有更多相关信息。

解决方案定义中可用的另一个属性是“Tools”属性。 “Tools”属性决定是否显示“工具”菜单，以及将加载哪个工具。启用后，Windows Admin Center 会呈现左侧的“工具”菜单。使用 defaultTool 时，你需要将工具入口点添加到清单才能加载相应的资源。 “defaultTool”的值必须是清单中定义的工具的“name”属性。

通过

修改解决方案扩展的根导航行为