Jak používat službu pro správu v nástroji Configuration Manager

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 pro správu můžete použít také pro vlastní scénáře.

Poznámka

Všechny příklady v tomto článku používají plně kvalifikovaný název domény (FQDN) 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 místo plně kvalifikovaného názvu domény poskytovatele SMS koncový bod CMG. Další informace naleznete v tématu Povolení přístupu k internetu.

Přímý dotaz

Služba správy se dá zadávat přímým dotazem několika způsoby:

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

Následující části se zabývají prvními dvěma metodami.

Důležité

V názvech tříd služeb pro správu se rozlišují malá a velká písmena. Dbejte na to, abyste používali správnou velikost písmen. Například: SMS_Site.

Webový prohlížeč

Pomocí webového prohlížeče se můžete snadno dotazovat služby správy. Když jako adresu URL prohlížeče zadáte identifikátor URI dotazu, služba správy zpracuje požadavek GET a vrátí výsledek ve formátu JSON. Některé webové prohlížeče nemusí výsledek zobrazit ve snadno čitelném formátu.

PowerShell

Proveďte přímá volání této služby pomocí rutiny Invoke-RestMethod prostředí Windows PowerShell.

Příklady:

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...

Následující příklad přejde ke konkrétně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 ze pořadí úkolů

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

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

Power BI Desktop

Pomocí aplikace Power BI Desktop můžete pokládat dotazy na data v nástroji Configuration Manager prostřednictvím služby správy. Další informace najdete v tématu Co je Power BI Desktop?

  1. V Power BI Desktop na pásu karet vyberte Získat data a vyberte Datový kanál OData.

  2. Jako adresu URL zadejte trasu služby správy. Například https://smsprovider.contoso.com/AdminService/wmi/

  3. Zvolte Ověřování systému Windows.

  4. V okně Navigátor vyberte položky, které chcete použít na řídicím panelu nebo v sestavě Power BI.

Snímek obrazovky s oknem Navigátor v aplikaci Power BI Desktop

Příklady dotazů

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

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

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

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

  • Získat 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>)

  • Zjištění, do kterých kolekcí zařízení patří: https://<ProviderFQDN>/AdminService/v1.0/Device(16777219)/ResourceCollectionMembership?$expand=Collection&$select=Collection

Filtrování výsledků se startswith

Tento ukázkový identifikátor 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 WMI

Tento příklad vyvolá metodu GetAdminExtendedData na SMS_AdminClass , která přebírá parametr s názvem Type with value 1.

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

Další kroky

Vlastní vlastnosti zařízení

  • Last updated on