Keeping your extension up to date with SDK changes and platform changes is easy. We use NuGet Package Manager tags to organize the release of new features into SDK versions.
There are two SDK versions you can choose from and three which are deprecated:
latest– this SDK package aligns with the current GA release of Windows Admin Center and is the most stableexperimental– this SDK package contains the most recent changes and functionality, but might be unstableinsider– this SDK package has been deprecated, use latest or experimental insteadnext– this SDK package has been deprecated, use latest or experimental insteadlegacy– this SDK package has been deprecated, use latest or experimental instead
Note: Find out more about the different versions of Windows Admin Center that are available to download.
Targeting SDK version on a new project
When creating a new extension, you can include the --version parameter to target a different version of the SDK:
wac create --company "{!Company Name}" --tool "{!Tool Name}" --version {!version}
| Value | Explanation | Example |
|---|---|---|
{!Company Name} |
Your company name (with spaces) | Contoso Inc |
{!Tool Name} |
Your tool name (with spaces) | Manage Foo Works |
{!version} |
SDK Version | latest |
Here's an example creating a new extension targeting experimental:
wac create --company "Contoso Inc" --tool "Manage Foo Works" --version experimental
Note: We recommend developers building new extensions use the
latestSDK version for stability.
Targeting SDK version on an existing project
To modify an existing project to target a different SDK version, modify the following line in package.json:
"@microsoft/windows-admin-center-sdk": "latest",
In this example, replace latest with your desired SDK version, i.e. experimental:
"@microsoft/windows-admin-center-sdk": "experimental",
Then run npm install to update references throughout your project.
Source: Microsoft Learn / Windows Server documentation by Microsoft and contributors (upstream author metadata: davannaw-msft). Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
