Modificación del comportamiento de navegación raíz para una extensión de solución

Se aplica a: Windows Admin Center, versión preliminar de Windows Admin Center

En este artículo se proporciona una guía sobre cómo modificar el comportamiento de navegación raíz de la solución para que tenga un comportamiento de la lista de conexiones diferente. También aprenderá a ocultar o mostrar la lista de herramientas.

Modificación del comportamiento de navegación raíz

Abra el archivo manifest.json en {extension root}\src y busque la propiedad "rootNavigationBehavior". Esta propiedad tiene dos valores válidos: "connections" o "path". El comportamiento de "connections" se detalla más adelante en la documentación.

Establecimiento de la ruta de acceso como rootNavigationBehavior

Establezca el valor de rootNavigationBehavior en path y, luego, elimine la propiedad requirements y deje la propiedad path como una cadena vacía. Ha completado la configuración mínima necesaria para crear una extensión de solución. Guarde el archivo, use gulp build -> gulp serve como haría con una herramienta, y luego cargue lateralmente la extensión en la extensión local de Windows Admin Center.

Una matriz de puntos de entrada de manifiesto válida tiene este aspecto:

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

Las herramientas creadas con este tipo de estructura no necesitan conexiones para cargarse, pero tampoco tienen funcionalidad de conectividad de nodo.

Establecimiento de conexiones como rootNavigationBehavior

Al establecer la propiedad rootNavigationBehavior en connections, le indica al shell de Windows Admin Center que hay un nodo conectado (siempre un servidor de algún tipo) al que debe conectarse y comprobar el estado de conexión. Hay dos pasos para comprobar una conexión.

1. Windows Admin Center intenta iniciar sesión en el nodo con las credenciales (para establecer la sesión remota de PowerShell).
2. Windows Admin Center ejecuta el script de PowerShell que proporcione para comprobar si el nodo está en estado conectable.

Una definición de solución válida con conexiones tiene este aspecto:

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

Cuando rootNavigationBehavior esté establecido en "connections", se le pedirá que compile la definición de conexiones en el manifiesto. Esto incluye la propiedad "header" (se muestra en el encabezado de la solución cuando un usuario la seleccione en el menú) y una matriz connectionTypes (especifica qué tipos de conexión se usan en la solución). Encontrará más información en la documentación de connectionProvider.

Habilitación y deshabilitación del menú de herramientas

Otra propiedad disponible en la definición de la solución es la propiedad Tools. La propiedad Tools decide si se muestra el menú Herramientas y qué herramienta se cargará. Cuando se habilita, Windows Admin Center representa el menú Herramientas de la izquierda. Con defaultTool, es necesario agregar un punto de entrada de herramienta al manifiesto para cargar los recursos adecuados. El valor de "defaultTool" debe ser la propiedad "name" de la herramienta como se define en el manifiesto.