Vorbereiten Ihrer Entwicklungsumgebung

Lassen Sie uns mit der Entwicklung von Erweiterungen mit dem Windows Admin Center SDK beginnen! In diesem Dokument erfahren Sie, wie Sie Ihre Umgebung zum Erstellen und Testen einer Erweiterung für Windows Admin Center einrichten.

Führen Sie die folgenden Schritte aus, um Ihre Entwicklungsumgebung vorzubereiten:

Installieren der erforderlichen Komponenten

Um die Entwicklung mit dem SDK zu beginnen, laden Sie die folgenden Voraussetzungen herunter, und installieren Sie sie:

• Windows Admin Center (GA- oder Vorschauversion)
• Visual Studio oder Visual Studio Code
• Node.js Version 24.18.1 (LTS-Version herunterladen und installieren)
• Node Paket-Manager (6.14.5 oder höher)
• NuGet (für Veröffentlichungserweiterungen)
• Git für Windows (enthält OpenSSL zur Generierung selbstsignierter Zertifikate)

Um die Signaturüberprüfung zu umgehen, die während der Erweiterungsinstallation in Windows Admin Center-Versionen mit .NET 8 auftritt, sollten Sie auch den Windows Admin Center-Betriebsmodus auf "Entwicklung" setzen. Um den Entwicklungsmodus zu konfigurieren, müssen Sie:

• Öffnen Sie die appsettings.json-Datei Ihrer Windows Admin Center-Instanz. Dies ist standardmäßig unter C:\Program Files\WindowsAdminCenter\service\appsettings.jsonzu finden.
• Ändern Sie das feld OperationMode unter dem Abschnitt WindowsAdminCenter/System, um "Entwicklung" anstelle von "Produktion" zu lesen.

Installieren globaler Abhängigkeiten

Als Nächstes installieren oder aktualisieren Sie die für Ihre Projekte benötigten Abhängigkeiten mit dem Node Paket-Manager. Installiere diese Abhängigkeiten global, damit alle Projekte darauf zugreifen können.

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

Bereiten Sie Ihre Umgebung für das Querladen vor

Nachdem du deine Erweiterung erstellt hast, solltest du sie im Windows Admin Center zum Testen sideloaden. Dazu führen Sie die folgenden einmaligen Schritte für Ihr Erweiterungsentwicklungsverzeichnis durch:

1. Öffnen Sie PowerShell als Administrator und erstellen Sie ein Zertifikatsverzeichnis:

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

2. Erstellen Sie ein selbstsigniertes Zertifikat mit Gits OpenSSL:

   & "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. Importiere das neue Zertifikat in deinen Trusted Root:

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

4. Öffne C:\Program Files\WindowsAdminCenter\Service\appsettings.json in Visual Studio Code als Administrator.
5. Finde das corsSites Array und füge die Sideloading-URL hinzu (Port 4200 ist der Standard).

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

6. Finde das CSPFrameAncestors Array und füge die Sideloading-URL hinzu (Port 4200 ist der Standard).

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

7. Speichere die Datei und starte dann den Windows Admin Center-Dienst im PowerShell-Administratorfenster neu, indem du Folgendes ausführst:

     Restart-Service WindowsAdminCenter
   

Querladen mithilfe eines vollqualifizierten Domänennamens

Um Ihre Windows Admin Center-Erweiterung über eine URL zu sideloaden, die den vollständig qualifizierten Domainnamen (FQDN) Ihres Rechners enthält, folgen Sie diesen zusätzlichen Konfigurationsschritten:

1. Verwenden Sie Gits OpenSSL, um ein selbstsigniertes Zertifikat zu generieren, das Subject Alternative Names sowohl für localhost als auch für den FQDN enthält:

   & "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. Importiere das neue Zertifikat in deinen Trusted Root:

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

3. Aktualisieren Sie C:\Program Files\WindowsAdminCenter\Service\appsettings.json, um URLs mit dem FQDN-Ursprung einzubeziehen:

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

4. Speichere die Datei und starte dann den Windows Admin Center-Dienst im PowerShell-Administratorfenster neu, indem du Folgendes ausführst:

     Restart-Service WindowsAdminCenter
   

Nächste Schritte

Nachdem Ihre Umgebung vorbereitet wurde, können Sie jetzt mit der Erstellung von Inhalten beginnen.

• Erstellen einer Toolerweiterung
• Erstellen einer Lösungserweiterung
• Erstellen eines Gateway-Plug-Ins
• Erfahren Sie mehr mit unseren Leitfäden

SDK: Entwurfstoolkit

Sehen Sie sich unser Entwurfstoolkit für das Windows Admin Center SDK an. Dieses Toolkit soll Sie dabei unterstützen, mithilfe von Windows Admin Center-Formatvorlagen, -Steuerelementen und Seitenvorlagen schnell Erweiterungen in PowerPoint zu modellieren. Sehen Sie sich an, wie Ihre Erweiterung in Windows Admin Center aussehen kann, bevor Sie mit dem Programmieren beginnen.