Introduction
Lorsque vous clonez un appareil sur lequel l'agent Level est déjà installé, l'original et le clone partagent le même identifiant d'agent. Cela provoque un conflit — les deux appareils se disputent la même entrée dans Level, et l'un ou les deux afficheront une connectivité erratique. Cet article explique comment faire pivoter l'identifiant d'agent sur l'appareil cloné pour résoudre ce problème.
ℹ️ REMARQUE : Cela n'affecte que les appareils clonés. La réinstallation de l'agent sur un appareil existant ne modifie pas son identifiant — Level conserve l'identifiant d'origine lors des réinstallations pour éviter les entrées en double.
ℹ️ REMARQUE : La réinitialisation et la réinscription Autopilot constituent un cas différent. Les appareils Autopilot joints à Entra utilisant des agents récents sont rattachés à la même ligne Level via l'identifiant d'appareil joint à Entra au niveau de la machine. Ne faites pas pivoter l'identifiant d'agent pour « corriger » une réinscription Autopilot. Voir Installation via Intune sur Windows.
Faire pivoter l'identifiant d'agent automatiquement
La solution la plus rapide est l' --new-agent-id indicateur. Il génère un nouvel UUID, met à jour la configuration et redémarre l'agent en une seule étape.
Exécutez ceci sur l'appareil cloné appareil :
🖥️ NOTE DE PLATEFORME :
Windows :
& 'C:\Program Files\Level\level.exe' --new-agent-idmacOS :
sudo /usr/local/bin/level --new-agent-idLinux :
sudo /usr/local/bin/level --new-agent-id
Après le redémarrage de l'agent, l'appareil cloné s'enregistrera comme une nouvelle entrée dans Level. L'appareil d'origine n'est pas affecté.
Faire pivoter l'identifiant d'agent manuellement
Si vous ne pouvez pas exécuter le binaire de l'agent directement (par exemple, l'agent est arrêté ou le binaire est inaccessible), vous pouvez modifier l'identifiant directement dans la configuration.
⚠️ AVERTISSEMENT : Définissez la valeur sur un UUID v4 valide (généré aléatoirement). Ne réutilisez pas un identifiant provenant d'un autre appareil et ne laissez pas le champ vide. Après modification, redémarrez le service Level pour que la modification prenne effet.
🖥️ NOTE DE PLATEFORME :
Windows — Clé de registre :
Chemin :
HKEY_LOCAL_MACHINE\SOFTWARE\LevelNom de la clé :
AgentIDRemplacez la valeur par un nouvel UUID.
macOS — Fichier de configuration :
Chemin :
/Library/Application Support/Level/config.yamlNom de la clé :
agent-idRemplacez la valeur existante par un nouvel UUID.
Linux — Fichier de configuration :
Chemin :
/etc/level/config.yamlNom de la clé :
agent-idRemplacez la valeur existante par un nouvel UUID.
Après modification, redémarrez le service Level :
🖥️ NOTE DE PLATEFORME :
Windows :
Restart-Service -Name LevelmacOS :
sudo launchctl kickstart -k system/LevelLinux :
systemctl restart Level
Prévenir ce problème à l'avenir
Deux options pour les flux de provisionnement basés sur le clonage :
Option 1 — Faire pivoter l'UUID après le clonage (recommandé) : Conservez l'agent dans votre image maître et exécutez --new-agent-id dans le cadre de votre étape de provisionnement post-clonage (via MDM, script de démarrage ou RMM). Chaque appareil cloné reçoit automatiquement un nouvel identifiant au premier démarrage sans aucune intervention manuelle.
Option 2 — Désinstaller avant la création de l'image : Supprimez l'agent Level avant de créer l'image maître, puis installez Level comme étape post-clonage. Chaque appareil reçoit un nouvel identifiant d'agent lors de l'installation.
💡 CONSEIL : Les guides d'installation de Level pour Windows, macOS et Linux incluent des commandes d'installation silencieuse adaptées aux scripts de déploiement et aux flux de provisionnement post-clonage MDM.
FAQ
Sur quel appareil dois-je exécuter --new-agent-id — l'original ou le clone ? Exécutez-le sur le clone. L'appareil d'origine possède l'identifiant « correct » déjà enregistré dans Level. Faire pivoter l'identifiant du clone l'enregistre comme un nouvel appareil sans perturber l'original.
Après avoir fait pivoter l'identifiant, l'appareil cloné héritera-t-il des groupes, balises et champs personnalisés de l'original ? Non. L'appareil cloné s'enregistre comme un tout nouvel appareil dans Level. Vous devrez l'affecter aux groupes et aux balises appropriés. Les valeurs de champs personnalisés de l'original ne seront pas transférées.
Puis-je pousser --new-agent-id via Level si les deux appareils apparaissent de manière intermittente ? Cette méthode est peu fiable lorsque deux appareils se disputent le même identifiant. Un accès local ou un autre outil de télégestion est plus sûr. Une fois l'identifiant du clone modifié, les deux appareils bénéficieront de connexions stables et distinctes.
Comment générer un UUID valide pour une rotation manuelle d'identifiant ? Sur Windows :
[guid]::NewGuid().ToString()dans PowerShell. Sur macOS/Linux :uuidgen. L'une ou l'autre produit un UUID v4 valide.Mon appareil Autopilot a créé une deuxième ligne après une réinitialisation. Dois-je faire pivoter l'identifiant d'agent ? Non. Cet article concerne les appareils clonés qui partagent un même identifiant d'agent. La réinitialisation et la réinscription Autopilot utilisent une identité différente. Voir Installation via Intune sur Windows.