開発環境を準備する

Windows Admin Center SDK を使用して拡張機能の開発を始めましょう。 このドキュメントでは、Windows Admin Center の拡張機能をビルドしてテストするための環境を立ち上げるプロセスについて説明します。

開発環境を準備するには、次の手順を実行します。

前提条件をインストールする

SDK で開発を開始するには、次の前提条件をダウンロードしてインストールします。

• Windows Admin Center (GA またはプレビュー バージョン)
• Visual Studio または Visual Studio Code
• Node.js バージョン24.18.1 (LTSバージョンをダウンロードしてインストール)
• Node パッケージ マネージャー (6.14.5 以降)
• NuGet (拡張機能の発行用)
• Windows用のGit(自己署名証明書生成用のOpenSSLを含む)

.NET 8 で実行されている Windows Admin Center バージョンでの拡張機能のインストール中に発生する署名検証をバイパスするには、Windows Admin Center の操作モードを "開発" に切り替える必要もあります。開発モードを構成するには、次の手順を実行する必要があります。

• Windows Admin Center インスタンスの appsettings.json ファイルを開きます。 これは既定では C:\Program Files\WindowsAdminCenter\service\appsettings.json にあります。
• OperationMode セクションの WindowsAdminCenter/System フィールドの名前を "Production" から "Development" に変更してください。

グローバル依存関係をインストールする

次に、Node パッケージ マネージャーを使ってプロジェクトに必要な依存関係をインストールまたは更新します。 これらの依存関係をグローバルにインストールし、すべてのプロジェクトがアクセスできるようにします。

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

サイドローディングに備えて環境を整えましょう

拡張機能を作成したら、テストのためにWindows Admin Centerにサイドロードしたいです。 そのためには、拡張機能開発ディレクトリに対して以下のワンタイムステップを実行してください:

1. 管理者としてPowerShellを開き、証明書ディレクトリを作成します:

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

2. Gitの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. 新しい証明書をTrusted Rootにインポートする:

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

4. 管理者としてVisual Studio CodeでC:\Program Files\WindowsAdminCenter\Service\appsettings.jsonを開いてください。
5. corsSites配列を見つけてサイドロードURLを追加します(ポート4200がデフォルトです)。

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

6. CSPFrameAncestors配列を見つけてサイドロードURLを追加します(ポート4200がデフォルトです)。

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

7. ファイルを保存し、その後、管理者PowerShellウィンドウでWindows Admin Centerサービスを再起動してください:

     Restart-Service WindowsAdminCenter
   

完全修飾ドメイン名を使用したサイドローディング

Windows Admin Center拡張機能を、マシンの完全限定ドメイン名(FQDN)を含むURLを通じてサイドロードするには、以下の追加設定手順に従ってください。

1. Git の OpenSSL を使用して、localhost と 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. 新しい証明書をTrusted Rootにインポートする:

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

3. C:\Program Files\WindowsAdminCenter\Service\appsettings.json を更新して、FQDN オリジンを含む URL を含めます:

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

4. ファイルを保存し、その後、管理者PowerShellウィンドウでWindows Admin Centerサービスを再起動してください:

     Restart-Service WindowsAdminCenter
   

次のステップ

環境が準備できたので、コンテンツの作成を始めることができます。

• ツール拡張機能を作成する
• ソリューション拡張機能を作成する
• ゲートウェイ プラグインを作成する
• ガイドで詳細を確認する

SDK 設計ツールキット

Windows Admin Center の SDK 設計ツールキットを確認しましょう。 このツールキットは、Windows Admin Center のスタイル、コントロール、ページ テンプレートを使用して、PowerPoint で拡張機能を迅速にモデル化できるように設計されています。 コーディングを開始する前に、Windows Admin Center で拡張機能の外観を確認しましょう。