Events
Nov 19, 11 PM - Nov 21, 11 PM
Gain in-demand skills with online sessions designed to meet the industry’s challenges head-on at Microsoft Ignite.
Register nowThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Applies to: Configuration Manager (current branch)
The SMS Provider provides API interoperability access over HTTPS, called the administration service. The administration service is a representational state transfer (REST) API based on the Open Data (OData) v4 protocol.
The administration service currently has two layers or routes:
Administration service > WMI > SQL: https://<SMSProviderFQDN>/AdminService/wmi/<ClassName>
The WMI route supports both GET and POST commands to over 700 classes.
Administration service > OData/SQL: https://<SMSProviderFQDN>/AdminService/v1.0/<ClassName>
This versioned route (v1.0) supports new Configuration Manager functionality.
The <ClassName>
value is a valid Configuration Manager class name. The administration service class names are case-sensitive. Make sure to use the proper capitalization. For example, SMS_Site
.
Configuration Manager natively uses the administration service for the following features:
The Security node of the console
Microsoft Intune tenant attach
In addition, you can develop custom solutions with the administration service, for example:
Replace a custom web service to access information from the site.
In PowerShell scripts that you run directly from the Configuration Manager console. For more information, see Create and run PowerShell scripts from the Configuration Manager console.
A PowerShell script in a task sequence. This action lets you access information from the site without requiring a custom web service to interface with the WMI provider. For more information, see Task sequence steps - Run PowerShell Script.
Access site data from Power BI using the OData connector option.
Configure the following prerequisites on the server that hosts the SMS Provider role:
In version 2006 and earlier, enable the Windows server role Web Server (IIS). Starting in version 2010, this role is no longer required.
Starting in version 2107, the SMS Provider requires .NET version 4.6.2, and version 4.8 is recommended. In version 2103 and earlier, this role requires .NET 4.5 or later. For more information, Site and site system prerequisites.
You may need to enable secure HTTPS communication with a trusted certificate. For more information, see Enable secure HTTPS communication.
To access the administration service, your user account needs to be an administrative user in Configuration Manager. If you access the administration service via a cloud management gateway, you need to have an account in Microsoft Entra ID.
For more information on scalability of the SMS Provider and administration service, see Size and scale numbers.
Note
For any machine with the Configuration Manager console, if it's using a proxy server, the console fails to connect to the administration service. For example, when trying to access the Security nodes, you may see errors that the administration service isn't enabled or available. The SmsAdminUI.log file shows errors such as, Failed to get a response for OData query.
To work around this issue, either remove the proxy configuration from the machine, or make the following configuration change:
Manually edit the following XML file: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config
Configure the <defaultproxy>
behavior with one of the following options:
enabled="false"
<bypasslist>
.For more information, see <defaultProxy>
Element (Network Settings).
Events
Nov 19, 11 PM - Nov 21, 11 PM
Gain in-demand skills with online sessions designed to meet the industry’s challenges head-on at Microsoft Ignite.
Register now