Så här använder du administrationstjänsten i Configuration Manager
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?
I Power BI Desktop går du till menyfliksområdet och väljer Hämta data och sedan OData-feed.
För URL:en anger du administrationstjänstens väg. Till exempel
https://smsprovider.contoso.com/AdminService/wmi/
Välj Windows-autentisering.
I fönstret Navigatör väljer du de objekt som ska användas i power BI-instrumentpanelen eller rapporten.
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}