Acerca de los formularios de consola de Configuration Manager

Puede ampliar la consola de Configuration Manager con los nuevos formularios Windows Forms. En concreto, puede agregar cuadros de diálogo basados en formularios y hojas de propiedades. Un usuario accede a estos formularios desde Configuration Manager acciones que defina.

Nota:

Los asistentes son otro formulario de Windows que usa la consola de Configuration Manager, pero no puede ampliar ni agregar asistentes mediante el marco de la consola de Configuration Manager. Sin embargo, puede ejecutar su propia solución del asistente mediante acciones de Configuration Manager.

En Configuration Manager, los formularios se almacenan en ensamblados de .NET Framework a los que llama la consola de Configuration Manager después de seleccionar la acción adecuada.

Crear un formulario de extensión

Para redactar un formulario de extensión, haga lo siguiente:

  • Cree el ensamblado del formulario de extensión.

  • Crea el XML de la acción del formulario de extensión.

  • Cree el XML del formulario de extensión.

Crear el ensamblado del formulario de extensión

Hojas de propiedades

Una hoja de propiedades se compone de una o varias páginas de propiedades que se definen. También puede integrar páginas de propiedades en hojas de propiedades de Configuration Manager existentes.

Para crear una hoja de propiedades, cree un proyecto de biblioteca de controles de Windows en Visual Studio. En este proyecto, creará una clase que heredará de la clase Microsoft.ConfigurationManagement.AdminConsole.SmsPageControl . Esta clase implementa el control que desea mostrar en una página de propiedades. En una hoja de propiedades, crea una clase SmsPageControl para cada página de propiedades que necesite. El ejemplo de prototipo de hoja de propiedades del SDK de Configuration Manager tiene una solución completa que puede usar. Para obtener más información, consulta Cómo crear una hoja de propiedades de Configuration Manager.

Cuadros de diálogo

Un cuadro de diálogo en Configuration Manager se muestra como un cuadro de diálogo no modal típico. Crea un SMSPageControl y especifica "Dialog" en el formato XML. Para obtener más información, consulta Cómo crear un cuadro de diálogo de Configuration Manager.

Crear el XML de acción de formulario

Una acción describe el tipo de extensión que se llama y dónde se coloca la acción en la interfaz de usuario de la consola de Configuration Manager. En un formulario de extensión, use el tipo de ShowDialog acción para mostrar el formulario. Para obtener más información, consulta Cómo crear XML de acción para una hoja de propiedades de Configuration Manager.

Para obtener más información acerca de las acciones, consulta Acerca de las acciones de la consola de Configuration Manager.

Crear el XML de la hoja de propiedades del formulario

Independientemente de si el formulario es una hoja de propiedades, el formulario tiene un archivo XML de formulario que define el ensamblado, el espacio de nombres y el tipo del formulario. En las hojas de propiedades, define el orden de las páginas de propiedades en la hoja de propiedades. Hay un archivo XML de hoja de propiedades para cada formulario de consola de Configuration Manager.

Nota:

Los archivos XML de la hoja de propiedades de la consola de Configuration Manager se almacenan en %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Forms.

Al crear un formulario, crea un archivo XML de hoja de propiedades. Si va a agregar una nueva página de propiedades a una hoja de propiedades existente, combine el XML de la página de propiedades con un archivo XML de hoja de propiedades existente.

Nota:

Las hojas de propiedades de extensión se almacenan en %ProgramFiles%\Microsoft Endpoint Manager\AdminConsole\XmlStorage\Extensions\Forms.

Para obtener más información acerca de la implementación XML de formulario, consulta Implementación de la extensión de consola de Configuration Manager.

En función de si está mostrando un cuadro de diálogo o una hoja de propiedades, se deben establecer los valores del atributo FormType.

FormType Descripción
Hoja de propiedades El formulario es una hoja de propiedades.
Cuadro de diálogo El formulario es un cuadro de diálogo.

Cuando se selecciona una acción, la consola de Configuration Manager usa el XML de la hoja de propiedades para determinar qué ensamblado es necesario para cargar y mostrar el formulario.

Para obtener más información, consulte Cómo crear XML de formulario para una hoja de propiedades de Configuration Manager.

Administrar datos de objetos en un formulario

A un formulario de Configuration Manager se le pueden pasar datos personalizados y también, desde el panel de resultados, los objetos devueltos de una consulta. Los objetos seleccionados del panel de resultados se ponen a disposición de un formulario a través de un objeto PropertyManager . Para obtener más información, consulta Cómo utilizar objetos pasados a un formulario de Configuration Manager. Puede enlazar un control de formulario a los objetos que se pasan al archivo PropertyManager. Para obtener más información, vea Cómo enlazar datos de Configuration Manager a un formulario.

La consola de Configuration Manager serializa los objetos de Configuration Manager pasados a un formulario cuando éste se descarta.

Consultas

Puede realizar consultas tanto sincrónicas como asincrónicas en formularios mediante el proveedor de SMS administrado. Obtendrá el objeto Microsoft.ConfigurationManagement.AdminConsole.SmsPageControl.QueryProcessor del ConnectionManager del PropertyManager formulario. Una vez obtenido, el código es idéntico a los ejemplos del proveedor de SMS. Para obtener un ejemplo de una consulta sincrónica, vea Cómo realizar una consulta sincrónica de Configuration Manager mediante código administrado.

Para obtener un ejemplo de una consulta asincrónica, vea Cómo realizar una consulta asincrónica de Configuration Manager mediante código administrado.

Consulta también

Cómo agregar una página de propiedades a una hoja de propiedades existente de Configuration ManagerCómo enlazar datos de Configuration Manager a un formularioCómo crear una hoja de propiedades de Configuration ManagerCómo crear XML de acción para un Configuration Manager cuadro de diálogoCómo crear XML de acción para una hoja de propiedades de Configuration ManagerCómo crear un cuadro de diálogo de Configuration ManagerCómo crear XML de formulario para un cuadro de diálogo de Configuration ManagerCómo crear XML de formulario para Hoja de propiedades de Configuration ManagerCómo utilizar objetos pasados a un formulario de Configuration Manager