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

Cikk
04/04/2023

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

Sok ügyfél más, Configuration Manager kívülről származó adatokkal is rendelkezik, amelyek hasznosak az üzembe helyezés célzásához, a gyűjtemények létrehozásához és a jelentéskészítéshez. Ezek az adatok általában nem technikai jellegűek, nem észlelhetők az ügyfélen, és egyetlen külső forrásból származnak. Például egy központi IT Infrastructure Library (ITIL) rendszer vagy adategység-adatbázis, amely az alábbi eszközattribútumok némelyikével rendelkezik:

Fizikai hely
Szervezeti prioritás
Kategória
Költséghely
Department

A 2107-es verziótól kezdve a felügyeleti szolgáltatással állíthatja be ezeket az adatokat az eszközökön. A hely a tulajdonság nevét és értékét a helyadatbázisban az Egyéni eszköztulajdonságok osztályként tárolja. Ezután a Configuration Manager egyéni tulajdonságait jelentéskészítéshez vagy gyűjtemények létrehozásához használhatja.

A 2111-es verziótól kezdve ezeket az egyéni tulajdonságokat a Configuration Manager konzolon hozhatja létre és szerkesztheti. Ez az új felhasználói felület megkönnyíti ezeknek a tulajdonságoknak a megtekintését és szerkesztését.

Megjegyzés:

Egyéni tulajdonságértékekhez Unicode-karaktereket is használhat, a tulajdonságneveket azonban nem. További információ: A Unicode és az ASCII támogatása Configuration Manager.

Előfeltételek

Az API-hívásokat kezdeményező fióknak a következő engedélyekre van szüksége a céleszközt tartalmazó gyűjteményhez:

Tulajdonságok beállítása: Erőforrás módosítása
Tulajdonságok megtekintése: Erőforrás olvasása
Tulajdonságok eltávolítása: Erőforrás törlése

Tulajdonságok beállítása felhasználói felületen keresztül

A 2111-es vagy újabb verzióra vonatkozik

A Configuration Manager konzolon lépjen az Eszközök és megfelelőség munkaterületre, és válassza az Eszközök csomópontot.
Válasszon ki egy eszközt, majd a menüszalagon válassza a Tulajdonságok lehetőséget
Váltson az Egyéni tulajdonságok lapra.
Új egyéni tulajdonság létrehozásához válassza az arany csillag ikont . Adja meg a tulajdonság nevét, és állítson be egy értéket az eszközhöz. A tulajdonságok mentéséhez kattintson az OK gombra .

Egyéni tulajdonságok lap több értékkel rendelkező eszközön.

Tulajdonságok beállítása API-val

A 2107-es vagy újabb verzióra vonatkozik

Az eszköz tulajdonságainak beállításához használja a SetExtensionData API-t. Hozzon létre egy POST-hívást az URI-hoz https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.SetExtensionData egy JSON-törzstel. Az erőforrás-azonosító egy egész szám, például 16777345.

Ez a JSON-példa két név-érték párt állít be az eszköz eszközcímkéjéhez és helyéhez:

{
  "ExtensionData": {
    "AssetTag":"0580255",
    "Location":"Dublin"
  }
}

Tulajdonságok megtekintése

Az egyéni tulajdonságok megtekintéséhez használja a GetExtensionData API-t.

Egyetlen eszköz tulajdonságainak megtekintéséhez hozzon létre egy GET-hívást az URI-hozhttps://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.GetExtensionData.

Az összes eszköz tulajdonságainak megtekintéséhez hozzon létre egy GET hívást az URI-hoz https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.GetExtensionData. Ez a hívás olyan eszközöktől ad vissza tulajdonságértékeket, amelyekre olvasási engedéllyel rendelkezik.

Tulajdonságok eltávolítása

Ha minden eszközről el szeretné távolítani a tulajdonságok értékeit, használja a DeleteExtensionData API-t eszközazonosító nélkül. Adjon meg egy eszközerőforrás-azonosítót, hogy csak egy adott eszköz tulajdonságait távolítsa el. Hozzon létre egy POST-hívást az URI-hoz https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.DeleteExtensionData.

Gyűjtemény létrehozása

Az alábbi lépésekkel létrehozhat egy gyűjteményt az egyéni tulajdonságokon alapuló lekérdezési szabmánnyal:

A Configuration Manager konzolon hozzon létre egy gyűjteményt.
A Tagsági szabályok lap Szabály hozzáadása listájában válassza a Lekérdezési szabály lehetőséget.
A Lekérdezési szabály Tulajdonságok ablak adja meg a lekérdezés nevét. Ezután válassza a Lekérdezési utasítás szerkesztése lehetőséget.
A Lekérdezési utasítás Tulajdonságok ablak váltson a Feltételek lapra. Ezután válassza az arany csillagot (*) az új feltételek hozzáadásához.
A Feltétel Tulajdonságok ablak válassza ki a következő értékeket:
- Attribútumosztály: Eszköz egyéni tulajdonságai
- Attribútum: PropertyName
Válasszon ki egy operátort , majd adja meg a tulajdonság nevét értékként.

Ezen a ponton a kritérium Tulajdonságok ablak az alábbi ábrához hasonlóan kell kinéznie:

A feltétel mentéséhez kattintson az OK gombra .
Ismételje meg a lépéseket a PropertyValue attribútum feltételének hozzáadásához.

Ezen a ponton a gyűjtemény lekérdezési utasításának Tulajdonságok ablak a következő képhez hasonlóan kell kinéznie:
Kattintson az OK gombra az összes tulajdonságablak bezárásához. Ezután fejezze be a varázslót a gyűjtemény létrehozásához.

Példa WQL-utasításra

A következő mintalekérdezés is használható. A lekérdezési utasítás tulajdonságainak ablakában válassza a Lekérdezési nyelv megjelenítése lehetőséget a lekérdezési utasítás beillesztéséhez.

select SMS_R_SYSTEM.ResourceID,SMS_R_SYSTEM.ResourceType,SMS_R_SYSTEM.Name,SMS_R_SYSTEM.SMSUniqueIdentifier,SMS_R_SYSTEM.ResourceDomainORWorkgroup,SMS_R_SYSTEM.Client 
from SMS_R_System inner join SMS_G_System_ExtensionData on SMS_G_System_ExtensionData.ResourceId = SMS_R_System.ResourceId 
where SMS_G_System_ExtensionData.PropertyName = "AssetTag" and SMS_G_System_ExtensionData.PropertyValue = "0580255"

Megjegyzés:

Ha egyéni WQL-utasításokat szeretne használni növekményes gyűjteményfrissítésekkel, használja Configuration Manager 2107-es verziót a kumulatív frissítéssel vagy újabb verzióval.