Vous êtes déjà client NinjaOne ? Connectez-vous pour consulter d'autres guides et les dernières nouvelles.

Agent NinjaOne : Guide de suppression de l’agent

Contenu  

Cet article explique comment supprimer l'agent NinjaOne d'un point de terminaison géré.

Environnement

Agent NinjaOne

Description

Ce guide fournit des instructions pour supprimer un appareil inactif, rejeté ou archivé de la console NinjaOne et désinstaller l'agent NinjaOne. 

Commencez : Suppression de NinjaOne (NinjaOne Inc. 01:13)

Sélectionnez un sujet pour continuer :

Désinstallation à partir de l'interface NinjaOne (préférable)

Si un appareil est en ligne et se connecte à NinjaOne, la suppression d'un nœud à partir de NinjaOne déclenche une désinstallation silencieuse de l'agent NinjaOne. Lorsque vous désinstallez des appareils de NinjaOne, plusieurs options s'offrent à vous :

  • Désinstaller au niveau de l'appareil: Supprimer un appareil spécifique. L'agent NinjaOne reste installé sur tous les autres appareils de cette organisation.
  • Désinstaller à partir de la page de recherche des appareils: Supprimer un ou plusieurs appareils, quelle que soit leur organisation. L'agent NinjaOne reste installé sur tous les autres appareils de la console, quels que soient leur organisation ou leur type.
  • Désinstaller au niveau de l'organisation: Vous devez utiliser cette méthode pour les types de dispositifs Hyper-V. Vous pouvez également rejeter d'autres types d'appareils à partir de cette page, ce qui empêche les appareils sélectionnés de s'enregistrer à nouveau dans NinjaOne. NinjaOne supprime immédiatement les appareils rejetés.
Lorsqu'un appareil ou une organisation contenant des données de sauvegarde est supprimé ou rejeté dans NinjaOne, ou si NinjaOne Backup est rendu inactif pour un appareil, une organisation ou un compte, le système demandera à l'utilisateur de choisir de conserver ou de supprimer définitivement toutes les données de sauvegarde associées. Reportez-vous à NinjaOne Backup : Suppression des données des fichiers et des dossiers pour plus d'informations.

Désinstallation à partir de l'onglet Vue d'ensemble du tableau de bord de l'appareil

  1. Dans NinjaOne, accédez au tableau de bord de l'appareil que vous souhaitez retirer de la plateforme.
  2. Dans l'onglet Vue d'ensemble, cliquez sur le menu Modifier, comme le montre la figure 1.
  3. Sélectionnez Supprimer
supprimer device_nms.png
Image 1 : Supprimer un appareil NMS du tableau de bord des appareils (cliquer pour agrandir)
Vous pouvez effectuer cette action pour tous les types de dispositifs, à l'exception des machines virtuelles et des hôtes Hyper-V. Vous devez supprimer ces types de périphériques de la page de configuration de l'organisation dans la section Virtualisation de NinjaOne. La suppression de ces types de périphériques supprime l'hôte et toutes les machines virtuelles invitées. 

Désinstaller à partir de la page de recherche des appareils

Vous pouvez supprimer en masse tous les types de dispositifs, à l'exception d'Hyper-V.
  1. Cliquez sur Périphériques, cochez les cases en regard des noms de périphériques, puis cliquez sur Supprimer. Une notification apparaît pour confirmer la désinstallation.
supprimer device_multi.png
Image 2 : Supprimer plusieurs appareils (cliquer pour agrandir)

Désinstallation à partir de la page de configuration de l'organisation

Désinstallez le dispositif Hyper-V :

  1. Ouvrez l'onglet Virtualisation.
  2. Placez votre curseur sur la ligne contenant les informations sur le périphérique et cliquez sur Supprimer
org_virtualization_delete.png
Image 3 : Supprimer des périphériques Hyper-V

Rejeter des appareils et les empêcher de s'enregistrer dans NinjaOne

  1. Ouvrez l'onglet Appareils.
  2. Sélectionner le statut.
  3. Ouvrez l'onglet approprié (En attente, Approuvé ou Rejeté) pour trouver le dispositif.
  4. Cochez la case en regard du nom du périphérique, puis cliquez sur Rejeter
dispositif de rejet.png
Image 4 : Rejeter et supprimer des dispositifs (cliquer pour agrandir)

Désinstallation de NinjaOne pour une organisation tout entière

La suppression de l'organisation dans NinjaOne déclenche une désinstallation silencieuse de l'agent NinjaOne sur tous les appareils de l'organisation.

  1. Cliquez sur Tableau de bord et sélectionnez une organisation.
  2. Le tableau de bord Organisation s'affiche. Cliquez sur l'icône de la corbeille.
delete org.png
Image 5 : Supprimer une organisation (cliquer pour agrandir)
  1. Une fenêtre de confirmation s'affiche. Conservez les données de sauvegarde stockées ou supprimez-les définitivement, puis saisissez votre adresse électronique pour confirmer.
  2. Cliquez sur le bouton Supprimer pour supprimer le nœud.

Désinstallation manuelle

Les étapes ci-dessous ne sont utilisées que dans les cas où l'agent ne s'est pas enregistré ou si l'installation est corrompue.

Suppression manuelle de Windows Agent

Vous pouvez utiliser l'une des méthodes suivantes pour désinstaller NinjaOne silencieusement.

Si la prévention de la désinstallation n'est pas activée:

Utilisez la commande suivante pour terminer la désinstallation silencieuse :

"C:Program Files (x86)<NinjaInstallFolder>uninstall.exe" --mode unattended

Si la prévention de la désinstallation est activée:

Suivez les étapes suivantes pour terminer la désinstallation silencieuse :

  1. Assurez-vous que le service NinjaRMMAgent est en cours d'exécution sur l'appareil.
  2. Exécutez cette commande pour restaurer l'agent de désinstallation de l'appareil :
"C:Program Files (x86)<NinjaInstallFolder>NinjaRMMAgent.exe" -disableUninstallPrevention
  1. Exécutez la commande suivante pour effectuer la désinstallation silencieuse : 
"C:Program Files (x86)<NinjaInstallFolder>uninstall.exe" --mode unattended

Après la désinstallation:

Pour vous assurer que la suppression est complète, recherchez et supprimez les dossiers suivants :

C:Program Files (x86)<OrganizationName-Version>
C:ProgramDataNinjaRMMAgent
Il peut y avoir plusieurs dossiers pour le répertoire d'installation de NinjaOne qui se trouve dans ProgramFiles (x86) ; il est essentiel de les supprimer tous.

Vous pouvez également utiliser le script PowerShell NinjaOneAgentRemoval.ps1 disponible sur notre site Custom Script : Suppression de l'agent NinjaOne (Windows) article. Les instructions suivantes expliquent comment utiliser ce script.

Suppression de l'agent Windows à l'aide d'un script PowerShell

Vous devez exécuter le script en tant qu'administrateur.
  1. Téléchargez le script PowerShell NinjaOneAgentRemoval.ps1 à partir de notre site Custom Script : Suppression de l'agent NinjaOne (Windows) article. Ne sauvegardez pas le téléchargement sur Overdrive, car PowerShell pourrait ne pas le reconnaître à partir de cet emplacement.
  2. Ouvrez Windows PowerShell dans le menu Démarrer. Veillez à exécuter le programme en tant qu'administrateur. Si cette option n'est pas disponible à l'écran, cliquez avec le bouton droit de la souris sur l'application pour la sélectionner. 
Powershell.png
Image 6 : PowerShell → Exécuter en tant qu'administrateur (cliquer pour agrandir)
  1. Si vous n'avez pas encore défini la politique d'exécution pour autoriser l'exécution des scripts, utilisez la commande suivante :
Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
  1. Confirmez l'action si vous y êtes invité.
  2. Naviguez jusqu'au répertoire où vous avez téléchargé le script NinjaOneAgentRemoval.ps1. Utilisez la commande CD (changer de répertoire) suivie du chemin d'accès au répertoire contenant le script. Par exemple :
cd "C:/Users/MRogers/Desktop"
cd "Downloads"
  1. Utilisez la commande ci-dessous pour exécuter le script avec les options souhaitées.
.NinjaOneAgentRemoval.ps1
  1. Si un message d'erreur apparaît, tapez les commandes suivantes, en appuyant sur la touche Entrée pour chacune d'entre elles, avant de passer à l'étape 8 :
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine
Unblock-File -Path .NinjaOneAgentRemoval.ps1
  1. Autoriser l'exécution du script jusqu'à la fin de l'exécution. En fonction des actions effectuées, cette opération peut prendre plusieurs minutes.
  2. Lorsque le script est entièrement exécuté, vérifiez que l'ancien agent a été supprimé et vérifiez les messages d'erreur ou les invites qui ont pu se produire. Lorsque le script a réussi à supprimer l'ancien agent, vous pouvez installer un nouvel agent.
  3. Si vous rencontrez des problèmes au cours du processus, rassemblez autant d'informations que possible, y compris des captures d'écran des messages d'erreur, et contactez le service d'assistance de NinjaOne pour obtenir de l'aide.

suppression manuelle de l'agent macOS

Assurez-vous d'avoir supprimé tous les éléments liés à NinjaOne avant de procéder à la réinstallation. 
  1. Accédez au Finder.
  2. Sélectionnez Applications.
  3. Recherchez le dossier NinjaRMMAgent.

    Ce dossier est caché. Pour afficher le dossier, utilisez les touches Maj + Commande + Point.
  4. Sélectionnez Désinstaller. Veillez à inclure les éléments suivants dans la désinstallation :
    • networkd_settings_read_from_file Initialise les paramètres réseau en lisant directement la liste.
    • default 09:15:44.324203+1000 ninjarmm-macagent-patcher Received configuration update from daemon (initial).
    • default 09:15:44.328373+1000 ninjarmm-macagent-patcher UNIX error exception: 17. 

Vous pouvez également utiliser le script NinjaOneAgentRemovalmacOS.sh disponible sur notre site Custom Script : Suppression de l'agent NinjaOne (macOS) article. Vous devez exécuter le script en tant que root.

Emplacement des services du système

Utilisez les services système ci-dessous pour que l'agent NinjaOne télécharge le certificat :

/Library/LaunchAgents/com.ninjarmm.trayicon.plist
/Library/LaunchDaemons/com.ninjarmm.agentd.plist
/Library/LaunchDaemons/com.ninjarmm.patcher.plist

Suppression manuelle de Linux Agent

Changez de répertoire et allez dans /opt/NinjaRMMAgent/programfiles/ et exécutez l'une des commandes suivantes :

sudo ./ninja-deb-uninstall.sh
sudo ./ninja-deb-harakiri.sh
sudo ./ninja-rpm-uninstall.sh
Si l'agent Linux doit être réinstallé après avoir été retiré et qu'il échoue avec l'erreur "sub-process /usr/bin/dpkg returned an error code (1)", exécutez ce qui suit pour effacer tous les fichiers de l'agent dans le répertoire /tmp afin de permettre une nouvelle installation :
sudo mv /var/lib/dpkg/info/<packagename.*> /tmp

Prévention de la désinstallation de l’agent NinjaOne

Lorsque la prévention de désinstallation de NinjaOne est activée, la suppression d'un périphérique de la console NinjaOne en suivant les étapes ci-dessus désinstalle toujours avec succès l'agent NinjaOne lorsque le périphérique est en ligne et connecté à NinjaOne. Cette procédure est la méthode de désinstallation recommandée. Pour plus d'informations, reportez-vous à la section Prévention de la désinstallation de NinjaOne

Si une désinstallation manuelle est nécessaire (par exemple, un appareil est hors ligne et ne se connecte pas à NinjaOne), mais que la prévention de désinstallation est activée, utilisez l'une des procédures de désinstallation manuelle décrites dans la section Suppression manuelle de l'agent Windows de cet article.

Pour en savoir plus sur la désinstallation des composants des intégrations optionnelles de NinjaOne (telles que TeamViewer, Splashtop, Webroot ou Cloudberry), reportez-vous à la section Désinstallation des composants intégrés.

Ressources supplémentaires :

Consultez les articles suivants pour en savoir plus sur le travail avec l'agent NinjaOne :

FAQ

Pour aller plus loin