Desarrollar una extensión de herramienta

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

Una extensión de herramienta es la forma principal de que los usuarios interactúen con Windows Admin Center para administrar una conexión, como un servidor o clúster. Al hacer clic en una conexión en la pantalla principal de Windows Admin Center y conectarse, se le mostrará una lista de herramientas en el panel de navegación izquierdo. Al hacer clic en una herramienta, la extensión de la herramienta se carga y se muestra en el panel derecho.

Cuando se carga una extensión de herramienta, puede ejecutar llamadas WMI o scripts de PowerShell en un servidor o clúster de destino y mostrar información en la interfaz de usuario o ejecutar comandos en función de la entrada del usuario. Las extensiones de herramientas definen para qué soluciones se deben mostrar, lo que da lugar a un conjunto diferente de herramientas para cada solución.

Nota

¿No está familiarizado con los distintos 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 instalando las dependencias y los requisitos previos globales necesarios para todos los proyectos.

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

Una vez que haya instalado todas las dependencias, estará listo para crear la nueva extensión de herramienta. Cree o busque una carpeta que contenga los archivos del proyecto, abra un símbolo del sistema y establezca esa carpeta como directorio de trabajo. Con el SDK Windows Admin Center que se instaló anteriormente, cree una nueva extensión con la sintaxis siguiente:

wac create --company "{!Company Name}" --tool "{!Tool Name}"
Value Explicación Ejemplo
{!Company Name} Nombre de la empresa (con espacios) Contoso Inc
{!Tool Name} Nombre de la herramienta (con espacios) Manage Foo Works

Observa el siguiente ejemplo de uso:

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

Esto crea una nueva carpeta 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 el nombre de la empresa y la herramienta.

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

npm install

Una vez completado esto, ha configurado todo lo que necesita para cargar la nueva extensión en Windows Admin Center.

Agregar contenido a la extensión

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

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

Habilite la extensión Guía para desarrolladores en la página Avanzadas de la Windows configuración del Centro de administración.

Personalizar el icono de la extensión

Puede personalizar el icono que se muestra para la extensión en la lista de herramientas. Para ello, modifique todas las icon entradas de manifest.json para la extensión:

"icon": "{!icon-uri}",
Value Explicación URI de ejemplo
{!icon-uri} La ubicación del recurso de icono assets/foo-icon.svg

NOTA: Actualmente, los iconos personalizados no son visibles al cargar localmente la extensión en modo de desarrollo. Como solución alternativa, quite el contenido de como target se muestra a continuación:

"target": "",

Esta configuración solo es válida para la carga en paralelo en modo de desarrollo, target por lo que es importante conservar el valor contenido en y, a continuación, restaurarlo antes de publicar la extensión.

Compilación y carga lateral de la extensión

A continuación, compile y cargue la extensión en Windows Admin Center. Abra una ventana de comandos, cambie el directorio al directorio de origen y, a continuación, 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 esté disponible actualmente. Asegúrese de no intentar usar el puerto en el que se Windows Centro de administración.

El proyecto se puede cargar localmente en una instancia local de Windows Admin Center para realizar pruebas adjuntando el proyecto que se sirve localmente en Windows Admin Center.

  • Inicio Windows Admin Center en un explorador web

  • Abrir el depurador (F12)

  • Abra la consola y escriba el siguiente comando:

    MsftSme.sideLoad("http://localhost:4201")
    
  • Actualización del explorador web

El proyecto ahora estará visible en la lista herramientas con (side loaded) junto al nombre.

Destino de una versión diferente del SDK Windows Admin Center

Mantener la extensión actualizada con los cambios del SDK y los cambios en la plataforma es fácil. Obtenga información sobre cómo tener como destino una versión diferente del SDK Windows Admin Center.