Preparación del entorno de desarrollo

Comencemos a desarrollar extensiones con el SDK de Windows Admin Center. En este documento, trataremos el proceso para poner en marcha el entorno para compilar y probar una extensión para Windows Admin Center.

Para preparar el entorno de desarrollo, realice los pasos siguientes:

Instalar requisitos previos

Para empezar a desarrollar con el SDK, descargue e instale los siguientes requisitos previos:

• Windows Admin Center (versión de disponibilidad general o versión preliminar)
• Visual Studio o Visual Studio Code
• Node.js versión 24.18.1 (descarga e instala la versión LTS)
• Administrador de paquetes de nodo (6.14.5 o posterior)
• NuGet (para extensiones de publicación)
• Git para Windows (incluye OpenSSL para generar certificados autofirmados)

Para omitir la validación de firmas que se produce durante la instalación de la extensión en versiones de Windows Admin Center que se ejecutan con .NET 8, también debe cambiar el modo de operación de Windows Admin Center a "Desarrollo". Para configurar el modo de desarrollo, debe:

• Abra el archivo appsettings.json de la instancia de Windows Admin Center. Esto se puede encontrar de forma predeterminada en C:\Program Files\WindowsAdminCenter\service\appsettings.json.
• Modifique el campo OperationMode en la sección WindowsAdminCenter/System para leer "Desarrollo" en lugar de "Producción".

Instalación de dependencias globales

A continuación, instala o actualiza las dependencias necesarias para tus proyectos usando Node Administrador de paquetes. Instala estas dependencias globalmente para que todos los proyectos puedan acceder a ellas.

npm install -g @angular/cli@20.3.25

npm install -g gulp
npm install -g typescript
npm install -g eslint
npm install -g @microsoft/windows-admin-center-sdk@latest

Prepare su entorno para la instalación paralela

Después de crear tu extensión, quieres instalarla manualmente en Windows Admin Center para hacer pruebas. Para ello, realiza los siguientes pasos, que solo tendrás que hacer una vez, en el directorio de desarrollo de tu extensión:

1. Abre PowerShell como administrador y crea un directorio de certificados:

   New-Item -ItemType Directory -Path "C:<path>\certificate"
   

2. Genera un certificado autofirmado usando OpenSSL de Git:

   & "C:\Program Files\Git\usr\bin\openssl.exe" req -x509 -newkey rsa:2048 -nodes -keyout C:\<path-to-extension-directory>\certificate\localhost.key -out C:\<path-to-extension-directory>\certificate\localhost.cert -days 365 -subj "/CN=localhost" -addext "subjectAltName=DNS:localhost"
   

3. Importe el nuevo certificado a su raíz de confianza:

    Import-Certificate -FilePath "C:\<path-to-extension-directory>\certificate\localhost.cert" -CertStoreLocation "Cert:\LocalMachine\Root"
   

4. Abra C:\Program Files\WindowsAdminCenter\Service\appsettings.json en Visual Studio Code como administrador.
5. Busca la matriz corsSites y añade la URL de carga lateral (el puerto 4200 es el que se usa por defecto).

    "CorsSites": [
      "https://localhost:4200"
    ]
   

6. Busque la matriz CSPFrameAncestors y añada la URL de instalación paralela (el puerto 4200 es el predeterminado).

    "CSPFrameAncestors": [
      "'self'",
      ... existing entries ...
      "https://localhost:4200"
    ]
   

7. Guarda el archivo y luego reinicia el servicio Windows Admin Center en tu ventana PowerShell de administrador ejecutando:

     Restart-Service WindowsAdminCenter
   

Instalación lateral mediante un nombre de dominio completo

Para instalar lateralmente su extensión de Windows Admin Center a través de una URL que incluya el nombre de dominio completo (FQDN) de su equipo, siga estos pasos de configuración adicionales:

1. Utiliza el OpenSSL de Git para generar un certificado autofirmado que incluya nombres alternativos del sujeto tanto para localhost como para el FQDN:

   & "C:\Program Files\Git\usr\bin\openssl.exe" req -x509 -newkey rsa:2048 -nodes -keyout C:\<path-to-extension-directory>\certificate\localhost.key -out C:\<path-to-extension-directory>\certificate\localhost.cert -days 365 -subj "/CN=localhost" -addext "subjectAltName=DNS:localhost,DNS:<FQDN>"
   

2. Importe el nuevo certificado a su raíz de confianza:

    Import-Certificate -FilePath "C:\<path-to-extension-directory>\certificate\localhost.cert" -CertStoreLocation "Cert:\LocalMachine\Root"
   

3. Actualiza C:\Program Files\WindowsAdminCenter\Service\appsettings.json para incluir URL con el origen FQDN:

    "CorsSites": [
      "https://localhost:4200",
      "https://<FQDN>:4200"
    ],
    "CSPFrameAncestors": [
      "'self'",
      ... existing entries ...
      "https://localhost:4200",
      "https://<FQDN>:4200"
    ]
   

4. Guarda el archivo y luego reinicia el servicio Windows Admin Center en tu ventana PowerShell de administrador ejecutando:

     Restart-Service WindowsAdminCenter
   

Pasos siguientes

Ahora que el entorno está preparado, está listo para empezar a crear contenido.

• Creación de una extensión de herramienta
• Creación de una extensión de solución
• Crea un plugin de gateway
• Más información con nuestras guías

Kit de herramientas de diseño del SDK

Eche un vistazo a nuestro kit de herramientas de diseño SDK del Windows Admin Center. Este kit de herramientas está diseñado para ayudarle a maquetar rápidamente extensiones en PowerPoint utilizando los estilos, controles y plantillas de página del Windows Admin Center. Vea el aspecto que puede tener la extensión en Windows Admin Center antes de empezar a codificar.