Desarrollar una extensión de herramienta

  • Artículo

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

Una extensión de una herramienta es la forma principal de interacción por parte de los usuarios con Windows Admin Center para administrar una conexión, como un servidor o un 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 cualquiera de ellas, se carga la interfaz de usuario de la herramienta y se muestra en el panel derecho.

Cuando se carga una extensión de una 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 las soluciones para las que se deben mostrar, lo que da lugar a un conjunto de herramientas diferente para cada 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 extensión de una herramienta con el SDK de Windows Admin Center

Una vez que todas las dependencias estén instaladas, estará listo para crear la extensión de la herramienta. Cree una carpeta que contenga los archivos del proyecto, o vaya a ella, 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}" --tool "{!Tool Name}" --version latest
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" --version latest

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 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 Opciones avanzadas de la configuración de Windows Admin Center.

Personalización del 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 entradas de icon en el archivo manifest.json para la extensión:

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

NOTA: Actualmente, los iconos personalizados no se pueden ver al cargar lateralmente la extensión en modo de desarrollo. Como solución alternativa, quite el contenido de target como se indica a continuación:

"target": "",

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

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.