Vad är administrationstjänsten i Configuration Manager?

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) som baseras på v4-protokollet Open Data (OData).

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

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

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

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

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

Värdet <ClassName> är ett giltigt Configuration Manager klassnamn. Administrationstjänstens klassnamn ä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 komma åt 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 behöva en anpassad webbtjänst för gränssnitt med WMI-providern. Mer information finns i Steg för uppgiftssekvens – Kör PowerShell-skript.

  • Åtkomst till webbplatsdata från Power BI med hjälp av anslutningsalternativet OData.

Förhandskrav

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

  • I version 2006 och tidigare aktiverar du Windows-serverrollen Webbserver (IIS). Från och med version 2010 behö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 finns i 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 administrativ användare i Configuration Manager. Om du får åtkomst till 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 Storleks- och skalnummer.

Obs!

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

Du kan kringgå det här problemet genom att 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 <defaultproxy> beteendet med något av följande alternativ:

    1. Uppsättning 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

  • Last updated on