Share via


Wat is de beheerservice in Configuration Manager?

Van toepassing op: Configuration Manager (current branch)

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

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 voor meer dan 700 klassen.

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

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

De <ClassName> waarde is een geldige Configuration Manager-klassenaam. De namen van de serviceklassen voor beheer 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 informatie van de site zonder dat er een aangepaste webservice nodig is om te kunnen interfacen met de WMI-provider. Zie Takenreeksstappen - PowerShell-script uitvoeren voor meer informatie.

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

Voorwaarden

Configureer de volgende vereisten op de server die als host fungeert voor de sms-providerfunctie:

  • 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 hoger vereist. Site - en sitesysteemvereisten voor meer informatie.

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

Voor toegang tot de beheerservice moet uw gebruikersaccount een gebruiker met beheerdersrechten in Configuration Manager zijn. Als u toegang hebt tot de beheerservice via een cloudbeheergateway, moet u een account hebben in Microsoft Entra ID.

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

Opmerking

Als voor elke computer met de Configuration Manager-console een proxyserver wordt 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 SmsAdminUI.log-bestand 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 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. Set enabled="false"
    2. Voeg de FQDN van de SMS-provider toe aan de <bypasslist>.

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

Volgende stappen