A felügyeleti szolgáltatás használata Configuration Manager

  • Cikk

A következőre vonatkozik: Configuration Manager (aktuális ág)

Configuration Manager a REST API felügyeleti szolgáltatást használja számos natív forgatókönyvben. A felügyeleti szolgáltatást saját egyéni forgatókönyveihez is használhatja.

Megjegyzés:

A cikkben szereplő példák mind az SMS-szolgáltatói szerepkört futtató kiszolgáló teljes tartománynevét használják. Ha távolról éri el a felügyeleti szolgáltatást egy CMG-n keresztül, használja a CMG-végpontot az SMS-szolgáltató teljes tartományneve helyett. További információ: Internet-hozzáférés engedélyezése.

Közvetlen lekérdezés

A felügyeleti szolgáltatást többféleképpen is lekérdezheti közvetlenül:

  • Webböngésző
  • PowerShell-
  • Külső eszköz HTTPS GET vagy PUT kérések webszolgáltatásnak való küldéséhez

A következő szakaszok az első két módszert ismertetik.

Fontos

A felügyeleti szolgáltatás osztálynevei megkülönböztetik a kis- és nagybetűket. Ügyeljen arra, hogy a megfelelő nagybetűs írásmódot használja. Használja például a SMS_Site címet.

Webböngésző

Webböngészővel egyszerűen lekérdezheti a felügyeleti szolgáltatást. Ha egy lekérdezési URI-t ad meg a böngésző URL-címeként, a felügyeleti szolgáltatás feldolgozza a GET kérést, és az eredményt JSON formátumban adja vissza. Előfordulhat, hogy egyes webböngészők nem könnyen olvasható formátumban jelenítik meg az eredményt.

PowerShell-

Közvetlen hívásokat kezdeményezhet ehhez a szolgáltatáshoz az Invoke-RestMethod Windows PowerShell parancsmaggal.

Például:

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

Ez a parancs a következő kimenetet adja vissza:

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

Az alábbi példa részletesebb értékeket mutat be:

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

A parancs kimenete a webhely adott verziója: 5.00.8968.1000

PowerShell meghívása feladatütemezésből

A PowerShell-szkript futtatása feladatütemezési lépésben használhatja az Invoke-RestMethod parancsmagot egy PowerShell-szkriptben. Ez a művelet lehetővé teszi a felügyeleti szolgáltatás lekérdezését egy feladatütemezés során.

További információ: Feladatütemezési lépések – PowerShell-szkript futtatása.

Power BI Desktop

A Power BI Desktop használatával lekérdezheti Configuration Manager adatait a felügyeleti szolgáltatáson keresztül. További információ: Mi az a Power BI Desktop?

  1. A Power BI Desktop menüszalagon válassza az Adatok lekérése, majd az OData-adatcsatorna lehetőséget.

  2. Az URL-címnél adja meg a felügyeleti szolgáltatás útvonalát. Például: https://smsprovider.contoso.com/AdminService/wmi/

  3. Válassza a Windows-hitelesítés lehetőséget.

  4. A Kezelő ablakban válassza ki a Power BI-irányítópulton vagy -jelentésben használni kívánt elemeket.

Képernyőkép Power BI Desktop Kezelő ablakáról

Példa lekérdezések

Egy adott eszköz további részleteinek lekérése

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

Például: https://smsprovider.contoso.com/AdminService/wmi/SMS_R_System(16777219)

v1 – Példák eszközosztályra

  • Az összes eszköz lekérése: https://<ProviderFQDN>/AdminService/v1.0/Device

  • Egyetlen eszköz lekérése: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)

  • Futtassa a CMPivot parancsot egy eszközön:

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

  • Lásd: CMPivot-feladat eredménye:

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

  • Az eszközhöz tartozó gyűjtemények megtekintése: https://<ProviderFQDN>/AdminService/v1.0/Device(16777219)/ResourceCollectionMembership?$expand=Collection&$select=Collection

Eredmények szűrése a következővel: startswith

Ez a példa URI csak azokat a gyűjteményeket jeleníti meg, amelyeknek a neve a kezdetű All.

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

Statikus WMI-metódus futtatása

Ez a példa meghívja a GetAdminExtendedData metódust a SMS_AdminClass , amely a Type nevű paramétert veszi fel értékkel 1.

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

Következő lépések

Egyéni tulajdonságok eszközökhöz