Anpassade egenskaper för enheter

Gäller för: Configuration Manager (aktuell gren)

Många kunder har andra data som är externa för Configuration Manager men användbara för distributionsmål, samlingsbyggnad och rapportering. Dessa data är vanligtvis icke-tekniska till sin natur, kan inte identifieras på klienten och kommer från en enda extern källa. Till exempel ett ITIL-system (Central IT Infrastructure Library) eller tillgångsdatabas som har några av följande enhetsattribut:

  • Fysisk plats
  • Organisatorisk prioritet
  • Kategori
  • Kostnadsställe
  • Department

Från och med version 2107 kan du använda administrationstjänsten för att ange dessa data på enheter. Platsen lagrar egenskapens namn och dess värde i platsdatabasen som klassen Anpassade egenskaper för enheten . Du kan sedan använda de anpassade egenskaperna i Configuration Manager för rapportering eller för att skapa samlingar.

Från och med version 2111 kan du skapa och redigera dessa anpassade egenskaper i konsolen Configuration Manager. Det nya användargränssnittet gör det enklare att visa och redigera de här egenskaperna.

Obs!

Du kan använda Unicode-tecken för anpassade egenskapsvärden, men inte för egenskapsnamnen. Mer information finns i Unicode- och ASCII-stöd i Configuration Manager.

Förhandskrav

Kontot som gör API-anropen kräver följande behörigheter för en samling som innehåller målenheten:

  • Så här anger du egenskaper: Ändra resurs
  • Så här visar du egenskaper: Läs resurs
  • Så här tar du bort egenskaper: Ta bort resurs

Ange egenskaper via användargränssnittet

Gäller för version 2111 eller senare

  1. I konsolen Configuration Manager går du till arbetsytan Tillgångar och efterlevnad och väljer noden Enheter.

  2. Välj en enhet och välj sedan Egenskaper i menyfliksområdet

  3. Växla till fliken Anpassade egenskaper .

  4. Välj guldstjärneikonen för att skapa en ny anpassad egenskap. Ange ett namn för egenskapen och ange ett värde för enheten. Välj OK för att spara egenskaperna.

Fliken Anpassade egenskaper på en enhet med flera värden.

Ange egenskaper via API

Gäller för version 2107 eller senare

Om du vill ange egenskaper på en enhet använder du API:et SetExtensionData . Gör ett POST-anrop till URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.SetExtensionData :n med en JSON-brödtext. Resurs-ID:t är ett heltal, till exempel 16777345.

I det här JSON-exemplet anges två namn/värde-par för enhetens resurstagg och plats:

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

Visa egenskaper

Använd API:et GetExtensionData för att visa dina anpassade egenskaper.

Om du vill visa egenskaper på en enda enhet gör du ett GET-anrop till URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.GetExtensionData:n.

Om du vill visa egenskaper på alla enheter gör du ett GET-anrop till URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.GetExtensionData:n. Det här anropet returnerar egenskapsvärden från enheter som du har läsbehörighet till.

Ta bort egenskaper

Om du vill ta bort egenskapsvärden från alla enheter använder du DeleteExtensionData-API :et utan enhets-ID. Inkludera ett enhetsresurs-ID för att endast ta bort egenskaper från en specifik enhet. Gör ett POST-anrop till URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.DeleteExtensionData:n.

Skapa en samling

Använd följande steg för att skapa en samling med en frågeregel baserat på de anpassade egenskaperna:

  1. Skapa en samling i konsolen Configuration Manager.

  2. På sidan Medlemskapsregler i listan Lägg till regel väljer du Frågeregel.

  3. Ange ett namn för frågan i fönstret Egenskaper för frågeregeln. Välj sedan Edit Query Statement.

  4. I fönstret Egenskaper för frågeuttrycket växlar du till fliken Villkor. Välj sedan den gyllene asterisken (*) för att lägga till nya villkor.

  5. I fönstret Egenskaper för villkorsfönstret Egenskaper väljer du följande värden:

    • Attributklass: Anpassade enhetsegenskaper
    • Attribut: PropertyName

  6. Välj en operator och ange sedan namnet på egenskapen som värde.

    Vid det här laget bör fönstret Villkor för fönstret Egenskaper se ut ungefär som på följande bild:

    Kriterium Fönstret Egenskaper för Egenskapsnamn för anpassade enhetsegenskaper.

    Välj OK för att spara villkoret.

  7. Upprepa stegen för att lägga till ett villkor för attributet PropertyValue .

    I det här läget bör fönstret Egenskaper egenskaper för samlingsfrågeuttrycket se ut ungefär som på följande bild:

    Fönstret Egenskaper för frågeuttryck med båda villkoren för anpassade egenskaper för enhet.

  8. Välj OK för att stänga alla egenskapsfönster. Slutför guiden för att skapa samlingen.

Exempel på WQL-uttryck

Du kan också använda följande exempelfråga. I fönstret Egenskaper för frågeutdrag väljer du Visa frågespråk för att klistra in frågeuttrycket.

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"

Obs!

Om du vill använda WQL-instruktioner med anpassade egenskaper med inkrementella samlingsuppdateringar använder du Configuration Manager version 2107 med den samlade uppdateringen eller senare.

Nästa steg

Så här använder du administrationstjänsten

Skapa en samling

Hantera klienter

  • Last updated on