Dela via

Anpassade egenskaper för enheter

  • Artikel

Gäller för: Konfigurationshanteraren (current branch)

Många kunder har andra data som är externa för Configuration Manager men användbara för distributionsmål, insamlingsskapande 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 CENTRALT IT-infrastrukturbibliotek (ITIL) system eller tillgångsdatabas, som har några av följande enhetsattribut:

  • Fysisk plats
  • Organisationsprioritet
  • 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 Enhetsanpassade egenskaper . Du kan sedan använda anpassade egenskaper 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 Configuration Manager-konsolen. Det nya användargränssnittet gör det enklare att visa och redigera dessa egenskaper.

Obs!

Du kan använda unicode-tecken för anpassade egenskapsvärden, men inte 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
  • Ta bort egenskaper: Ta bort resurs

Ange egenskaper via användargränssnittet

Gäller för version 2111 eller senare

  1. I Configuration Manager-konsolen 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 ikonen guldstjärna för att skapa en ny anpassad egenskap. Ange ett namn för egenskapen och ange ett värde för den här enheten. Spara egenskaperna genom att välja OK .

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 är ett heltalsvärde, till exempel 16777345.

Det här JSON-exemplet anger två namn/värde-par för enhetens tillgångstagg 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 API:et DeleteExtensionData 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 Configuration Manager-konsolen.

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

  3. I frågeregeln Fönstret Egenskaper anger du ett namn för frågan. Välj sedan Redigera frågeuttryck.

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

  5. I villkors Fönstret Egenskaper väljer du följande värden:

    • Attributklass: Anpassade egenskaper för enhet
    • Attribut: PropertyName

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

    Nu bör Fönstret Egenskaper för kriterium se ut ungefär som i följande bild:

    Villkor Fönstret Egenskaper för Egenskaper för enhetsegenskaper PropertyName.

    Spara kriteriet genom att välja OK .

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

    Nu bör samlingen Frågeuttryck Fönstret Egenskaper se ut ungefär som i följande bild:

    Frågeuttryck Fönstret Egenskaper med båda kriterierna för anpassade egenskaper för enheten.

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

Exempel på WQL-instruktion

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

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 för anpassade egenskaper med inkrementella samlingsuppdateringar använder du Configuration Manager version 2107 med samlad uppdatering eller senare.

Nästa steg

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

Skapa en samling

Hantera klienter