Skip to main content

Web Service API

DerThe Web Service stelltprovides einea direktedirect Schnittstelleinterface zuto SCCM darand undcan kannbe vonused Fremdanwendungenby genutztthird-party werden.applications.

WeitereFor Informationenmore zurinformation Verwendungon derhow Schnittstelleto sinduse inthe derinterface, API-Referenzsee unterthe https://www.smcteam.de/help/sccmmanager/3/api-reference/API Reference zu finden.at:

WennIf dieSOAP SOAP-Header-Securityheader eingeschaltetsecurity ist,is kannenabled, derthe Webserviceweb nurservice mitcan einemonly spezifischenbe SOAP-Headercalled aufgerufenwith werden.a Dieserspecific wirdSOAP mittelsheader. beiliegenderThis is generated using the enclosed .NET-KlassenbibliothekNET generiert.class Außerdemlibrary. mussIn einaddition, passendera Tokensuitable erstellttoken werden.must Imbe folgendencreated. wirdThis dieseconfiguration Konfigurationis anhandexplained einesbelow Beispielsusing erläutert.an example.

EinbindungIntegration in Visual Studio

DiesesThis Videovideo zeigtshows diethe hiersteps beschriebenendescribed Schritte:here:

Video fehlt: "WebService-API-Anbindung"

  1. KonfigurationConfiguration in derthe Konfigurationsdateiconfiguration file "web.config“config" desof Webservicesthe web service (alternativalternatively übervia diethe Anwendungapplication "SCCM Manager Web Config" aufon demthe Server,server, überopen dasvia Startmenüthe öffnen)start menu): 

    soap_header_setting_thumb_480_0.png
    DerThe „AssemblyName“"AssemblyName" istis freifreely wählbarselectable undand wirdwill späterbe imdisplayed Webservice-Loglater nebenin demthe aufrufendenweb Benutzerservice angezeigt.log next to the calling user.

  2. GenerierungGeneration einerof zufälligena random GUID undand Erweiterungextension derof Dateithe "Tokens.xml“xml" imfile Verzeichnisin „Ressources“the des"Resources" Webservices:directory of the web service:

    soap_header_token_thumb_480_0.png
  3. EinbindenInclude derthe Webservicereferenzweb service reference in Visual Studio:

    WebService-API-03_thumb_480_0.pngWebService-API-04_thumb_480_0.pngWebService-API-05_thumb_480_0.pngWebService-API-06_thumb_480_0.png
  4. EinbindenInclude derthe Dateifile "SCCMWebService.Token.dll“dll" in Visual Studio: 

    DieThe SCCMWebService.Token.dll vonfrom Server-Installationspfad\Server installation path\Copy API into dasyour eigeneown Projektverzeichnisproject kopieren,directory, dannthen referenzieren.reference it.
    overview-target.png


  5. InstanziierungInstantiation desof Webservicesthe mitweb demservice with the Soap Header,header, die übergebenethe GUID entsprichtpassed dercorresponds zuvorto Definiertenthe ausone derpreviously Dateidefined from the "Token.xml“:xml" file:

    			SCCMWebService.SCCMWebService sccmWebService = new SCCMWebService.SCCMWebService();
    			sccmWebService.Credentials = CredentialCache.DefaultCredentials;
    			sccmWebService.CookieContainer = new CookieContainer();
    
    			string sessionID = sccmWebService.GetSessionID();
    			string token = WebServiceToken.Create(sessionID, "7d9ac659-a113-4ad1-846f-da64ac42ca7f");
    
    			sccmWebService.SCCMSoapHeaderValue = new SCCMSoapHeader();
    			sccmWebService.SCCMSoapHeaderValue.Token = token;
    
    			//Test:
    			ServiceVersion version = sccmWebService.GetVersion();
  6. DerThe Webserviceweb kannservice nuncan benutztnow werden.be used.