Configurer un jumeau de micro-agent

Découvrez comment configurer un jumeau de micro-agent.

Remarque

Defender pour IoT prévoit de mettre hors service le micro agent le 1er août 2025.

Prérequis

• Un compte Azure. Si vous n’avez pas encore de compte Azure, vous pouvez créer un compte Azure gratuit dès aujourd’hui.

• Un abonnement Defender pour IoT.

• Un hub IoT existant avec : Un appareil connecté et Un jumeau de module pour le micro-agent.

Configuration de micro-agent

Pour afficher et mettre à jour la configuration du jumeau de micro-agent :

1. Accédez au portail Azure.

2. Recherchez puis sélectionnez IoT Hub.

   

3. Sélectionnez votre hub IoT dans la liste.

4. Sous la section Gestion des appareils, sélectionnez Appareils.

   

5. Sélectionnez votre appareil dans la liste.

6. Sélectionnez l’ID de module.

   

7. Dans l’écran Détails sur l’identité de module, sélectionnez Jumeau d’identité de module.

   

8. Modifiez la valeur d’un champ en ajoutant le champ à la section "desired" avec la nouvelle valeur.

   

   Par exemple :

   "desired": {
       "Baseline_Disabled": false,
       "Baseline_MessageFrequency": "Low",
       "Baseline_GroupsDisabled": "",
       "Baseline_ChecksDisabled": "",
       "SystemInformation_Disabled": false,
       "SystemInformation_MessageFrequency": "Low",
       "SBoM_Disabled": false,
       "SBoM_MessageFrequency": "Low",
       "NetworkActivity_Disabled": false,
       "NetworkActivity_MessageFrequency": "Medium",
       "NetworkActivity_Devices": "eth0",
       "NetworkActivity_CacheSize": 256,
       "Process_Disabled": false,
       "Process_MessageFrequency": "Medium",
       "Process_PollingInterval": 100000,
       "Process_Mode": 1,
       "Process_CacheSize": 256,
       "LogCollector_Disabled": false,
       "LogCollector_MessageFrequency": "Low",
       "Heartbeat_Disabled": false,
       "Heartbeat_MessageFrequency": "Low",
       "Login_Disabled": false,
       "Login_MessageFrequency": "Medium",
       "IothubModule_MessageTimeout": 2880,
       "CollectorsCore_PriorityIntervals": "30,120,1440"
   }
   

   Pour obtenir la liste complète des propriétés prises en charge, consultez Configurations du micro-agent.

   L’agent a correctement défini la nouvelle configuration si la valeur de "latest_state", sous la section "reported", affiche "success".

   

   Si l’agent ne parvient pas à définir la nouvelle configuration, la valeur de "latest_state", sous la section "reported", affiche "failed". Dans ce cas, "latest_invalid_fields" contient une liste des champs qui ne sont pas valides.

Étapes suivantes

Vous avez appris comment configurer un jumeau de micro-agent. Pour plus d’informations sur les configurations de micro-agent et l’agrégation d’événements, consultez :

• Configurations du micro-agent

• Collecte d’événements du micro-agent