Jak používat službu správy v Configuration Manager

Článek
04/04/2023

Platí pro: Configuration Manager (Current Branch)

Configuration Manager používá rozhraní REST API služby pro správu v několika nativních scénářích. Službu správy můžete také použít pro vlastní scénáře.

Poznámka

Všechny příklady v tomto článku používají plně kvalifikovaný název domény serveru, který je hostitelem role poskytovatele serveru SMS. Pokud ke službě pro správu přistupujete vzdáleně prostřednictvím cmg, použijte koncový bod CMG místo plně kvalifikovaného názvu domény poskytovatele serveru SMS. Další informace najdete v tématu Povolení přístupu k internetu.

Přímý dotaz

Existuje několik způsobů, jak se můžete přímo dotazovat na službu správy:

Webový prohlížeč
PowerShell
Nástroj třetí strany pro odesílání požadavků HTTPS GET nebo PUT do webové služby

V dalších částech se budeme zabývat prvními dvěma metodami.

Důležité

V názvech tříd služby pro správu se rozlišují velká a malá písmena. Nezapomeňte použít správná velká písmena. Například: SMS_Site.

Webový prohlížeč

Ke snadnému dotazování na službu správy můžete použít webový prohlížeč. Když jako adresu URL prohlížeče zadáte identifikátor URI dotazu, služba pro správu zpracuje požadavek GET a vrátí výsledek ve formátu JSON. Některé webové prohlížeče nemusí zobrazovat výsledek ve snadno čitelném formátu.

PowerShell

Přímé volání této služby pomocí rutiny Windows PowerShell Invoke-RestMethod

Příklad:

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

Tento příkaz vrátí následující výstup:

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

V následujícím příkladu přejdete k podrobnějším hodnotám:

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

Výstupem tohoto příkazu je konkrétní verze webu: 5.00.8968.1000

Volání PowerShellu z pořadí úkolů

Rutinu Invoke-RestMethod můžete použít ve skriptu PowerShellu z kroku pořadí úkolů Spustit skript PowerShellu . Tato akce umožňuje dotazovat službu správy během pořadí úkolů.

Další informace najdete v tématu Kroky pořadí úloh – spuštění skriptu PowerShellu.

Power BI Desktop

Power BI Desktop můžete použít k dotazování na data v Configuration Manager prostřednictvím služby pro správu. Další informace najdete v tématu Co je Power BI Desktop?

V Power BI Desktop na pásu karet vyberte Získat data a pak datový kanál OData.
Jako adresu URL zadejte trasu služby správy. Například https://smsprovider.contoso.com/AdminService/wmi/
Zvolte Ověřování systému Windows.
V okně Navigátor vyberte položky, které chcete použít v řídicím panelu nebo sestavě Power BI.

Ukázkové dotazy

Získání dalších podrobností o konkrétním zařízení

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

Příklad: https://smsprovider.contoso.com/AdminService/wmi/SMS_R_System(16777219)

Příklady tříd zařízení v1

Získejte všechna zařízení: https://<ProviderFQDN>/AdminService/v1.0/Device
Získat jedno zařízení: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)

Spusťte CMPivot na zařízení:

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

Viz Výsledek úlohy CMPivot:

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

Podívejte se, do kterých kolekcí zařízení patří: https://<ProviderFQDN>/AdminService/v1.0/Device(16777219)/ResourceCollectionMembership?$expand=Collection&$select=Collection

Filtrovat výsledky s použitím příkazu startswith

Tento příklad identifikátoru URI zobrazuje pouze kolekce, jejichž názvy začínají na All.

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

Spuštění statické metody rozhraní WMI

Tento příklad vyvolá metodu GetAdminExtendedData na SMS_AdminClass , která přijímá parametr s názvem Type s hodnotou 1.

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

Další kroky

Vlastní vlastnosti pro zařízení

Sdílet prostřednictvím