# Installation de l’agent OpManager sur les appareils à l’aide d’un script de démarrage

L’agent OpManager peut être installé sur plusieurs appareils à l’aide de la GPO Windows. Vous pouvez utiliser des scripts de démarrage pour déployer automatiquement l’installation de l’agent lors du démarrage du système, garantissant une installation cohérente et sans effort sur tous les appareils ciblés. Cette méthode est idéale pour les grands environnements où un déploiement centralisé et automatisé est requis.

**Remarque :** Assurez-vous que le réseau est configuré sur un domaine et non sur un groupe de travail. Vous pouvez même associer le script à l’ensemble du domaine même si l’agent OpManager n’est installé que sur quelques appareils, car l’agent ne sera installé que sur les appareils sur lesquels il n’est pas déjà installé.

1. Dans la console web OpManager, accédez à **Paramètres → Découverte → Déployer l’agent**.
2. Cliquez sur le bouton **"Télécharger"** pour obtenir le fichier zip de l’agent OpManager. Extrayez le fichier zip et collez les fichiers extraits **OpManagerAgent.msi** et **OPMAgentServerInfo.json** dans le répertoire local.

**REMARQUE :** Il est obligatoire de télécharger une nouvelle copie du fichier OpManagerAgent.zip et d’utiliser les fichiers qu’il contient pour le processus d’installation.

3. Identifiez le ou les Server(s) de domaine parent pour les ordinateurs clients, puis copiez les fichiers extraits **OpManagerAgent.msi** et **OPMAgentServerInfo.json** sur ce ou ces Server(s) de domaine.
4. Sur le Server AD, cliquez sur **Démarrer → Exécuter**.
5. Saisissez **gpmc.msc** et cliquez sur **OK**.
6. Faites un clic droit sur le domaine, puis sélectionnez **Créer et lier un objet GPO ici**.

![Installation de l’agent OpManager sur les appareils à l’aide d’un script de démarrage : créer et lier une nouvelle fenêtre GPO](https://www.manageengine.com/network-monitoring/help/images/agent-create-and-link-gpo.jpg)

7. Spécifiez un nom pour le GPO.
8. Sélectionnez le GPO.

**Remarque :** Ces étapes doivent être suivies si vous souhaitez installer des agents uniquement sur quelques appareils sélectionnés (voir cette [image](https://www.manageengine.com/network-monitoring/help/images/agent-gpo-select-devices.jpg)). Ne suivez pas ces étapes si vous souhaitez installer des agents sur tous les appareils.

- Cliquez sur l’onglet **Portée**.
- Dans la section **Filtrage de sécurité**, cliquez sur **Ajouter**.
- Dans la boîte de dialogue **Sélectionner un utilisateur, un ordinateur ou un groupe**, cliquez sur **Types d’objets**.
- Sélectionnez des types d’objets ordinateur spécifiques, puis cliquez sur **"OK"**.
- Spécifiez les noms des ordinateurs, puis cliquez sur **"OK"**.
- Enfin, cliquez sur **Vérifier les noms**, puis cliquez à nouveau sur **"OK"**.

9. Faites un clic droit sur le GPO et cliquez sur **"Modifier"**.

10. Pour exécuter un **script VB**, suivez ces étapes (voir cette [image](https://www.manageengine.com/network-monitoring/help/images/agent-gpo-vbscript.jpg)) :

- Développez **Configuration ordinateur → Stratégies → Paramètres Windows → Scripts**.
- Faites un clic droit sur **Démarrage**, puis cliquez sur **Propriétés**.
- Cliquez sur **Afficher les fichiers**.
- Glissez-déposez le fichier [InstallOPMAgent.vbs](https://www.manageengine.com/network-monitoring/help/files/InstallOPMAgent.txt) (téléchargez le fichier .txt et renommez-le en .vbs) ainsi que les fichiers extraits **OpManagerAgent.msi** et **OPMServerInfo.json** vers cet emplacement. Copiez le chemin de cet emplacement (`\\Nom du domaine\SysVol\Nom du domaine\Policies\{ID}\Machine\Scripts\Startup`) et fermez la fenêtre.
- Dans la boîte de dialogue **Propriétés de démarrage**, cliquez sur **Ajouter**.
- Parcourez jusqu’à l’emplacement, puis copiez le chemin parcouru (`\\Nom du domaine\SysVol\Nom du domaine\Policies\{ID}\Machine\Scripts\Startup`).
- Sélectionnez le **script InstallOPMAgent.vbs**. Puis spécifiez le chemin (emplacement copié) et le script comme indiqué ci-dessous :

```
(\\Nom du domaine\SysVol\Nom du domaine\Policies\{ID}\Machine\Scripts\Startup)\InstallOPMAgent.vbs
```

- Spécifiez le paramètre du script comme indiqué ci-dessous :  
  **OpManagerAgent.msi**

11. Comme alternative au script VB, vous pouvez également exécuter un **script PowerShell** pour l’installation de l’agent à l’aide d’une GPO. Pour exécuter des scripts PowerShell, suivez ces étapes et reportez-vous à cette [image](https://www.manageengine.com/network-monitoring/help/images/agent-gpo-powershell-script.jpg)) :

- Assurez-vous que PowerShell est activé sur tous les ordinateurs clients avant l’exécution de ce script.
- Développez **Configuration ordinateur → Stratégies → Paramètres Windows → Scripts PowerShell**.
- Faites un clic droit sur **Démarrage**, puis cliquez sur **Propriétés**.
- Cliquez sur **Afficher les fichiers**.
- Glissez-déposez le fichier [psinstallopmagent.ps1](https://www.manageengine.com/network-monitoring/help/files/psinstallopmagent.txt) (téléchargez le fichier .txt et renommez-le en .ps1) ainsi que les fichiers extraits **OpManagerAgent.msi** et **OPMAgentServerInfo.json** vers cet emplacement. Copiez le chemin de cet emplacement (`\\Nom du domaine\SysVol\Nom du domaine\Policies\{ID}\Machine\Scripts\Startup`) et fermez la fenêtre.
- Dans la boîte de dialogue **Propriétés de démarrage**, cliquez sur **Ajouter**.
- Parcourez jusqu’à l’emplacement, puis copiez le chemin parcouru (`\\Nom du domaine\SysVol\Nom du domaine\Policies\{ID}\Machine\Scripts\Startup`).
- Sélectionnez le **script psinstallopmagent.ps1**. Puis spécifiez le chemin (emplacement copié) et le script comme indiqué ci-dessous :

```
(\\Nom du domaine\SysVol\Nom du domaine\Policies\{ID}\Machine\Scripts\Startup)\psinstallopmagent.ps1
```

- Spécifiez les paramètres du script comme indiqué ci-dessous :  
  **OpManagerAgent.msi**

12. Cliquez sur **"OK"** pour fermer la boîte de dialogue **Ajouter un script** et la boîte de dialogue **Propriétés de démarrage**, puis fermez également les boîtes de dialogue **Éditeur d’objet de stratégie de groupe** et **Gestion de la stratégie de groupe**.

**Remarque :** Ce script peut être utilisé pour déployer l’agent sur tous les ordinateurs du domaine. Notez que la cible ne doit pas être un groupe d’utilisateurs.

Ce script sera exécuté lors du prochain redémarrage des ordinateurs clients après le déploiement. Une fois ce script exécuté avec succès, l’agent OpManager sera installé sur tous les ordinateurs clients. Vous pouvez vérifier ces appareils nouvellement ajoutés dans la page Inventaire de OpManager.

**Remarque :**

- Les propriétés d’association de fichiers des fichiers .vbs doivent être définies sur **'Hôte de script basé sur Microsoft Windows (r)'** sur tous les ordinateurs clients, afin de garantir que le script s’exécute correctement. Si les propriétés d’association de fichiers ont été modifiées pour ouvrir le fichier script avec un éditeur de texte, l’exécution échouera.
- L’objet GPO OpManager peut être conservé tel quel afin d’installer automatiquement l’agent sur les futurs ordinateurs clients.
- Vous n’avez pas à vous soucier d’une réinstallation de l’agent, car le script a été écrit de manière à empêcher toute réinstallation inutile de l’agent.
- Vous n’avez pas non plus à vous soucier de la mise à jour périodique de l’agent. Les mises à jour de l’agent OpManager sont publiées avec les fichiers d’installation de OpManager, et OpManager transmettra automatiquement la mise à jour de l’agent aux ordinateurs clients dès qu’elle sera disponible.

L’installation de l’agent OpManager sur plusieurs appareils à l’aide de la GPO Windows peut être utile, en particulier lorsque d’autres méthodes d’installation échouent. Vous trouverez ci-dessous quelques raisons courantes des échecs d’installation de l’agent pour vous aider à identifier et résoudre le problème.

- [Accès refusé](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#access_denied)
- [Chemin réseau introuvable](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#network_path_not_found)
- [Nom d’utilisateur ou mot de passe inconnu](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#login_failure)
- [Aucun fournisseur réseau n’a accepté le chemin réseau donné](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#network_path_not_accepted)
- [Espace de stockage insuffisant pour installer l’agent](https://www.manageengine.com/network-monitoring/kb/agent-installation-errors.html#not_enough_server_storage)

Si vous avez rencontré d’autres problèmes lors de l’installation de l’agent, veuillez [contacter notre équipe d’assistance](mailto:opmanager-support@manageengine.com) afin de les résoudre.