We’re proud to announce the release of ConfigMgr WebService 1.7.0.

NOTE – If you’re using ConfigMgr OSD FrontEnd together with ConfigMgr WebService, wait for ConfigMgr OSD FrontEnd 1.5.0 to be released before you upgrade to ConfigMgr WebService 1.7.0. Compatability testing with ConfigMgr OSD FrontEnd 1.4.0 and ConfigMgr WebService 1.7.0 is currently not available.

What’s new

Below is a list of the added web methods in this release, divided by product:

General improvements
  • Improved error handling through almost all methods in ConfigMgr WebService is now available. Errors are now logged to the ConfigMgr WebService event log.
  • Method GetCMPrimaryUserByDeviceName no longer returns inactive UDA relations.
  • Method GetCMApplicationByCategory now excludes retired Applications.
  • New methods to support an upcoming release of a solution called ConfigMgr OSD Monitor is included in this release.
Configuration Manager
  • AddCMOSDMonitorData
  • GetCMCollectionByName
  • GetCMDeviceNameByMACAddress
  • GetCMDeviceNameByResourceID
  • GetCMOSDMonitorDataByUniqueID
  • GetCMOSDMonitorDataByComputer
Active Directory
  • AddADUserToGroup

DOWNLOAD CONFIGMGR WEBSERVICE

In order to get your hands on the bits for this web service, you have some options. You can download the source code from our GitHub page, and compile the web service yourself. For installation instructions, follow what’s outlined in the README.md file in the repository. You can visit our GitHub page from the link below:

https://github.com/NickolajA/ConfigMgrWebService

The second option is to download a compiled version of the web service, ready for use. This version can be downloaded from the URL below:

ConfigMgr WebService 1.7.0

We’ve published the source code for the purpose of making it available for those organisations that cannot leverage untrusted publishers, but also if you’d want to get your hands dirty and have a look at it.

UPDATE INSTRUCTIONS

If you already have ConfigMgr WebService installed in your environment, you can update it simply by replacing the ConfigMgrWebService.dll file in the bin folder of where you’ve placed the web service files. Please note though, that since version 1.1.0, three new Application Settings was introduced that you need to add manually, or replace the web.config file with the existing one and re-enter the values for each application setting.

With the 1.7.0 release and onward, there’s a new Application Settings named OSDMonitorDatabase that you’d have to add to the web.config file. See the included web.config file in the download package for an example of how it should be configured.

If ConfigMgr WebService has been installed by using the included wizard driven installation, run the wizard again and the upgrade process will begin. From version 1.4.0 and onwards, the upgrade experience has improved and previously configured values will now be populated automatically within the wizard. See the documentation embedded in the download package from TechNet Gallery for more information.

INSTALLATION INSTRUCTIONS

Please refer to the ConfigMgr WebService 1.7.0 – Installation Guide PDF attached in the download package.

DOCUMENTATION

Also attached in the download package is the documentation for each method currently available in the latest version of ConfigMgr WebService. Please refer to ConfigMgr WebService 1.7.0 – Documentation PDF for more information.

(3566)

comments
  • Skylar
    Posted at 23:32 January 25, 2019
    Skylar
    Reply
    Author

    Are there any special considerations for the WebService when setting up a Passive Primary Site Server?

    • Nickolaj Andersen
      Posted at 09:43 January 30, 2019
      Nickolaj Andersen
      Reply
      Author

      Hi,

      As I’ve not yet configured my lab environment with a passive site server, I’ve not been able to verify if there’s anything specific that needs to be configured. I’d say that you should configure the web service for your active site server, and when you need to failover, amend the application settings for the virtual application ‘ConfigMgrWebService’ in IIS to point to the passive-now-active site server.

      Regards,
      Nickolaj

  • Slade
    Posted at 23:21 February 18, 2019
    Slade
    Reply
    Author

    is MDT a pre-requisite for this ? i do not like MDT integration in my SCCM estate.

    • Nickolaj Andersen
      Posted at 15:00 March 14, 2019
      Nickolaj Andersen
      Reply
      Author

      It’s not a prerequisite, hence the optional text during the installation wizard.

      Regards,
      Nickolaj

  • Mark
    Posted at 14:39 February 19, 2019
    Mark
    Reply
    Author

    Does the service account need to be able to interactive login for it to work? I am getting no drivers returning when i test using the Driver Download tool. We do that stupid thing where we have to have separate “admin accounts” from the normal accounts we log in with. I am wondering how important the service account is, and where i can troubleshoot. i get ‘200’ back form IIS, but the single driver I imported is not listed. Also, can i do the Modern Driver, Modern BIOS without MDT integration? I want to avoid putting MDT on my MP and having to keep up with that.

    • Nickolaj Andersen
      Posted at 14:59 March 14, 2019
      Nickolaj Andersen
      Reply
      Author

      Hi Mark,

      Have you delegated permissions for the application pool identity (service account) in ConfigMgr? It needs Read-only Analyst role as a minimum.

      Regards,
      Nickolaj

  • Tom
    Posted at 20:08 May 6, 2019
    Tom
    Reply
    Author

    Hi there,
    Im getting error “Incorrect function. (Error: 00000001; Source: Windows)” when trying to invoke $WebService.SetADOrganizationalUnitForComputer. Is there a log for the web service I can check to possible get more info?

    Thanks
    Tom

    • Nickolaj Andersen
      Posted at 09:47 July 4, 2019
      Nickolaj Andersen
      Reply
      Author

      Hi Tom,

      There’s an event log, however the web service is not extended to log that much yet. It’s being improved in future iterations. I’d look at permissions first for the service account the web service is running as.

      Regards,
      Nickolaj

  • Chris Fox
    Posted at 11:21 June 6, 2019
    Chris Fox
    Reply
    Author

    Hi Great work here guys im having some issues, what account should i be using for the idenity?

    should it be a domain account which has read access to config manager?

    • Nickolaj Andersen
      Posted at 09:31 July 4, 2019
      Nickolaj Andersen
      Reply
      Author

      Hi Chris,

      Read the installation documentation for the web service, it covers what’s required 🙂

      Regards,
      Nickolaj

  • John
    Posted at 16:41 June 28, 2019
    John
    Reply
    Author

    how do you change the user/password for the site.

    also should I be able to browse to it? how do I verify it’s installed correctly

    • Nickolaj Andersen
      Posted at 08:47 July 4, 2019
      Nickolaj Andersen
      Reply
      Author

      Hi John,

      The web service is using an IIS Application Pool where you configure the service account. If you used the installer, it takes care of that for you. If you want to change the password, change it for the ConfigMgr WebService application pool.

      Regards,
      Nickolaj

  • Leave a Reply to Mark
    Cancel Reply

    This site uses Akismet to reduce spam. Learn how your comment data is processed.