Benutzerdefinierte Eigenschaften für Geräte

Gilt für: Configuration Manager (Current Branch)

Viele Kunden verfügen über andere Daten, die außerhalb von Configuration Manager liegen, aber für die Zielgruppenadressierung, die Erstellung von Sammlungen und die Berichterstellung nützlich sind. Diese Daten sind in der Regel nicht technischer Natur, können nicht auf dem Client gefunden werden und stammen aus einer einzigen externen Quelle. Zum Beispiel ein zentrales ITIL-System (IT Infrastructure Library) oder eine Asset-Datenbank, die einige der folgenden Geräteattribute aufweist:

• Physischer Standort
• Organisatorische Priorität
• Kategorie
• Kostenstelle
• Department

Ab Version 2107 können Sie den Verwaltungsdienst verwenden , um diese Daten auf Geräten festzulegen. Die Website speichert den Namen der Eigenschaft und ihren Wert in der Standortdatenbank als Klasse für benutzerdefinierte Geräteeigenschaften . Sie können dann die benutzerdefinierten Eigenschaften im Configuration Manager für die Berichterstellung oder zum Erstellen von Sammlungen verwenden.

Ab Version 2111 können Sie diese benutzerdefinierten Eigenschaften in der Configuration Manager-Konsole erstellen und bearbeiten. Diese neue Benutzeroberfläche erleichtert das Anzeigen und Bearbeiten dieser Eigenschaften.

Voraussetzungen

Das Konto, das die API-Aufrufe durchführt, benötigt die folgenden Berechtigungen für eine Sammlung, die das Zielgerät enthält:

• So legen Sie Eigenschaften fest: Ressource ändern
• So zeigen Sie Eigenschaften an: Ressource lesen
• So entfernen Sie Eigenschaften: Ressource löschen

Festlegen von Eigenschaften über die Benutzeroberfläche

Gilt für Version 2111 oder höher

1. Wechseln Sie in der Configuration Manager-Konsole zum Arbeitsbereich Bestand und Kompatibilität, und wählen Sie den Knoten Geräte aus.

2. Wählen Sie ein Gerät und dann im Menüband Eigenschaften aus

3. Wechseln Sie zur Registerkarte Benutzerdefinierte Eigenschaften .

4. Wählen Sie das goldene Sternsymbol aus, um eine neue benutzerdefinierte Eigenschaft zu erstellen. Geben Sie einen Namen für die Eigenschaft an, und legen Sie einen Wert für dieses Gerät fest. Wählen Sie "OK " aus, um die Eigenschaften zu speichern.

Eigenschaften über API festlegen

Gilt für Version 2107 oder höher

Verwenden Sie die SetExtensionData-API , um Eigenschaften auf einem Gerät festzulegen. Führen Sie einen POST-Aufruf an den URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.SetExtensionData mit einem JSON-Text durch. Die Ressourcen-ID ist beispielsweise ein ganzzahliger Wert.16777345

In diesem JSON-Beispiel werden zwei Name-Wert-Paare für das Asset-Tag und den Standort des Geräts festgelegt:

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

Eigenschaften anzeigen

Verwenden Sie die GetExtensionData-API , um Ihre benutzerdefinierten Eigenschaften anzuzeigen.

Um Eigenschaften auf einem einzelnen Gerät anzuzeigen, führen Sie einen GET-Aufruf an den URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.GetExtensionDataaus.

Um Eigenschaften auf allen Geräten anzuzeigen, führen Sie einen GET-Aufruf an die URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.GetExtensionDataaus. Dieser Aufruf gibt Eigenschaftswerte von Geräten zurück, für die Sie über Leseberechtigungen verfügen.

Eigenschaften entfernen

Um Eigenschaftswerte von allen Geräten zu entfernen, verwenden Sie die DeleteExtensionData-API ohne eine Geräte-ID. Schließen Sie eine Geräteressourcen-ID ein, um nur Eigenschaften von einem bestimmten Gerät zu entfernen. Führen Sie einen POST-Aufruf an den URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.DeleteExtensionDataaus.

Erstellen einer Sammlung

Führen Sie die folgenden Schritte aus, um eine Sammlung mit einer Abfrageregel basierend auf den benutzerdefinierten Eigenschaften zu erstellen:

1. Erstellen Sie in der Configuration Manager-Konsole eine Sammlung.

2. Wählen Sie auf der Seite Mitgliedschaftsregeln in der Liste Regel hinzufügen die Option Abfrageregel aus.

3. Geben Sie im Eigenschaftenfenster der Abfrageregel einen Namen für die Abfrage an. Wählen Sie dann Abfrageanweisung bearbeiten aus.

4. Wechseln Sie im Eigenschaftenfenster der Abfrageanweisung zur Registerkarte Kriterien. Wählen Sie dann das goldene Sternchen (*), um neue Kriterien hinzuzufügen.

5. Wählen Sie im Fenster Kriterien-Eigenschaftenfenster die folgenden Werte aus:

   • Attributklasse: Benutzerdefinierte Geräteeigenschaften
   • Attribut: PropertyName

6. Wählen Sie einen Operator aus, und geben Sie dann den Namen der Eigenschaft als Wert an.

   An dieser Stelle sollte das Fenster "Criterion-Eigenschaftenfenster" in etwa wie in der folgenden Abbildung aussehen:

   

   Wählen Sie OK aus, um das Kriterium zu speichern.

7. Wiederholen Sie die Schritte, um ein Kriterium für das PropertyValue-Attribut hinzuzufügen.

   An diesem Punkt sollte das Fenster mit den Eigenschaftenfenstern für die Sammlung "Abfrageanweisung" in etwa wie in der folgenden Abbildung aussehen:

   

8. Wählen Sie "OK " aus, um alle Eigenschaftenfenster zu schließen. Führen Sie dann den Assistenten aus, um die Sammlung zu erstellen.

Beispiel für eine WQL-Anweisung

Sie können auch die folgende Beispielabfrage verwenden. Wählen Sie im Eigenschaftenfenster der Abfrageanweisung die Option Abfragesprache anzeigen aus, um die Abfrageanweisung einzufügen.

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"

Nächste Schritte

Verwenden des Verwaltungsdiensts

Erstellen einer Sammlung

So verwalten Sie Clients