Benutzerdefinierte Eigenschaften für Geräte

Artikel
04/04/2023

Gilt für: Configuration Manager (Current Branch)

Viele Kunden verfügen über andere Daten, die für Configuration Manager aber für die Bereitstellungszielbestimmung, sammlungserstellung und Berichterstellung nützlich sind. Diese Daten sind in der Regel nicht technisch, auf dem Client nicht auffindbar und stammen aus einer einzelnen externen Quelle. Beispielsweise ein zentrales ITIL-System (ITIL) oder eine Ressourcendatenbank, die über einige der folgenden Geräteattribute verfügt:

Physischer Standort
Organisationspriorität
Kategorie
Kostenstelle
Abteilung

Ab Version 2107 können Sie diese Daten mithilfe des Verwaltungsdiensts auf Geräten festlegen. Der Standort speichert den Namen der Eigenschaft und ihren Wert in der Standortdatenbank als Klasse benutzerdefinierte Geräteeigenschaften . Anschließend können Sie die benutzerdefinierten Eigenschaften in Configuration Manager für berichte 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.

Hinweis

Sie können Unicode-Zeichen für benutzerdefinierte Eigenschaftswerte verwenden, aber nicht für die Eigenschaftennamen. Weitere Informationen finden Sie unter Unicode- und ASCII-Unterstützung in Configuration Manager.

Voraussetzungen

Das Konto, das die API-Aufrufe durchführt, erfordert 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

Wechseln Sie in der Configuration Manager-Konsole zum Arbeitsbereich Bestand und Kompatibilität, und wählen Sie den Knoten Geräte aus.
Wählen Sie ein Gerät und dann im Menüband Eigenschaften aus.
Wechseln Sie zur Registerkarte Benutzerdefinierte Eigenschaften .
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.

Registerkarte

Festlegen von Eigenschaften über die API

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 aus. Die Ressourcen-ID ist ein ganzzahliger Wert, z. B 16777345. .

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

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

Eigenschaften anzeigen

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

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

Zum Anzeigen von Eigenschaften auf allen Geräten führen Sie einen GET-Aufruf an den URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.GetExtensionDataaus. Dieser Aufruf gibt Eigenschaftswerte von Geräten zurück, für die Sie leseberechtigungen haben.

Eigenschaften entfernen

Um Eigenschaftenwerte von allen Geräten zu entfernen, verwenden Sie die DeleteExtensionData-API ohne Geräte-ID. Fügen 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:

Wählen Sie in der Configuration Manager-Konsole Die Option Sammlung erstellen aus.
Wählen Sie auf der Seite Mitgliedschaftsregeln in der Liste Regel hinzufügen die Option Abfrageregel aus.
Geben Sie im Eigenschaftenfenster Abfrageregel einen Namen für die Abfrage an. Wählen Sie dann Abfrageanweisung bearbeiten aus.
Wechseln Sie im Eigenschaftenfenster Abfrageanweisung zur Registerkarte Kriterien. Wählen Sie dann das goldene Sternchen (*) aus, um neue Kriterien hinzuzufügen.
Wählen Sie im Eigenschaftenfenster Kriterium die folgenden Werte aus:
- Attributklasse: Benutzerdefinierte Geräteeigenschaften
- Attribut: PropertyName
Wählen Sie einen Operator aus, und geben Sie dann den Namen der Eigenschaft als Wert an.

An diesem Punkt sollte das Kriterium Eigenschaftenfenster in etwa wie in der folgenden Abbildung aussehen:

Wählen Sie OK aus, um das Kriterium zu speichern.
Wiederholen Sie die Schritte, um ein Kriterium für das PropertyValue-Attribut hinzuzufügen.

An diesem Punkt sollte die Abfrageanweisung der Sammlung Eigenschaftenfenster in etwa wie in der folgenden Abbildung aussehen:
Wählen Sie OK aus, um alle Eigenschaftenfenster zu schließen. Schließen Sie dann den Assistenten ab, 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"

Hinweis

Um WQL-Anweisungen für benutzerdefinierte Eigenschaften mit inkrementellen Sammlungsupdates zu verwenden, verwenden Sie Configuration Manager Version 2107 mit dem Updaterollup oder höher.