Descripción de las extensiones de Windows Admin CenterUnderstanding Windows Admin Center Extensions

Se aplica a: Windows Admin Center, vista previa de Windows Admin CenterApplies To: Windows Admin Center, Windows Admin Center Preview

En caso de que no estés aún familiarizado con el funcionamiento de Windows Admin Center, vamos a comenzar con la arquitectura de alto nivel.In case you’re not yet familiar with how Windows Admin Center works, let’s start with the high-level architecture. Windows Admin Center se compone de dos componentes principales:Windows Admin Center is comprised of two main components:

  • Servicio web ligero que sirve las páginas web de la interfaz de usuario de Windows Admin Center para solicitudes de navegadores web.Lightweight web service that serves Windows Admin Center UI web pages to web browser requests.
  • Componente de puerta de enlace que atiende las solicitudes de API de REST desde las páginas web y retransmite las llamadas WMI o scripts de PowerShell para que se ejecuten en un clúster o servidor de destino.Gateway component that listens for REST API requests from the web pages and relays WMI calls or PowerShell scripts to be executed on a target server or cluster.

Arquitectura de Windows Admin Center

Las páginas web de la interfaz de usuario de Windows Admin Center servidas por el servicio web tienen dos componentes principales de la interfaz de usuario desde una perspectiva de extensibilidad, soluciones y herramientas, que se implementan como extensiones, y un tercer tipo de extensión denominado complementos de puerta de enlace.The Windows Admin Center UI web pages served by the web service has two main UI components from an extensibility perspective, solutions and tools, which are implemented as extensions, and, a third extension type called gateway plugins.

Extensiones de solucionesSolution extensions

En la pantalla principal de Windows Admin Center, de forma predeterminada, puedes agregar conexiones de cuatro tipos: Windows Server, conexiones de PC Windows, conexiones de clúster de conmutación por error y conexiones de clúster hiperconvergido.In the Windows Admin Center home screen, by default, you can add connections that are one of four types – Windows Server connections, Windows PC connections, failover cluster connections and hyper-converged cluster connections. Una vez que se agrega una conexión, el nombre y el tipo de la conexión se mostrarán en la pantalla principal.Once a connection is added, the connection name and type will be displayed in the home screen. Al hacer clic en el nombre de la conexión se intenta conectar con el clúster o el servidor de destino y, a continuación, cargar la interfaz de usuario para la conexión.Clicking on the connection name will attempt to connect to the target server or cluster and then load the UI for the connection.

Arquitectura de Windows Admin Center

Cada uno de estos tipos de conexión se asignan a una solución y las soluciones se definen a través de un tipo de extensión llamado extensiones de "solución".Each of these connection types map to a solution and solutions are defined through a type of extension called “solution” extensions. Normalmente, las soluciones definen un único tipo de objeto que deseas administrar a través de Windows Admin Center, como servidores, PC o clústeres de conmutación por error.Solutions typically define a unique type of object you wish to manage through Windows Admin Center, such as servers, PCs or failover clusters. También podrías definir una nueva solución a la que conectarse y administrar otros dispositivos como conmutadores de red y servidores Linux o incluso servicios como Servicios de Escritorio remoto.You could also define a new solution for connecting to and managing other devices such as network switches and Linux servers, or even services such as Remote Desktop Services.

Extensiones de herramientasTool extensions

Al hacer clic en una conexión en la pantalla principal de Windows Admin Center y conectar, se cargará la extensión de la solución para el tipo de conexión seleccionado y, a continuación, se presenta la interfaz de usuario de la solución con una lista de herramientas en el panel de navegación izquierdo.When you click on a connection in the Windows Admin Center home screen and connect, the solution extension for the selected connection type will be loaded and you will then be presented with the solution UI including a list of tools in the left navigation pane. Al hacer clic en una herramienta, la interfaz de usuario de la herramienta se carga y se muestra en el panel derecho.When you click on a tool, the tool UI is loaded and displayed in the right pane.

Arquitectura de la interfaz de usuario de Windows Admin Center

Cada una de estas herramientas se definen a través de un segundo tipo de extensión denominada extensiones de "herramienta".Each of these tools are defined through a second type of extension called “tool” extensions. Cuando se carga una herramienta, puede ejecutar llamadas WMI o scripts de PowerShell en un clúster o un servidor de destino y mostrar información en la interfaz de usuario o ejecutar comandos en función de la entrada del usuario.When a tool is loaded, it can execute WMI calls or PowerShell scripts on a target server or cluster and display information in the UI or execute commands based on user input. Una extensión de herramienta define para qué soluciones se debe mostrar, resultando en un conjunto diferente de herramientas para cada solución.A tool extension defines which solutions it should be displayed for, resulting in a different set of tools for each solution. Si estás creando una nueva extensión de la solución, tendrás que escribir adicionalmente una o varias extensiones de herramienta que proporcionen funcionalidad para la solución.If you are creating a new solution extension, you'll additionally need to write one or more tool extensions that provide functionality for the solution.

Lista de herramientas para cada solución

Complementos de puerta de enlaceGateway plugins

El servicio de puerta de enlace expone API de REST para la interfaz de usuario para llamar y transmite comandos y scripts que se van a ejecutar en el destino.The gateway service exposes REST APIs for the UI to call and relays commands and scripts to be executed on the target. El servicio de puerta de enlace se puede ampliar mediante complementos de puerta de enlace que admiten protocolos diferentes.The gateway service can be extended by gateway plugins that support different protocols. Windows Admin Center viene preconfigurado con dos complementos de puerta de enlace, uno para ejecutar scripts de PowerShell y otro para los comandos WMI.Windows Admin Center is pre-packaged with two gateway plugins, one for executing PowerShell scripts and the other for WMI commands. Si necesitas comunicarse con el destino a través de un protocolo distinto a PowerShell o WMI, como REST, puedes crear un complemento de puerta de enlace para esto.If you need to communicate with the target through a protocol other than PowerShell or WMI, such as REST, you can build a gateway plugin for this.

Pasos siguientesNext steps

Según las funcionalidades que desees crear en Windows Admin Center, crear una extensión de la herramienta para un clúster o servidor existente puede ser suficiente y es el primer paso más sencillo para crear las extensiones.Depending on what capabilities you want to build in Windows Admin Center, building a tool extension for an existing server or cluster solution may be sufficient, and is the easiest first step into building extensions. Sin embargo, si la característica es para administrar un dispositivo, servicio o algo totalmente nuevo, en lugar de un servidor o clúster, deberías considerar crear una extensión de la solución con una o más herramientas.However, if your feature is for managing a device, service or something completely new, rather than a server or cluster, you should consider building a solution extension with one or more tools. Y, por último, si necesitas comunicar con el destino a través de un protocolo distinto de WMI o PowerShell, tendrás que crear un complemento de puerta de enlace.And finally, if you need to communicate with the target through a protocol other than WMI or PowerShell, you’ll need to build a gateway plugin. Continúa leyendo para aprender a configurar el entorno de desarrollo y comenzar a escribir la primera extensión.Continue reading on to learn how to set up your development environment and start writing your first extension.