Så här använder du administrationstjänsten i Configuration Manager

  • Artikel

Gäller för: Konfigurationshanteraren (current branch)

Configuration Manager använder administrationstjänstens REST API i flera interna scenarier. Du kan också använda administrationstjänsten för dina egna anpassade scenarier.

Obs!

Exemplen i den här artikeln använder alla FQDN för den server som är värd för SMS-providerrollen. Om du fjärransluter till administrationstjänsten via en CMG använder du CMG-slutpunkten i stället för FQDN för SMS-providern. Mer information finns i Aktivera Internetåtkomst.

Direktfråga

Det finns flera sätt att fråga administrationstjänsten direkt:

  • Webbläsare
  • PowerShell
  • Ett verktyg från tredje part för att skicka HTTPS GET- eller PUT-begäranden till webbtjänsten

I nästa avsnitt beskrivs de två första metoderna.

Viktigt

Klassnamnen för administrationstjänsten är skiftlägeskänsliga. Se till att använda rätt versaler. Till exempel SMS_Site.

Webbläsare

Du kan använda en webbläsare för att enkelt fråga administrationstjänsten. När du anger en fråge-URI som webbläsarens URL bearbetar administrationstjänsten GET-begäran och returnerar resultatet i JSON-format. Vissa webbläsare kanske inte visar resultatet i ett lättläst format.

PowerShell

Gör direkta anrop till den här tjänsten med Windows PowerShell-cmdleten Invoke-RestMethod.

Till exempel:

Invoke-RestMethod -Method 'Get' -Uri "https://SMSProviderFQDN/AdminService/wmi/SMS_Site" -UseDefaultCredentials

Det här kommandot returnerar följande utdata:

@odata.context                                                value
--------------                                                -----
https://SMSProviderFQDN/AdminService/wmi/$metadata#SMS_Site   {@{@odata.etag=FC1; __LAZYPROPERTIES=System.Objec...

I följande exempel ökas detaljnivån till mer specifika värden:

((Invoke-RestMethod -Method 'Get' -Uri "https://SMSProviderFQDN/AdminService/wmi/SMS_Site" -UseDefaultCredentials).value).Version

Utdata från det här kommandot är den specifika versionen av platsen: 5.00.8968.1000

Anropa PowerShell från en aktivitetssekvens

Du kan använda cmdleten Invoke-RestMethod i ett PowerShell-skript från aktivitetssekvenssteget Kör PowerShell-skript . Med den här åtgärden kan du fråga administrationstjänsten under en aktivitetssekvens.

Mer information finns i Aktivitetssekvenssteg – Kör PowerShell-skript.

Power BI Desktop

Du kan använda Power BI Desktop för att fråga efter data i Configuration Manager via administrationstjänsten. Mer information finns i Vad är Power BI Desktop?

  1. I Power BI Desktop går du till menyfliksområdet och väljer Hämta data och sedan OData-feed.

  2. För URL:en anger du administrationstjänstens väg. Till exempel https://smsprovider.contoso.com/AdminService/wmi/

  3. Välj Windows-autentisering.

  4. I fönstret Navigatör väljer du de objekt som ska användas i power BI-instrumentpanelen eller rapporten.

Skärmbild av fönstret Navigatör i Power BI Desktop

Exempelfrågor

Få mer information om en specifik enhet

https://<ProviderFQDN>/AdminService/wmi/SMS_R_System(<ResourceID>)

Till exempel: https://smsprovider.contoso.com/AdminService/wmi/SMS_R_System(16777219)

v1 Exempel på enhetsklass

  • Hämta alla enheter: https://<ProviderFQDN>/AdminService/v1.0/Device

  • Hämta en enskild enhet: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)

  • Kör CMPivot på en enhet:

    Verb: POST
URI: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)/AdminService.RunCMPivot
Body: {"InputQuery":"<CMPivot query to run>"}

  • Se resultat för CMPivot-jobb:

    Verb: GET
URI: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)/AdminService.CMPivotResult(OperationId=<Operation ID of the CM Pivot job>)

  • Se vilka samlingar en enhet tillhör: https://<ProviderFQDN>/AdminService/v1.0/Device(16777219)/ResourceCollectionMembership?$expand=Collection&$select=Collection

Filtrera resultat med startswith

Det här exemplets URI visar bara samlingar vars namn börjar med All.

https://<ProviderFQDN>/AdminService/wmi/SMS_Collection?$filter=startswith(Name,'All') eq true

Köra en statisk WMI-metod

Det här exemplet anropar metoden GetAdminExtendedData på den SMS_AdminClass som tar parametern type med namnet Type med värdet 1.

Verb: Post
URI: https://<ProviderFQDN>/AdminService/wmi/SMS_Admin.GetAdminExtendedData
Body: {"Type":1}

Nästa steg

Anpassade egenskaper för enheter