--- title: Déployer l’agent Cybee par stratégie de groupe (GPO) description: "Comment installer automatiquement l'agent Cybee sur les serveurs et postes d'un domaine Active Directory avec une GPO." url: "https://cybee.fr/documents/deployer-agent-cybee-par-gpo/" updated: "2026-10-08" category: Agent Windows --- # Déployer l’agent Cybee par stratégie de groupe (GPO) ## Objectif Installer automatiquement l’agent Cybee sur les serveurs et postes d’un domaine Active Directory avec une GPO. ## Prérequis - Un compte disposant des droits d’administration des GPO (Admins du domaine, ou un compte délégué). - La console **Gestion des stratégies de groupe** (`gpmc.msc`). - Les machines visées sont placées dans une même **unité d’organisation (OU)**. Si elles sont réparties dans plusieurs OU, vous pouvez utiliser un **groupe AD** pour filtrer la GPO (voir étape 2). - Systèmes Windows pris en charge :  [https://cybee.fr/documents/systemes-exploitation-serveurs-cybee/](https://cybee.fr/documents/systemes-exploitation-serveurs-cybee/) - Flux réseau sortants autorisés depuis les machines, en HTTPS (443) : `app.cybee.fr` et  le domaine du stockage S3. Si vous utilisez un proxy, vérifiez qu’il laisse passer ces flux. - **Une fenêtre de redémarrage** : l’installation par GPO se fait uniquement au démarrage de la machine. Sur des serveurs de production, planifiez une fenêtre de maintenance. > Si vous ne pouvez pas redémarrer certains serveurs, installez l’agent sur ces serveurs manuellement (double-clic sur le `.msi`) ou contactez le support Cybee. ## 1. Télécharger l’agent et préparer le partage 1. Téléchargez l’installeur de l’agent Cybee (ce sera la dernière version d’agent disponible via cette URL) : [https://app.cybee.fr/api/download/windows-msi](https://app.cybee.fr/api/download/windows-msi) 2. Renommez le fichier en indiquant sa version, par exemple `cybee-backup-0.17.39-x86_64.msi`. 3. Créez un dossier sur un serveur de fichiers, par exemple `D:DeployCybee`, et partagez-le (exemple : `\SRV-FICHIERSDeploy$`). 4. Donnez les droits suivants : - **Partage** : *Ordinateurs du domaine*, en lecture. - **NTFS** : *Ordinateurs du domaine*, en lecture et exécution. 5. Copiez le `.msi` dans le dossier créé précédemment. > L’installation se fait au démarrage, sous le compte de l’ordinateur. C’est pour cela que le groupe *Ordinateurs du domaine* doit avoir accès au partage. > **Important** : ne supprimez jamais ce fichier et ne le remplacez pas au même chemin. Windows en a besoin pour réparer, mettre à jour ou désinstaller l’agent. ## 2. Créer la GPO 1. Ouvrez `gpmc.msc` depuis l’executeur windows (Win+R) ou **Gestion des stratégies de groupe**dans les outils d’administration. 2. **Commencez par un test** : créez une OU de test contenant une ou deux machines, et liez-y d’abord la GPO. 3. Faites un clic droit sur l’OU visée, puis choisissez **Créer un objet GPO dans ce domaine, et le lier ici**. 4. Donnez-lui un nom explicite, par exemple `DEPLOY - Agent Cybee`. **Si vous filtrez par groupe AD (facultatif) :** 1. Dans l’onglet **Étendue** de la GPO, section *Filtrage de sécurité*, retirez *Utilisateurs authentifiés* et ajoutez votre groupe de machines. 2. Dans l’onglet **Délégation**, vérifiez que *Utilisateurs authentifiés* (ou *Ordinateurs du domaine*) garde le droit **Lecture**. Sans ce droit, la GPO n’est pas appliquée. 3. Une machine ajoutée au groupe doit être **redémarrée** pour en tenir compte. > Pour les contrôleurs de domaine, liez la GPO à l’OU *Domain Controllers*. ## 3. Ajouter le package 1. Faites un clic droit sur la GPO, puis choisissez **Modifier**. 2. Allez dans **Configuration ordinateur > Stratégies > Paramètres du logiciel > Installation de logiciel**. 3. Faites un clic droit, puis choisissez **Nouveau > Package**. 4. Sélectionnez le `.msi` **par son chemin réseau UNC** (`\SRV-FICHIERSDeploy$cybee-backup-0.17.39-x86_64.msi`). N’utilisez pas un chemin local ni un lecteur réseau. 5. Choisissez le mode **Attribué**. 6. Ouvrez les propriétés du package, onglet **Déploiement**, et vérifiez que l’option **Désinstaller cette application lorsqu’elle ne relève plus de l’étendue de gestion** est **décochée**. Sinon, l’agent est retiré si la machine change d’OU, et ses sauvegardes s’arrêtent. ## 4. Paramètre recommandé Pour que l’installation ne soit pas ignorée au démarrage, activez ce paramètre dans la même GPO : **Configuration ordinateur > Stratégies > Modèles d’administration > Système > Ouverture de session > Toujours attendre le réseau lors du démarrage de l’ordinateur et de l’ouverture de session** ## 5. Appliquer et vérifier Sur une machine de test, dans une invite de commandes **en administrateur** : `gpupdate /force` Redémarrez ensuite la machine. L’agent s’installe pendant le démarrage (il faut parfois **deux redémarrages**). Pour vérifier : - `gpresult /scope computer /r` (en administrateur) : la GPO doit apparaître dans la section *Objets Stratégie de groupe appliqués*. - **Programmes et fonctionnalités** : l’agent Cybee doit apparaître dans la liste. - **Services** (`services.msc`) : le service de l’agent Cybee doit être démarré. - En cas de doute, **Observateur d’événements > Journaux Windows > Application**, source *Application Management Group Policy* : on y voit le succès ou l’échec de l’installation. Une fois le test réussi, liez la GPO aux OU de production. ## Problèmes fréquents | Symptôme | Cause probable | | --- | --- | | GPO absente de `gpresult` | La machine n’est pas dans l’OU liée ou elle est exclue par le filtrage de sécurité | | GPO absente alors que la machine est dans le groupe | La machine n’a pas redémarré depuis son ajout au groupe, ou le droit *Lecture* manque dans l’onglet *Délégation* | | GPO appliquée mais agent non installé | Droits du partage ou NTFS insuffisants pour *Ordinateurs du domaine* | | Erreur « chemin introuvable » | Le package a été ajouté avec un chemin local au lieu d’un chemin UNC | | Aucune installation au démarrage | Le paramètre « Toujours attendre le réseau » n’est pas activé | | Aucune installation sur un site distant ou en VPN | Windows a détecté une liaison lente et ignore l’installation de logiciel | | Agent installé mais absent de la console Cybee | Les flux sortants vers Cybee sont bloqués (pare-feu ou proxy) | ## Mise à jour et désinstallation - **Mise à jour** : se fait à distance depuis la console Cybee. Ne poussez pas de nouvelle version par la GPO : elle sert uniquement à la première installation. - **Désinstallation** : faites un clic droit sur le package, puis **Toutes les tâches > Supprimer > Désinstaller immédiatement le logiciel des utilisateurs et des ordinateurs**. ## Après l’installation L’agent s’enregistre automatiquement dans Cybee, sans clé. **Cybee le rattache ensuite à votre organisation**.