Désinstaller les agents

Il existe plusieurs méthodes pour désinstaller un agent. Vous devez disposer des droits d'administration et l'action doit aussi être autorisée dans la configuration du groupe d'agents, sauf pour la méthode via challenge. Pour plus d'informations, reportez-vous à la section Autoriser les administrateurs à désinstaller les agents.

  • Pour désinstaller plusieurs agents via GPO, MECM (ex SCCM), etc., lancez l'exécutable EsSetupWorker.exe situé dans le répertoire_d'installation\SES Evolution\Agent\Bin. Par défaut, le répertoire d'installation est C:\Program Files.
  • Pour désinstaller un agent d'un poste de travail individuel, utilisez le menu Désinstaller dans les Programmes et fonctionnalités du Panneau de configuration de Windows. C'est le programme EsSetup.exe qui sera lancé. Pour connaître les options de ce programme si vous souhaitez l'utiliser dans un script, reportez-vous à la section Utiliser la commande EsSetup.
  • Pour désinstaller un agent sans les droits d'administration grâce aux challenges, reportez-vous à la section Résoudre les problèmes avec les challenges.
  • Si aucune des méthodes ci-dessus ne fonctionne, vous pouvez forcer la désinstallation avec l'outil AgentRemovalTool.exe. Reportez-vous à la section ci-dessous pour utiliser l'outil.

Dans tous les cas, la désinstallation n'est effective qu'après redémarrage du poste de travail. Tous les fichiers liés à l'agent sont supprimés sauf la clé de registre HKEY_LOCAL_MACHINE\Software\Stormshield\SES Evolution qui contient l'identifiant unique de l'agent pouvant être réutilisé lors d'une installation future.

Le fichier de log de la désinstallation est aussi conservé dans le dossier temporaire de l'utilisateur ayant effectué la désinstallation de l'agent.

La commande EsSetup permet de désinstaller ou réparer l'agent SES Evolution. Les options de cette commande sont les suivantes :

/silent ou /sPermet de ne pas afficher la barre de progression lors de la désinstallation ou réparation de l'agent.
/Repair Provoque une vérification de l’intégrité, et une réparation de l’agent.
/Log <chemin>Spécifie le chemin du fichier de log de l'agent.
/NewAgentId

Supprime les données de communication de l'agent avec le gestionnaire d'agents : identifiant unique, certificats utilisés en interne, identifiant et données privées pour les challenges. L'agent récupère de nouvelles données à sa prochaine connexion au gestionnaire d'agents.

Utilisée sans les options/Repair ou /NewAgentId, cette commande désinstalle l'agent SES Evolution.

La commande EsSetupWorker exécute les mêmes options que EsSetup sans interface graphique. Elle est à privilégier pour les opérations via GPO, SCCM, etc. Elle dispose des mêmes options que EsSetup à l'exception de -Silent.

Si les méthodes de désinstallation standard ne fonctionnent pas, téléchargez l'outil AgentRemovalTool.exe sur votre espace client MyStormshield (versions 32 et 64 bits disponibles dans la rubrique Téléchargements > Stormshield Endpoint Security > Evolution > Tools). L'outil, en ligne de commande, vous permet de forcer la désinstallation de l'agent sur un poste via le mode sans échec de Windows.

Pour forcer la désinstallation d'un agent, suivez la procédure ci-dessous. Vous devez répéter l'opération deux fois :

  • La première fois en mode sans échec de Windows,

  • La deuxième fois en mode démarrage normal de Windows.

Les droits d'administration sont nécessaires pour exécuter l'outil.

  1. Démarrez le poste de travail en mode sans échec.

  2. Si besoin, affichez l'aide avec la commande AgentRemovalTool.exe --help.

  3. Assurez-vous que l'outil détecte la bonne version de l'agent installée sur le poste avec la commande AgentRemovalTool.exe --supported-versions.

  4. Exécutez la commande AgentRemovalTool.exe --remove pour lancer la désinstallation.
    Outil de désinstallation en mode sans échec

  5. Choisissez le menu numéro 1. Le menu numéro 2 n'est pas disponible en mode sans échec.

  6. Démarrez ensuite le poste de travail en "mode standard".

  7. Exécutez de nouveau la commande AgentRemovalTool.exe --remove.
    Outil de désinstallation en mode standard

  8. Choisissez le menu numéro 2. Le menu numéro 1 n'est pas disponible en "mode standard".
    À l'issue de ces étapes, l'agent est correctement désinstallé.

  9. Choisissez le menu 3 pour quitter l'outil.

Les commandes suivantes sont également disponibles, en mode sans échec et en "mode standard" :

  • Si l'outil ne peut pas détecter la version de l'agent installée, la commande AgentRemovalTool.exe --remove --agent-version "2.3.2.0" permet d'indiquer la version à supprimer.

  • La commande AgentRemovalTool.exe --remove --force permet de forcer la relance de la désinstallation si celle-ci a échoué une première fois avec l'outil.