Aangepaste eigenschappen voor apparaten

Van toepassing op: Configuration Manager (current branch)

Veel klanten hebben andere gegevens die buiten Configuration Manager horen, maar die nuttig zijn voor het richten op implementaties, het opbouwen van verzamelingen en rapportages. Het betreft hier meestal niet-technische gegevens, die niet op de client kunnen worden gevonden en afkomstig zijn van één externe bron. Bijvoorbeeld een centraal ITIL-systeem (IT Infrastructure Library) of een activadatabase met enkele van de volgende apparaatkenmerken:

• Fysieke locatie
• Organisatorische prioriteit
• Categorie
• Kostenplaats
• Department

Vanaf versie 2107 kunt u de beheerservice gebruiken om deze gegevens in te stellen op apparaten. De naam van de eigenschap en de waarde ervan worden in de sitedatabase opgeslagen als de klasse Aangepaste eigenschappen voor apparaat . Vervolgens kunt u de aangepaste eigenschappen in Configuration Manager gebruiken voor rapportage of om verzamelingen te maken.

Vanaf versie 2111 kunt u deze aangepaste eigenschappen maken en bewerken in de Configuration Manager-console. Deze nieuwe gebruikersinterface maakt het gemakkelijker om deze eigenschappen weer te geven en te bewerken.

Vereisten

Het account dat de API-aanroepen uitvoert, heeft de volgende machtigingen nodig voor een verzameling die het doelapparaat bevat:

• Eigenschappen instellen: Resource wijzigen
• Eigenschappen weergeven: Bron lezen
• Eigenschappen verwijderen: Resource verwijderen

Eigenschappen instellen via de gebruikersinterface

Van toepassing op versie 2111 of hoger

1. Ga in de Configuration Manager-console naar de werkruimte Activa en compliance en selecteer het knooppunt Apparaten.

2. Selecteer een apparaat en selecteer vervolgens op het lint Eigenschappen

3. Overschakelen naar het tabblad Aangepaste eigenschappen .

4. Selecteer het pictogram met de gouden ster om een nieuwe aangepaste eigenschap te maken. Geef een naam op voor de eigenschap en stel een waarde in voor dit apparaat. Selecteer OK om de eigenschappen op te slaan.

Eigenschappen instellen via API

Van toepassing op versie 2107 of hoger

Als u eigenschappen wilt instellen op een apparaat, gebruikt u de API SetExtensionData . Voer een POST-oproep uit naar de URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.SetExtensionData met een JSON-hoofdtekst. De resource-id is bijvoorbeeld een geheel getal 16777345.

In dit JSON-voorbeeld worden twee naamwaardeparen ingesteld voor de inventaristag en locatie van het apparaat:

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

Eigenschappen bekijken

Gebruik de API GetExtensionData om de aangepaste eigenschappen weer te geven.

Als u eigenschappen op één apparaat wilt bekijken, doet u een GET-oproep naar de URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.GetExtensionData.

Als u eigenschappen op alle apparaten wilt weergeven, doet u een GET-oproep naar de URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.GetExtensionData. Met deze aanroep worden eigenschapswaarden geretourneerd van apparaten waarvoor u leesmachtigingen hebt.

Eigenschappen verwijderen

Als u eigenschappenwaarden van alle apparaten wilt verwijderen, gebruikt u de API DeleteExtensionData zonder apparaat-id. Voeg een resource-ID van het apparaat toe als u alleen eigenschappen van een specifiek apparaat wilt verwijderen. Voer een POST-oproep uit naar de URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.DeleteExtensionData.

Een verzameling maken

Gebruik de volgende stappen om een verzameling te maken met een queryregel op basis van de aangepaste eigenschappen:

1. Maak een verzameling in de Configuration Manager-console.

2. Selecteer op de pagina Lidmaatschapsregels in de lijst Regel toevoegende optie Queryregel.

3. Geef in het venster Eigenschappen van queryregels een naam voor de query op. Selecteer vervolgens Query-instructie bewerken.

4. Ga in het venster Eigenschappen van query-instructie naar het tabblad Criteria. Selecteer vervolgens het gouden sterretje (*) om nieuwe criteria toe te voegen.

5. Selecteer in het venster Eigenschappen van criterium de volgende waarden:

   • Kenmerkklasse: Aangepaste eigenschappen apparaat
   • Kenmerk: PropertyName

6. Selecteer een operator en geef vervolgens de naam van de eigenschap op als de waarde.

   Op dit punt moet het venster Eigenschappen van het criterium er ongeveer als volgt uitzien:

   

   Selecteer OK om het criterium op te slaan.

7. Herhaal de stappen om een criterium toe te voegen voor het kenmerk PropertyValue .

   Het venster Eigenschappen van de query-instructie van de verzameling ziet er nu ongeveer uit als in de volgende afbeelding:

   

8. Selecteer OK om alle eigenschappenvensters te sluiten. Voltooi vervolgens de wizard om de verzameling te maken.

Voorbeeld van WQL-instructie

U kunt ook de volgende voorbeeldquery gebruiken. Selecteer in het venster met eigenschappen van de query-instructie de optie Querytaal weergeven om de query-instructie te plakken.

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"

Volgende stappen

De beheerservice gebruiken

Een verzameling maken

Clients beheren