@microsoft/windows-admin-center-sdk
v6.0.0
Published
Microsoft - Windows Admin Center Software Development Kit
Maintainers
Keywords
Readme
Windows Admin Center SDK
@microsoft/windows-admin-center-sdk is the official SDK for building and maintaining
Windows Admin Center extensions. It bundles the WAC
runtime libraries, the shared build/lint tooling, and the wac command-line tool used to
scaffold and upgrade extensions.
Requirements
- Node.js 24 or later (the
wacCLI and the Angular 20 toolchain require it). - A package manager (
npm,pnpm, oryarn).
Install
npm install @microsoft/windows-admin-center-sdkThis makes the wac command available (via npx wac …, or on your PATH when installed
globally).
Create an extension
Scaffold a new extension project (Angular 20) in the current directory:
# A single tool extension
npx wac create --company <company-name> --name <tool-name>
# A solution containing one or more tools
npx wac create --company <company-name> --solution <solution-name> --tool <tool-name> --type <tool-type>| Flag | Description |
| --- | --- |
| --company | Your company or author name (required). |
| --name | Tool name for a single-tool extension. |
| --solution | Solution name (enables solution mode). |
| --tool | Tool name within a solution. |
| --type | Tool type within a solution. |
| --version | SDK release ring to target: latest (default), insider, next, experimental, release. |
| --verbose | Verbose logging. |
Then build and serve:
cd <tool-name>
npm install
npm run build
npm start -- --port=4200Upgrade an extension
Upgrade an existing extension to the current Angular/toolchain baseline (Angular 15 → 20, Node 24), run from the extension's root:
npx wac upgrade| Flag | Description |
| --- | --- |
| --stage <n> | Run a single stage (1=configs, 2=ng update, 3=standalone, 4=code fixups, 5=eslint). Default 0 runs all stages. |
| --pipeline | CI mode — skip interactive prompts. |
| --debug | Verbose logging. |
What's in the SDK
Import the runtime libraries by subpath:
| Import | Contents |
| --- | --- |
| @microsoft/windows-admin-center-sdk/core | Core runtime (RPC, host, notifications, data, manifest, …). |
| @microsoft/windows-admin-center-sdk/angular | Angular components, directives, and services. |
| @microsoft/windows-admin-center-sdk/styles | Shared CSS and fonts. |
| @microsoft/windows-admin-center-sdk/angular-devtools | Build/lint/test tooling (gulp plugins, ESLint base, Prettier, webpack). |
What's new in 6.0.0
6.0.0 modernizes the SDK toolchain. It contains breaking changes — review before upgrading.
Breaking changes
wacCLI now has two commands:createandupgrade. The 5.x commandseslint(tslint→eslint migration) andangular15Upgradewere removed. The Angular migration now lives underwac upgrade(Angular 15 → 20), and lint fixes run as a stage ofwac upgrade.wac upgradechanged meaning. In 5.x it audited/updated dependencies (--audit,UpgradeAudit.txt); it now performs the Angular 15 → 20 toolchain migration (--stage,--pipeline,--internal,--debug).wac createscaffolds Angular 20 projects (was Angular 15).- Node.js 24+ is required to run the
wacCLI (no Node floor was declared in 5.x). …/core/copilotwas renamed to…/core/assistant. Update imports accordingly.
Documentation & feedback
- Docs: https://aka.ms/wacsdkdocs
- Feedback: https://aka.ms/WACFeedback
