A felügyeleti szolgáltatás használata Configuration Manager
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?
A Power BI Desktop menüszalagon válassza az Adatok lekérése, majd az OData-adatcsatorna lehetőséget.
Az URL-címnél adja meg a felügyeleti szolgáltatás útvonalát. Például:
https://smsprovider.contoso.com/AdminService/wmi/
Válassza a Windows-hitelesítés lehetőséget.
A Kezelő ablakban válassza ki a Power BI-irányítópulton vagy -jelentésben használni kívánt elemeket.
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}