Desarrollar una extensión de la solución

  • Artículo

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

Las soluciones definen principalmente un tipo único de objeto que desea administrar mediante Windows Admin Center. Estos tipos de solución y de conexión se incluyen con Windows Admin Center de manera predeterminada:

  • Conexiones de Windows Server
  • Conexiones a un PC de Windows
  • Conexiones de un clúster de conmutación por error
  • Conexiones de un clúster hiperconvergido

Al seleccionar una conexión en la página de conexión de Windows Admin Center, se carga la extensión de solución para el tipo de conexión y Windows Admin Center intentará conectarse al nodo de destino. Si la conexión se realiza correctamente, la UI de la extensión de solución se cargará y Windows Admin Center mostrará las herramientas de esa solución en el panel de navegación izquierdo.

Si desea crear una GUI de administración para los servicios que no están definidos por los tipos de conexión predeterminados que aparecen arriba, como un conmutador de red u otro hardware que no se pueda detectar por nombre de equipo, es posible que le interese crear su propia extensión de solución.

Nota

¿No está familiarizado con los diferentes tipos de extensión? Obtenga más información sobre la arquitectura de extensibilidad y los tipos de extensión.

Preparación del entorno

Si aún no lo ha hecho, prepare el entorno mediante la instalación de dependencias y requisitos previos globales necesarios para todos los proyectos.

Creación de una nueva extensión de solución con el SDK de Windows Admin Center

Una vez instaladas todas las dependencias, estará listo para crear la nueva extensión de solución. Cree o vaya a una carpeta que contenga los archivos del proyecto, abra un símbolo del sistema y establezca esa carpeta como directorio de trabajo. Utilice el SDK de Windows Admin Center que se instaló anteriormente para crear una extensión con esta sintaxis:

wac create --company "{!Company Name}" --solution "{!Solution Name}" --tool "{!Tool Name}" --version latest
Value Explicación Ejemplo
{!Company Name} Nombre de la empresa (con espacios) Contoso Inc
{!Solution Name} El nombre de la solución (con espacios) Contoso Foo Works Suite
{!Tool Name} Nombre de la herramienta (con espacios) Manage Foo Works

Observa el siguiente ejemplo de uso:

wac create --company "Contoso Inc" --solution "Contoso Foo Works Suite" --tool "Manage Foo Works"

Esto crea una carpeta nueva dentro del directorio de trabajo actual con el nombre especificado para la herramienta, copia todos los archivos de plantilla necesarios en el proyecto y configura los archivos con su empresa, la solución y el nombre de la herramienta.

Nota

La marca --version de este comando especifica la versión del SDK de Windows Admin Center de destino. Obtenga información sobre cómo tener como destino una versión diferente del SDK de Windows Admin Center para mantener actualizada la extensión con los cambios más recientes en el SDK y la plataforma.

Ahora, cambie el directorio a la carpeta que acaba de crear y, después, instale las dependencias locales necesarias mediante la ejecución del comando siguiente:

npm install

Una vez que se complete, configurará todo lo que necesita para cargar la nueva extensión en Windows Admin Center.

Adición de contenido a la extensión

Ahora que ha creado una extensión con el SDK de Windows Admin Center, ya puede personalizar el contenido. Consulte estas guías para obtener ejemplos de lo que puede hacer:

Puede encontrar aún más ejemplos en nuestra Guía para desarrolladores. La Guía para desarrolladores es una extensión de una solución totalmente funcional que se puede cargar lateralmente en Windows Admin Center y contiene una amplia colección de ejemplos de funcionalidades y herramientas que puede examinar y usar en su propia extensión.

Habilite la extensión Guía para desarrolladores en la página Avanzado de la configuración de Windows Admin Center.

Compilación y carga lateral de la extensión

Ahora, compile y cargue la extensión en Windows Admin Center. Abra una ventana de comandos, cambie el directorio al directorio de origen y, después, estará listo para compilar.

  • Compilación y servicio con gulp:

    gulp build
gulp serve --port 4201

Tenga en cuenta que debe elegir un puerto que actualmente sea gratuito. Asegúrese de no intentar usar el puerto en el que se ejecuta Windows Admin Center.

El proyecto se puede cargar lateralmente en una instancia local de Windows Admin Center para realizar pruebas. Para ello, adjunte el proyecto que se sirve localmente en Windows Admin Center.

  • Inicie Windows Admin Center en un explorador web

  • Abra el depurador (F12)

  • Abra la consola y escriba el comando siguiente:

    MsftSme.sideLoad("http://localhost:4201")

  • Actualice el explorador web

Ahora, el proyecto estará visible en la lista Herramientas con (side loaded [carga lateral]) junto al nombre.