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

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

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

Megjegyzés:

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

Közvetlen lekérdezés

Több módszerrel is közvetlenül lekérdezheti a felügyeleti szolgáltatást:

  • Webböngésző
  • PowerShell-
  • Külső gyártó eszköze, amellyel HTTPS GET vagy PUT kéréseket küldhet a webszolgáltatásnak

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

Fontos

A felügyeleti szolgáltatás osztálynevében különbözőnek számítanak a kis- és nagybetűk. Ügyeljen a megfelelő kis- és nagybetűs írásmódra. Használja például a SMS_Site címet.

Webböngésző

Egy webböngésző használatával egyszerűen lekérdezheti a felügyeleti szolgáltatást. Ha 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 böngészők nem könnyen olvasható formátumban jelenítik meg az eredményeket.

PowerShell-

Indítson közvetlen hívásokat 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 jelenít meg:

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

A parancs kimenete a webhely konkrét verziója: 5.00.8968.1000

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

A Invoke-RestMethod parancsmagot használhatja egy PowerShell-parancsfájlban a PowerShell-parancsfájl futtatása feladatütemezési lépésben. Ezzel a művelettel lekérdezheti a felügyeleti szolgáltatást a feladatütemezés során.

További információ: Feladatütemezés lépései – PowerShell-parancsfájl futtatása.

Power BI Desktop

A Power BI Desktop használatával lekérdezheti az adatokat a Configuration Manager szolgáltatáson keresztül. További információt a Mi a Power BI Desktop? című cikkben talál.

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

  2. Az URL-címhez 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 jelölje ki a Power BI-irányítópulton vagy -jelentésben használni kívánt elemeket.

Képernyőkép a Kezelő ablakról a Power BI Desktop alkalmazásban

Példa lekérdezésekre

További részletek lekérése egy adott eszközről

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 letöltése: https://<ProviderFQDN>/AdminService/v1.0/Device

  • Szerezzen be egyetlen eszközt: https://<ProviderFQDN>/AdminService/v1.0/Device(<ResourceID>)

  • Futtassa a CMPivot-fájlt 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>)

  • Tekintse meg, hogy egy eszköz mely gyűjteményekhez tartozik: https://<ProviderFQDN>/AdminService/v1.0/Device(16777219)/ResourceCollectionMembership?$expand=Collection&$select=Collection

Eredmények szűrése a startswith függvénnyel

Ez a példa URI csak azokat a gyűjteményeket jeleníti meg, amelyek neve a következővel kezdődik 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 azon a SMS_AdminClass, amely a Típus 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 eszköztulajdonságok

  • Last updated on