Agregar entradas a CONFIGURAR, COMPLEMENTOS, ESTADO RÁPIDO Y VÍNCULOS DE AYUDA

Artículo
10/05/2023

Se aplica a: Windows Server 2016 Essentials, Windows Server 2012 R2 Essentials y Windows Server 2012 Essentials

Puede agregar tareas a las listas de tareas CONFIGURAR, COMPLEMENTOSo ESTADO RÁPIDO, y puede agregar vínculos a la sección Vínculos de la comunidad en la página principal del Panel. Para agregar las tareas y enlaces a las listas y secciones, copie un archivo XML llamado OEMHomePageContent.home o un archivo de recursos incrustado llamado OEMHomePageContent.dll en %ProgramFiles%\Windows Server\Bin\Addins\Home. El archivo de recursos incrustado se puede utilizar para localizar el texto en las tareas y los vínculos que se agregan. El archivo .home contiene las definiciones XML de las tareas y vínculos.

Agregar tareas a las listas de tareas CONFIGURAR, COMPLEMENTOS o ESTADO RÁPIDO y agregar vínculos a la tarea AYUDA

Puede agregar tareas a las listas de tareas CONFIGURAR, COMPLEMENTOSo ESTADO RÁPIDO, y vínculos a la AYUDA; para ello, defina las tareas y los enlaces en el archivo XML y, de manera opcional, cree el archivo de recursos incrustado e instálelo en el servidor. Si el archivo XML se instala en el servidor sin un archivo de recursos, debe tener como nombre OEMHomePageContent.home. Si se está usando un ensamblado para instalar el archivo XML y el archivo de recursos, se debe denominar OEMHomePageContent.dll y firmar con Authenticode.

Definición de tareas y enlaces

Puede utilizar un editor de textos como el Bloc de notas para crear el archivo .home; si también va a crear un archivo de recursos incrustado, puede utilizar Visual Studio 2010 o superior para definir los archivos. En el procedimiento siguiente se muestra cómo utilizar Visual Studio 2010 o superior para crear los archivos.

Para definir las tareas y enlaces

Abra Visual Studio 2010 o superior como administrador; para ello, haga clic con el botón secundario en el menú Inicio y seleccione Ejecutar como administrador.
Haga clic en Archivo, Nuevo y a continuación haga clic en Proyecto.
En el panel Plantillas, haga clic en Biblioteca de clase, escriba OEMHomePageContent en la casilla Nombre y a continuación haga clic en Aceptar.
Elimine el archivo Class1.cs.
Haga clic con el botón secundario en el nuevo proyecto, seleccione Agregar y a continuación haga clic en Nuevo elemento.
En el panel Plantillas, haga clic en Archivo XML, escriba OEMHomePageContent.home en la casilla Nombre y después haga clic en Agregar.

Nota

Si el archivo XML se instala sin un archivo de recursos, debe tener como nombre OEMHomePageContent.home. Si se incluye en un conjunto, puede tener cualquier nombre siempre y cuando tenga la extensión .home.

Añada el siguiente código XML al archivo OEMHomePageContent.home:


<Tasks version=?2.0? xmlns=?https://schemas.microsoft.com/WindowsServerSolutions/2010/01/Dashboard>
   <SetupMyServerTasks>
      <Task name="MyTask"
         description="MyTaskDescription"
         id="GUID">
              <Action
              name=?MyAction1Name?
              image=?IconForAction1?
              type=?TaskType?
              exelocation=?ActionExeLocation? />
              <Action
              name=?MyAction2Name?
              image=?IconForAction2?
              type=?TaskType?
              exelocation=?ActionExeLocation? />
               ¦
       </Task>
               ¦
    </SetupMyServerTasks>
<MailServiceTasks>
     <!-- Same schema as in œSetupMyServerTasks? but the tasks are shown in œConnect to Email Service? category. -->
</MailServiceTasks>
<LineOfBusinessTasks>
     <!-- Same schema as in œSetupMyServerTasks? but the tasks are shown in œAdd-ins? category. -->

<GetQuickStatusTasks>
      <Task name="MyQuickStatusTask1"
         description="MyQuickStatusTask1Desc   "
         id="GUID"
         assembly="AssemblyName of quick status query implementation"
         class="ClassName of quick status query implementation"
         replaceid="GUID"/>
           <!--  Same schema as Actions in œSetupMyServerTasks? -->
         </Task>
</GetQuickStatusTasks>
   <Links>
      <Link
         ID=?GUID?
         Title="Displayed text of the link"
         Description="A very short description"
         ShellExecPath="Path to the application or URL"/>
   </Links>
</Tasks>

Donde:

Atributo	Descripción
Nombre (tarea)	El nombre de la tarea que se muestra en la lista. Si crea un archivo de recursos incrustado, el valor de este atributo será el recurso de cadena.
descripción (tarea)	Descripción de la tarea. Si crea un archivo de recursos incrustado, el valor de este atributo será el recurso de cadena.
Id. (tarea)	Identificador único de la tarea. El identificador debe ser un GUID. Puede crear un nuevo GUID para una tarea exe , pero para tareas globales deberá utilizar el GUID que creó al definir la tarea para el panel de tareas de la subpestaña. Para obtener más información sobre la creación de un GUID, consulte Crear GUID (guidgen.exe).
imagen	Se omitirá este campo.
Nombre (acción)	Muestra el nombre de la tarea.
Tipo (acción)	Describe el tipo de tarea. La tarea puede ser: una tarea global, exe o de URL. Una tarea global es la misma tarea global que creó al definir las tareas del panel de tareas en la subpestaña. Para obtener más información sobre la creación de una tarea global que se puede usar en el panel de tareas de la subpestaña y en las listas de tareas Introducción o tareas comunes de la página principal, vea ¿Crear las clases de soporte técnico? en ¿Cómo crear una subpestaña? del SDK de soluciones de Windows Server. Las tareas exe se pueden utilizar para ejecutar aplicaciones desde las listas Tareas de introducción o Tareas comunes.
exelocation	La ruta a la aplicación asociada con la tarea. Este atributo solo se utiliza con las tareas exe.
replaceid	El identificador de la tarea que es sustituida por esta tarea.
ensamblado	AssemblyName del conjunto que proporciona la clase para implementar la consulta de estado rápido. El conjunto debe estar ubicado en Archivos de programa\windows server\bin\.
clase	Nombre de la clase que implementa la consulta de estado rápido. La clase debe implementar la interfaz ITaskStatusQuery.
Título (vínculo)	El texto del enlace. Si crea un archivo de recursos incrustado, el valor de este atributo será el recurso de cadena.
Descripción (vínculo)	La descripción del destino del enlace. Si crea un archivo de recursos incrustado, el valor de este atributo será el recurso de cadena.
ShellExecPath	La ruta a la aplicación o la dirección URL. Nota: El atributo ShellExecPath es compatible con variables de entorno.

En el siguiente código de ejemplo se muestra cómo definir un enlace para una aplicación:

<Links>
   <Link Title="Calc" Description="Launches Calc" ShellExecPath="%windir%\system32\calc.exe" />
</Links>

En el siguiente código de ejemplo se muestra cómo definir un enlace para una página web:

<Links>
   <Link Title="Browser" Description="Open browser" ShellExecPath="http://www.adventureworks.com/" />
</Links>

Cambie los valores del atributo para representar la tarea o el enlace.
En el Explorador de soluciones, haga clic con el botón secundario en OEMHomePageContent.home y, a continuación, haga clic en Propiedades. En el panel de Propiedades, en Acción de generación, seleccione Recurso incrustado.
Guarde el archivo OEMHomePageContent.home.

Para ver cómo implementar una consulta de estado rápido, consulte los documentos y ejemplos del SDK de Soluciones de Windows Server.

Cambiar el estado de la tarea CONFIGURAR/COMPLEMENTOS

Las tareas que se indican en CONFIGURAR y COMPLEMENTOS pueden alternar entre el estado completadas (configuradas para Complementos) y no completadas (no configuradas para Complementos).

Cuando defina la aplicación asociada a la nueva tarea, puede usar el método SetTaskStatus del espacio de nombres Microsoft.WindowsServerSolutions.Administration.ObjectModel.TaskStatusHelper (incluido, aunque no documentado, en el SDK de Soluciones de Windows Server) para cambiar el estado de la tarea. Así, por ejemplo, puede cambiar la marca de verificación de gris a verde si invoca el método SetTaskStatus con el valor de enumeración TaskStatus.Complete (SetTaskStatus(id, TaskStatus.Complete), donde id corresponde al identificador de la tarea). Los valores de enumeración que se pueden usar son TaskStatus.Complete, TaskStatus.Incomplete o TaskStatus.Hidden.

Sustituir tareas

Para sustituir las tareas predefinidas en la lista de Tareas de introducción o la lista de Tareas comunes, agregue el GUID de la tarea al atributo replaceid de la definición de la tarea. En la tabla siguiente encontrará una lista de las tareas y sus identificadores correspondientes que se pueden sustituir en el Panel:

Nombre de la tarea	Identificador
Obtener actualizaciones para otros productos de Microsoft	8412D35A-13EE-4112-AE0B-F7DBC83EA83D
Configurar copia de seguridad del servidor	F68B3F3F-19DE-499D-9ACB-4BB41B8FF420
Configurar Acceso desde cualquier lugar	8991302D-676A-4A7C-B244-D1E08AE0EFEA
Configurar notificación de alerta por correo electrónico	DE6F2B36-F19C-4FAF-998B-9772300E3530
Agregar una cuenta de usuario	6D5B5D5F-2EC7-4B1F-9580-4DB084B278B1
Agregar carpetas de servidor	03F1F438-D94E-439B-A9F7-0C817C37D625
Acceso desde cualquier lugar - Estado rápido	6093B462-1F04-4212-8804-9BC823070FAD
Copia de seguridad del servidor - Estado rápido	156947D8-21DC-45FE-A9A8-2F80AE304191
Carpetas del servidor - Estado rápido	C657E8AB-AC1F-4AA1-8E80-5AF6BB27C314
Cuenta de usuario activas - Estado rápido	68BCB125-CE8F-467F-B65B-56AD45A614B5
Notificación de alerta por correo electrónico - Estado rápido	75AB06E7-A679-4D62-A5EC-65362FE4F9DB
Equipos - Estado rápido	7966A974-D52D-4F5D-B37F-05C1B73CEEF3

(Opcional) Crear el archivo de recursos

Para localizar el texto de las tareas que agregue a las Tareas de introducción, Tareas comunes y los Vínculos de la comunidad, cree un ensamblado que contenga el archivo .home y un archivo .home.resx que defina las cadenas de texto.

Para crear el archivo de recursos

Haga clic con el botón secundario en el proyecto que haya creado para las tareas, haga clic en Agregar y a continuación en Nuevo elemento.
En el panel Plantillas, haga clic en Archivo de recursos, escriba OEMHomePageContent.home.resx en la casilla Nombre y a continuación haga clic en Agregar.

Nota

El archivo de recursos puede tener cualquier nombre, siempre que posea la extensión .home.resx.
Por cada tarea que agregue, deberá añadir cadenas y valores al archivo OEMHomePageContent.home.resx que coincidan con los elementos de Tareas y de Enlaces definidos en el archivo OEMHomePageContent.home. En el código de muestra que aparece a continuación se muestra un ejemplo de archivo Tasks.xml estructurado para el archivo de recursos:
```
<Tasks version=?2.0? xmlns=?https://schemas.microsoft.com/WindowsServerSolutions/2010/01/Dashboard>
   <SetupMyServerTasks>
      <Task name="MyTask"
         description="MyDescription"
         id="GUID">
         <Action
         name="MyActionname"
         image="IconForAction"
         type="TaskType"
         exelocation="ActionExeLocation" />
      </Task>
   </SetupMyServerTasks>
</Tasks>
```
Nota

Los identificadores de los atributos que se utilicen para la localización no pueden contener espacios.
Agregue los nombres de recursos MyTask, MyTaskDescription, MyActionName, y IconForAction en el archivo .resx con los valores adecuados.
Guarde el archivo OEMHomePageContent.home.resx y genere la solución.

Firme el ensamblado con una firma Authenticode

Para poder utilizar el ensamblado en el sistema operativo es necesario firmarlo mediante Authenticode. Para obtener más información acerca de cómo firmar el ensamblado, consulte Signing and Checking Code with Authenticode (Firma y comprobación de código con Authenticode).

Instale los archivos de tareas

Después de crear los archivos .home y .home.resx, deberá instalarlos en el servidor.

Para instalar los archivos de tareas

Asegúrese de que la solución no genere ningún error.
Si no ha creado ningún archivo de recursos incrustado, copie el archivo OEMHomePageContent.home en la carpeta %ProgramFiles%\Windows Server\Bin\Addins\Home del servidor. Si ha creado un archivo de recursos incrustado, copie el archivo OEMHomePageContent.dll en la carpeta %ProgramFiles%\Windows Server\Bin\Addins\Home del servidor.

Vea también

Creación y personalización de la imagen Personalizaciones adicionales Preparación de la imagen para su implementación Prueba de la experiencia del cliente

Compartir a través de