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

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

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

Obs!

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

Direkt fråga

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

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

I följande avsnitt beskrivs de två första metoderna.

Viktigt

Administrationstjänstens klassnamn ä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 cmdlet 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 finns 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 webbplatsen: 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 Steg för uppgiftssekvens – 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 menyfliksområdet i Power BI Desktop väljer du Hämta data och sedan OData-feed.

  2. För URL-adressen 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

Visa mer information om en viss enhet

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

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

v1 Exempel på enhetsklasser

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

  • Skaffa en enda 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 CMPivot-jobbresultat:

    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

Den här exempel-URI:n visar bara samlingar vars namn börjar med All.

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

Kör en statisk WMI-metod

Det här exemplet anropar metoden GetAdminExtendedData på SMS_AdminClass som tar parametern 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

  • Last updated on