> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/fr/sonar/deploy-operate/install-agent-windows.md).

# Installer l'agent sous Windows

Générez un programme d'installation Windows dans Agents › Install Agent, exécutez-le en mode interactif ou silencieux et vérifiez l'appareil dans Sysadmin.

## Ce que c'est et quand l'utiliser

**Agents › Install Agent** génère un programme d'installation pour un client et un site. Le programme d'installation enregistre l'appareil dans ce site, installe le service de l'agent SONAR et l'agent d'accès à distance, et applique les fonctionnalités facultatives que vous avez sélectionnées. Utilisez-le pour intégrer un seul appareil Windows ou quelques-uns. Pour des centaines d'appareils, réutilisez un même programme d'installation via votre outil de distribution de logiciels, ou utilisez un lien de déploiement : voir [Déployer des agents à grande échelle](https://wiki.datadike.com/fr/sonar/deploy-operate/mass-deployment.md).

## Avant de commencer

* Votre rôle dispose de l'autorisation **Install Agents** dans **Admin Center › Roles**. Sans elle, le bouton de génération reste désactivé avec le message *You don't have permission for this action*.
* Le client et le site existent, et votre rôle vous donne accès à ce site. Voir [Clients et sites](https://wiki.datadike.com/fr/sonar/administration/devices/clients-and-sites.md).
* L'appareil satisfait aux [Prérequis des appareils](https://wiki.datadike.com/fr/sonar/deploy-operate/requirements.md) : Windows 10, Windows 11 ou Windows Server 2016 et versions ultérieures, et vous disposez des droits d'administrateur local sur celui-ci.
* L'appareil peut joindre les adresses de l'API et d'accès à distance de SONAR sur 443/tcp. Voir [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md).
* Les exclusions antivirus et EDR sont en place pour `C:\Program Files\Sonar\`, `C:\Program Files\Mesh Agent\` et `C:\ProgramData\Sonar\`.

## Étapes

### Générer le programme d'installation

1. Ouvrez **Agents › Install Agent** depuis l'en-tête, ou cliquez sur **New Agent** dans la liste des appareils de **Dashboard › Sysadmin**. Le panneau **Add an agent** s'ouvre.
2. Choisissez le **Client** et le **Site**.
3. Sous **Operating system**, sélectionnez **Windows**.
4. Sous **Agent type**, sélectionnez **Workstation** ou **Server**.
5. Sous **Architecture**, sélectionnez **64-bit** ou **32-bit**, selon le système d'exploitation de l'appareil.
6. Sous **Optional features**, activez ou désactivez chaque fonctionnalité. Ce que chacune modifie sur l'appareil figure dans la référence des champs ci-dessous.
7. Sous **Installation method**, choisissez **Dynamic (.exe)**, **PowerShell** ou **Manual**.
8. Pour limiter la durée pendant laquelle le programme d'installation fonctionne, activez **Enable token expiration (hours)** et saisissez le nombre d'heures dans **Hours**.
9. Vérifiez le récapitulatif **Target** en bas du panneau, puis cliquez sur le bouton correspondant à la méthode choisie :
   * **Download Windows installer (.exe)** télécharge `sonar-<client>-<site>-<type>-<architecture>.exe` ;
   * **Get Powershell install script** télécharge `sonar-<client>-<site>-<type>.ps1` ;
   * **View manual setup instructions** ouvre la boîte de dialogue **Manual Installation**.

### Exécuter le programme d'installation Dynamic (.exe) en mode interactif

1. Copiez le fichier sur l'appareil et exécutez-le. Acceptez la demande d'élévation de privilèges.
2. Suivez les pages du programme d'installation. Vers la fin, l'agent affiche *Installation was successful! Allow a few minutes for the agent to properly display in the RMM*. Cliquez sur **OK**.
3. À la fin de l'installation, une boîte d'état **Sonar RMM** indique l'état de l'agent et de l'agent d'accès à distance.

### Exécuter le programme d'installation Dynamic (.exe) en mode silencieux

Exécutez le fichier avec `/S` depuis une invite de commandes avec élévation de privilèges ou depuis votre outil de déploiement :

```
sonar-<client>-<site>-<type>-<architecture>.exe /S
```

`/S` masque les pages du programme d'installation. Le fichier contient tous les paramètres choisis dans la console : aucun autre argument n'est donc nécessaire.

{% hint style="info" %}
Lancé depuis une session interactive, avec un utilisateur connecté, l'agent affiche malgré tout sa boîte de message finale et attend un clic sur **OK**, même avec `/S`. Les outils qui exécutent le fichier en tant que Local System en arrière-plan, comme un script de démarrage de GPO ou la plupart des outils de distribution de logiciels, n'affichent rien. Pour une exécution sans intervention dans une session utilisateur, utilisez le script PowerShell ou la commande manuelle avec `-silent`.
{% endhint %}

### Exécuter le script PowerShell

1. Copiez le fichier `.ps1` sur l'appareil.
2. Dans une fenêtre PowerShell avec élévation de privilèges, exécutez-le :

   ```
   powershell -ExecutionPolicy Bypass -File .\sonar-<client>-<site>-<type>.ps1
   ```

Le script s'arrête immédiatement avec *Sonar RMM Is Already Installed* si le service `sonarrmm` existe. Sinon, il attend que l'adresse de l'API réponde sur le 443 (jusqu'à trois tentatives, en affichant *Waiting for network*), ajoute les dossiers SONAR aux exclusions de Microsoft Defender lorsque Defender est actif, télécharge le programme d'installation, l'installe en mode silencieux et enregistre l'agent avec `-silent`, si bien qu'aucune boîte de message n'apparaît.

### Exécuter la commande manuelle

1. Dans la boîte de dialogue **Manual Installation**, cliquez sur **Download Agent** pour télécharger `sonaragent-v<version>-windows-<architecture>.exe`.
2. Cliquez sur **Copy Command Line**.
3. Sur l'appareil, ouvrez une invite de commandes avec élévation de privilèges dans le dossier qui contient le fichier téléchargé.
4. Collez la commande, ajoutez les **Optional Arguments** dont vous avez besoin (par exemple `-silent` ou `-desc "Front desk PC"`) et appuyez sur Entrée.

La commande installe le fichier téléchargé en mode silencieux, attend une dizaine de secondes, puis lance l'enregistrement de l'agent avec le client, le site, le type, le jeton et les fonctionnalités facultatives choisis dans la console.

## Ce que vous devez voir

Sur l'appareil, trois services lorsque le module de productivité est sélectionné, deux sinon :

| Nom du service             | Nom complet                | Ce que c'est                                                                                                                                                                               |
| -------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `sonarrmm`                 | Sonar Agent Service        | L'agent SONAR. Exécute `C:\Program Files\Sonar\sonarrmm.exe -m svc` en tant que Local System                                                                                               |
| `Mesh Agent`               | Mesh Agent                 | L'agent d'accès à distance, dans `C:\Program Files\Mesh Agent\`                                                                                                                            |
| `SonarProductivityService` | Sonar Productivity Service | Le module de productivité, installé uniquement lorsque **Sessions** est activé. Voir [Le module de productivité](https://wiki.datadike.com/fr/sonar/deploy-operate/productivity-module.md) |

**Sonar**, éditeur **DataDike®**, figure dans la liste des programmes installés.

Dans la console, l'appareil apparaît en quelques minutes dans **Dashboard › Sysadmin**, sous son client et son site, avec **Agent Status** **Online**.

### Ce que le programme d'installation modifie sur l'appareil

| Modification                                                                                                                                                                                                                                                                                                          | Quand                              |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| Windows Update est configuré pour ne pas installer les mises à jour automatiquement (stratégie `AUOptions` sous `HKLM\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate\AU`), afin que l'application des mises à jour soit pilotée depuis SONAR. La désinstallation de l'agent réactive les mises à jour automatiques | Toujours                           |
| Configuration de l'agent écrite dans `HKLM\SOFTWARE\Sonar`                                                                                                                                                                                                                                                            | Toujours                           |
| Délais de mise en veille, de mise en veille prolongée, d'arrêt du disque et de l'écran réglés sur jamais, action à la fermeture du capot réglée sur ne rien faire, démarrage rapide désactivé                                                                                                                         | **Disable sleep/hibernate** activé |
| Bureau à distance Windows activé, ainsi que le groupe de règles de pare-feu Bureau à distance                                                                                                                                                                                                                         | **Remote access** activé           |
| Règle de pare-feu *ICMP Allow incoming V4 echo request* ajoutée                                                                                                                                                                                                                                                       | **Ping** activé                    |
| Services de localisation de Windows activés, pour que l'agent puisse indiquer la position de l'appareil                                                                                                                                                                                                               | **Geolocation** activé             |
| Module de productivité installé en tant que `SonarProductivityService`                                                                                                                                                                                                                                                | **Sessions** activé                |

## Comment vérifier que cela a fonctionné

1. Sur l'appareil, exécutez `"C:\Program Files\Sonar\sonarrmm.exe"` sans argument. La boîte d'état **Sonar RMM** liste **Agent** et **Mesh Agent** avec leur état. Les deux doivent être en cours d'exécution. `sc query sonarrmm` donne la même réponse depuis une invite de commandes.
2. Dans la console, ouvrez **Dashboard › Sysadmin**, choisissez le client et recherchez le nom d'hôte. La ligne affiche **Agent Status** **Online**, le **Client** et le **Site** choisis, le **Type** choisi et la date du jour dans **First Seen**.
3. Sélectionnez la ligne. L'en-tête du panneau de détails affiche la version de l'agent, et aucun badge **Remote Offline** une fois l'agent d'accès à distance connecté.
4. Dans **Reports & Audits › Audits**, une entrée **Agent Install** consigne le nouvel agent avec son nom d'hôte.

## Erreurs courantes

| Symptôme                                                                                                                                                                     | Cause                                                                                                    | Correction                                                                                                                                                                        |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *This application requires a 64-bit Windows operating system.*                                                                                                               | Le programme d'installation 64 bits a été exécuté sur un Windows 32 bits                                 | Générez de nouveau le programme d'installation avec **Architecture** **32-bit**                                                                                                   |
| *Installer token has expired. Please generate a new one.*                                                                                                                    | Le programme d'installation a été généré avec **Enable token expiration (hours)** et ce délai est écoulé | Générez un nouveau programme d'installation                                                                                                                                       |
| *Old installer detected (version …). Latest version is … Please generate a new installer from the RMM*                                                                       | Le programme d'installation a été enregistré avant que la version de l'agent SONAR ne change             | Générez un nouveau programme d'installation                                                                                                                                       |
| Une boîte de message indique *Existing installation found*, avec **OK** pour la supprimer et **Cancel** pour abandonner                                                      | L'appareil a déjà un agent                                                                               | Cliquez sur **OK** pour le désinstaller, puis relancez le programme d'installation. Voir [Retirer des agents](https://wiki.datadike.com/fr/sonar/deploy-operate/remove-agents.md) |
| Une exécution silencieuse se termine immédiatement sans rien installer ; la sortie indique *Existing installation found and must be removed before attempting to reinstall.* | L'appareil a déjà un agent, ou ce qu'il en reste                                                         | Exécutez `"C:\Program Files\Sonar\uninstall.exe" /S`, puis relancez le programme d'installation                                                                                   |
| *Sonar RMM Is Already Installed* (PowerShell)                                                                                                                                | Le service `sonarrmm` existe                                                                             | Désinstallez d'abord, puis relancez le script                                                                                                                                     |
| *Unable to connect to server* (PowerShell)                                                                                                                                   | Le 443/tcp vers l'adresse de l'API est bloqué                                                            | Voir [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md)                                                                                |
| *Unable to download the mesh agent from the RMM.* ou *Failed to download mesh agent*                                                                                         | Le programme d'installation n'a pas pu obtenir l'agent d'accès à distance via l'adresse de l'API         | Vérifiez la connectivité vers l'adresse de l'API, puis relancez le programme d'installation                                                                                       |
| Le bouton de génération est désactivé                                                                                                                                        | Aucun client ou site n'est sélectionné, ou votre rôle n'a pas **Install Agents**                         | Sélectionnez les deux, ou demandez l'autorisation                                                                                                                                 |
| L'appareil est installé mais n'apparaît pas dans Sysadmin                                                                                                                    | L'agent ne parvient pas à maintenir sa connexion avec l'adresse de l'API                                 | Voir [Dépanner les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/troubleshooting.md)                                                                                  |

## Référence des champs

| Champ                               | Ce qu'il fait                                                                                                                                                    | Valeurs acceptées                              | Par défaut                           |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------ |
| **Client**                          | Client sous lequel l'appareil est enregistré                                                                                                                     | Clients auxquels votre rôle donne accès        | Premier client de la liste           |
| **Site**                            | Site sous lequel l'appareil est enregistré                                                                                                                       | Sites du client choisi                         | Premier site du client               |
| **Operating system**                | Plateforme du programme d'installation                                                                                                                           | **Windows**, **Linux**, **macOS**              | **Windows**                          |
| **Agent type**                      | Enregistre l'appareil comme poste de travail ou comme serveur. Détermine la colonne **Type** et la planification Windows Update par défaut de l'appareil         | **Workstation**, **Server**                    | **Workstation**                      |
| **Architecture**                    | Architecture de processeur du programme d'installation                                                                                                           | **64-bit**, **32-bit**                         | **64-bit**                           |
| **Sessions**                        | Installe le module de productivité, qui remonte l'activité et les sessions des utilisateurs et applique les politiques d'accès                                   | Activé, désactivé                              | Activé                               |
| **Geolocation**                     | Active les services de localisation de Windows et remonte la position de l'appareil environ une fois par heure                                                   | Activé, désactivé                              | Activé                               |
| **Remote access**                   | Active le Bureau à distance Windows sur l'appareil et ses règles de pare-feu. L'agent d'accès à distance SONAR est installé que cette option soit activée ou non | Activé, désactivé                              | Activé                               |
| **Ping**                            | Ajoute une règle de pare-feu pour que l'appareil réponde au ping (écho ICMPv4)                                                                                   | Activé, désactivé                              | Activé                               |
| **Disable sleep/hibernate**         | Empêche l'appareil de se mettre en veille ou en veille prolongée. Affiché uniquement pour **Workstation**                                                        | Activé, désactivé                              | Activé                               |
| **Installation method**             | Sortie produite par la console                                                                                                                                   | **Dynamic (.exe)**, **PowerShell**, **Manual** | **Dynamic (.exe)**                   |
| **Enable token expiration (hours)** | Lorsque cette option est activée, le programme d'installation cesse de fonctionner après le nombre d'heures saisi                                                | Activé, désactivé ; **Hours** de 1 à 999999    | Désactivé ; 24 heures à l'activation |

Les fonctionnalités facultatives sont fixées à l'installation. Pour les modifier sur un appareil, générez un nouveau programme d'installation et réinstallez l'agent.

### Arguments facultatifs de la commande manuelle

| Argument                                           | Ce qu'il fait                                                                                                                     |
| -------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `-log debug`                                       | Sortie détaillée pendant l'installation                                                                                           |
| `-silent`                                          | Aucune boîte de message pendant l'installation                                                                                    |
| `-local-mesh "C:\<folder>\meshagent.exe"`          | Installe l'agent d'accès à distance depuis un fichier local au lieu de le télécharger                                             |
| `-meshdir "C:\Program Files\<company>\Mesh Agent"` | Dossier d'un agent d'accès à distance déjà installé avec une image de marque personnalisée                                        |
| `-nomesh`                                          | N'installe pas l'agent d'accès à distance. Le contrôle à distance n'est alors pas disponible sur l'appareil                       |
| `-cert "C:\<folder>\ca.pem"`                       | Utilise une autorité de certification du domaine                                                                                  |
| `-desc "<text>"`                                   | Définit la **Description** de l'appareil                                                                                          |
| `-proxy "http://proxyserver:port"`                 | Utilise un proxy HTTP. Voir [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md#proxies) |

## Pages associées

* [Déployer des agents à grande échelle](https://wiki.datadike.com/fr/sonar/deploy-operate/mass-deployment.md)
* [Prérequis des appareils](https://wiki.datadike.com/fr/sonar/deploy-operate/requirements.md)
* [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md)
* [Le module de productivité](https://wiki.datadike.com/fr/sonar/deploy-operate/productivity-module.md)
* [Dépanner les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/troubleshooting.md)
