Wat is de beheerservice in Configuration Manager?

Van toepassing op: Configuration Manager (current branch)

De SMS-provider biedt API-interoperabiliteitstoegang via HTTPS, ook wel de beheerservice genoemd. De beheerservice is een REST-API (Representational State Transfer) op basis van het OData v4-protocol (Open Data).

De beheerservice heeft momenteel twee lagen of routes:

  • Beheerservice > WMI > SQL: https://<SMSProviderFQDN>/AdminService/wmi/<ClassName>

    De WMI-route ondersteunt zowel GET- als POST-opdrachten naar meer dan 700 klassen.

  • Beheerservice > OData/SQL: https://<SMSProviderFQDN>/AdminService/v1.0/<ClassName>

    Deze versie van route (v1.0) ondersteunt nieuwe Configuration Manager functionaliteit.

De <ClassName> waarde is een geldige Configuration Manager klassenaam. De klassenamen van de beheerservice zijn hoofdlettergevoelig. Zorg ervoor dat u het juiste hoofdlettergebruik gebruikt. Bijvoorbeeld SMS_Site.

Scenario's

Configuration Manager maakt systeemeigen gebruik van de beheerservice voor de volgende functies:

Daarnaast kunt u aangepaste oplossingen ontwikkelen met de beheerservice, bijvoorbeeld:

  • Vervang een aangepaste webservice voor toegang tot informatie vanaf de site.

  • In PowerShell-scripts die u rechtstreeks vanuit de Configuration Manager console uitvoert. Zie PowerShell-scripts maken en uitvoeren vanuit de Configuration Manager-console voor meer informatie.

  • Een PowerShell-script in een takenreeks. Met deze actie kunt u toegang krijgen tot gegevens van de site zonder dat er een aangepaste webservice nodig is om te kunnen worden gekoppeld aan de WMI-provider. Zie Takenreeksstappen - PowerShell-script uitvoeren voor meer informatie.

  • Toegang tot sitegegevens vanuit Power BI met behulp van de OData-connectoroptie.

Voorwaarden

Configureer de volgende vereisten op de server die als host fungeert voor de rol SMS-provider:

  • Schakel in versie 2006 en eerder de Windows-serverfunctie webserver (IIS) in. Vanaf versie 2010 is deze rol niet meer vereist.

  • Vanaf versie 2107 vereist de SMS-provider .NET-versie 4.6.2 en wordt versie 4.8 aanbevolen. In versie 2103 en eerder is voor deze rol .NET 4.5 of later vereist. Voor meer informatie, site- en sitesysteemvereisten.

  • Mogelijk moet u beveiligde HTTPS-communicatie met een vertrouwd certificaat inschakelen. Zie Beveiligde HTTPS-communicatie inschakelen voor meer informatie.

Voor toegang tot de beheerservice moet uw gebruikersaccount een gebruiker met beheerdersrechten zijn in Configuration Manager. Als u de beheerservice opent via een cloudbeheergateway, moet u een account hebben in Azure Active Directory (Azure AD).

Zie Grootte en schaalnummers voor meer informatie over de schaalbaarheid van de SMS-provider en de beheerservice.

Notitie

Als een computer met de Configuration Manager-console een proxyserver gebruikt, kan de console geen verbinding maken met de beheerservice. Wanneer u bijvoorbeeld toegang probeert te krijgen tot de beveiligingsknooppunten , ziet u mogelijk fouten dat de beheerservice niet is ingeschakeld of beschikbaar is. Het bestand SmsAdminUI.log bevat fouten zoals: Failed to get a response for OData query.

U kunt dit probleem omzeilen door de proxyconfiguratie van de computer te verwijderen of door de volgende configuratiewijziging aan te brengen:

  1. Bewerk het volgende XML-bestand handmatig: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. Configureer het <defaultproxy> gedrag met een van de volgende opties:

    1. Instellen enabled="false"
    2. Voeg de FQDN van de SMS-provider toe aan de <bypasslist>.

    Zie <defaultProxy> Element (Netwerkinstellingen) voor meer informatie.

Volgende stappen