Propriétés personnalisées pour les appareils

S’applique à : Configuration Manager (branche actuelle)

De nombreux clients disposent d’autres données externes à Configuration Manager, mais utiles pour le ciblage du déploiement, la création de collections et la création de rapports. Ces données sont généralement de nature non technique, ne sont pas détectables sur le client et proviennent d’une source externe unique. Par exemple, un système ou une base de données de ressources de la bibliothèque centrale d’infrastructure informatique (ITIL), qui possède certains des attributs de périphérique suivants :

• Emplacement physique
• Priorité organisationnelle
• Catégorie
• Centre de coût
• Service

À compter de la version 2107, vous pouvez utiliser le service d’administration pour définir ces données sur les appareils. Le site stocke le nom de la propriété et sa valeur dans la base de données du site en tant que classe Device Custom Properties . Vous pouvez ensuite utiliser les propriétés personnalisées dans Configuration Manager pour la création de rapports ou pour créer des collections.

À compter de la version 2111, vous pouvez créer et modifier ces propriétés personnalisées dans la console Configuration Manager. Cette nouvelle interface utilisateur facilite l’affichage et la modification de ces propriétés.

Configuration requise

Le compte qui effectue les appels d’API nécessite les autorisations suivantes sur une collection qui contient l’appareil cible :

• Pour définir les propriétés : Modifier la ressource
• Pour afficher les propriétés : Lire la ressource
• Pour supprimer des propriétés : Supprimer la ressource

Définir les propriétés via l’interface utilisateur

S’applique à la version 2111 ou ultérieure

1. Dans la console Configuration Manager, accédez à l’espace de travail Ressources et conformité, puis sélectionnez le nœud Appareils.

2. Sélectionnez un appareil, puis dans le ruban, sélectionnez Propriétés

3. Basculez vers l’onglet Propriétés personnalisées .

4. Sélectionnez l’icône en forme d’étoile dorée pour créer une propriété personnalisée. Donnez un nom à la propriété et définissez une valeur pour ce périphérique. Cliquez sur OK pour enregistrer les propriétés.

Définir les propriétés via l’API

S’applique à la version 2107 ou ultérieure

Pour définir des propriétés sur un appareil, utilisez l’API SetExtensionData . Effectuez un appel POST à l’URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.SetExtensionData avec un corps JSON. L’ID de ressource est une valeur entière, par exemple 16777345.

Cet exemple JSON définit deux paires nom-valeur pour l’étiquette d’inventaire et l’emplacement de l’appareil :

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

Afficher les propriétés

Utilisez l’API GetExtensionData pour afficher vos propriétés personnalisées.

Pour afficher les propriétés sur un seul appareil, effectuez un appel GET à l’URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.GetExtensionData.

Pour afficher les propriétés sur tous les appareils, effectuez un appel GET à l’URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.GetExtensionData. Cet appel renvoie les valeurs de propriété des appareils sur lesquels vous disposez d’une autorisation de lecture.

Supprimer des propriétés

Pour supprimer les valeurs de propriétés de tous les appareils, utilisez l’API DeleteExtensionData sans ID d’appareil. Incluez un ID de ressource d’appareil pour supprimer uniquement les propriétés d’un appareil spécifique. Effectuez un appel POST à l’URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.DeleteExtensionData.

Créer un regroupement

Procédez comme suit pour créer une collection avec une règle de requête basée sur les propriétés personnalisées :

1. Dans la console Configuration Manager, créez une collection.

2. Sur la page Règles d’appartenance, dans la liste Ajouter une règle , sélectionnez Règle de requête.

3. Dans la Fenêtre Propriétés Règle de requête, spécifiez un nom pour la requête. Sélectionnez ensuite Modifier l’instruction de requête.

4. Dans l’Fenêtre Propriétés d’instruction de requête, basculez vers l’onglet Critères. Sélectionnez ensuite l’astérisque doré (*) pour ajouter de nouveaux critères.

5. Dans la Fenêtre Propriétés Critère, sélectionnez les valeurs suivantes :

   • Classe d’attribut : Propriétés personnalisées de l’appareil
   • Attribut : PropertyName

6. Sélectionnez un opérateur , puis spécifiez le nom de la propriété en tant que valeur.

   À ce stade, la fenêtre Propriétés Propriétés du critère doit ressembler à l’image suivante :

   

   Cliquez sur OK pour enregistrer le critère.

7. Répétez les étapes pour ajouter un critère pour l’attribut PropertyValue .

   À ce stade, la fenêtre Propriétés Propriétés de l’instruction de requête de la collection doit ressembler à l’image suivante :

   

8. Sélectionnez OK pour fermer toutes les fenêtres de propriétés. Terminez ensuite l’assistant pour créer la collection.

Exemple d’instruction WQL

Vous pouvez également utiliser l’exemple de requête suivant. Dans la fenêtre des propriétés de l’instruction de requête, sélectionnez Afficher le langage de requête pour coller l’instruction de requête.

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"

Étapes suivantes

Utilisation du service d’administration

Créer un regroupement

Guide pratique pour gérer les clients