Vad är administrationstjänsten i Configuration Manager?

  • Artikel

Gäller för: Configuration Manager (aktuell gren)

SMS-providern ger API-samverkansåtkomst via HTTPS, som kallas administrationstjänsten. Administrationstjänsten är ett REST-API (Representational State Transfer) baserat på protokollet Open Data (OData) v4.

Administrationstjänsten har för närvarande två skikt eller vägar:

  • AdministrationstjänstenS > WMI > SQL: https://<SMSProviderFQDN>/AdminService/wmi/<ClassName>

    WMI-vägen stöder både GET- och POST-kommandon till över 700 klasser.

  • Administrationstjänsten > OData/SQL: https://<SMSProviderFQDN>/AdminService/v1.0/<ClassName>

    Den här versionsvägen (v1.0) stöder nya Configuration Manager funktioner.

Värdet <ClassName> är ett giltigt Configuration Manager klassnamn. Klassnamnen för administrationstjänsten är skiftlägeskänsliga. Se till att använda rätt versaler. Till exempel SMS_Site.

Scenarier

Configuration Manager använder administrationstjänsten internt för följande funktioner:

Dessutom kan du utveckla anpassade lösningar med administrationstjänsten, till exempel:

  • Ersätt en anpassad webbtjänst för att få åtkomst till information från webbplatsen.

  • I PowerShell-skript som du kör direkt från Configuration Manager-konsolen. Mer information finns i Skapa och köra PowerShell-skript från Configuration Manager-konsolen.

  • Ett PowerShell-skript i en aktivitetssekvens. Med den här åtgärden kan du komma åt information från webbplatsen utan att en anpassad webbtjänst behöver ha ett gränssnitt med WMI-providern. Mer information finns i Aktivitetssekvenssteg – Kör PowerShell-skript.

  • Få åtkomst till webbplatsdata från Power BI med hjälp av alternativet OData-anslutningsapp.

Förutsättningar

Konfigurera följande krav på den server som är värd för SMS-providerrollen:

  • I version 2006 och tidigare aktiverar du Webbserver för Windows-serverrollen (IIS). Från och med version 2010 krävs inte längre den här rollen.

  • Från och med version 2107 kräver SMS-providern .NET version 4.6.2 och version 4.8 rekommenderas. I version 2103 och tidigare kräver den här rollen .NET 4.5 eller senare. Mer information, krav för plats- och platssystem.

  • Du kan behöva aktivera säker HTTPS-kommunikation med ett betrott certifikat. Mer information finns i Aktivera säker HTTPS-kommunikation.

För att få åtkomst till administrationstjänsten måste ditt användarkonto vara en administrativ användare i Configuration Manager. Om du kommer åt administrationstjänsten via en molnhanteringsgateway måste du ha ett konto i Microsoft Entra-ID.

Mer information om skalbarhet för SMS-providern och administrationstjänsten finns i Storlek och skalningsnummer.

Obs!

För alla datorer med Configuration Manager-konsolen kan konsolen inte ansluta till administrationstjänsten om den använder en proxyserver. När du till exempel försöker komma åt säkerhetsnoderna kan det uppstå fel om att administrationstjänsten inte är aktiverad eller tillgänglig. Filen SmsAdminUI.log visar fel som, Failed to get a response for OData query.

Du kan lösa problemet genom att antingen ta bort proxykonfigurationen från datorn eller göra följande konfigurationsändring:

  1. Redigera följande XML-fil manuellt: C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config

  2. Konfigurera beteendet <defaultproxy> med något av följande alternativ:

    1. Ange enabled="false"
    2. Lägg till FQDN för SMS-providern i <bypasslist>.

    Mer information finns i<defaultProxy> Element (Nätverksinställningar).

Nästa steg

Så här konfigurerar du administrationstjänsten