Muokkaa

Jaa

Prepare your development environment

  • Artikkeli
  • Koskee seuraavia::
    ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Let's get started developing extensions with the Windows Admin Center SDK! In this document, we'll cover the process to get your environment up and running to build and test an extension for Windows Admin Center.

Note

New to the Windows Admin Center SDK? Learn more about Extensions for Windows Admin Center

To prepare your development environment, perform the following steps:

Install prerequisites

To begin developing with the SDK, download and install the following prerequisites:

To bypass signature validation which occurs during extension installation in Windows Admin Center versions running with .NET 8, you should also switch your Windows Admin Center operation mode to "Development." To configure development mode, you must:

  • Open your Windows Admin Center instance's appsettings.json file. This can be found by default at C:\Program Files\WindowsAdminCenter\service\appsettings.json.
  • Modify the OperationMode field under the WindowsAdminCenter/System section to read "Development" instead of "Production."

Note

To develop extensions on versions of Windows Admin Center using .NET 4.6.2, you need to install and run Windows Admin Center in Dev Mode to follow the steps below. Dev Mode allows Windows Admin Center to load unsigned extension packages. Windows Admin Center can only be installed in Dev Mode on a Windows 10 machine.

To enable Dev Mode, install Windows Admin Center from the command line with the parameter DEV_MODE=1. In the example below, replace <version> with the version you are installing, i.e. WindowsAdminCenter1809.msi.

msiexec /i WindowsAdminCenter<version>.msi DEV_MODE=1

If you have already installed Windows Admin Center without enabling Dev Mode, you can edit the value of the Dev Mode property using Registry Editor. Properties for Windows Admin Center can be found under the following path:

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ServerManagementGateway

Install global dependencies

Next, install or update dependencies required for your projects, with Node Package Manager. These dependencies will be installed globally, and will be available for all projects.

npm install -g @angular/cli@11.2.14

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

Note

You can install a later version of @angular/cli, however be aware that if you install a version greater than 11.2.14, you will receive a warning during the gulp build step that the local cli version does not match the installed version.

Next steps

Now that your environment is prepared, you are ready to start creating content.

SDK design toolkit

Check out our Windows Admin Center SDK design toolkit! This toolkit is designed to help you rapidly mock up extensions in PowerPoint using Windows Admin Center styles, controls, and page templates. See what your extension can look like in Windows Admin Center before you start coding!