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

Interface en ligne de commande (CLI) :

L'interface de ligne de commande (CLI) de NinjaOne est un outil performant qui offre globalement les mêmes fonctionnalités et la même expérience visuelle que l'exécution de Cmd.exe sous Windows ou de Terminal sous macOS. Vous pouvez également lancer PowerShell à distance sur des appareils Windows.

Pour en savoir plus sur l'du composant ninjarmm-cli pour les appareils Windows, Mac et Linux, ainsi que sur l'interaction avec les champs personnalisés, consultez les sections « Interface de ligne de commande (CLI) : Champs personnalisés » et « Scripting de la Documentation ».

Sélectionnez une rubrique pour continuer :

Attribution des autorisations CLI

Les administrateurs système ont accès à l'interface CLI par défaut. Pour les autres rôles de technicien, ou pour les techniciens sans rôle, vous devez autoriser manuellement les autorisations d'accès à l'interface CLI.

  1. Dans NinjaOne, accédez à Administration → Comptes → Rôles de technicien et sélectionnez un rôle de technicien.
CLI_NavToR_TechRomes.png
Figure 1 : Page des paramètres des rôles de technicien, affichant le chemin d’accès Administration → Comptes → Rôles de technicien (cliquez pour agrandir)
  1. Accédez à Appareils → Outils à distance, puis cliquez sur le menu déroulant Autorisé et cochez la case Ligne de commande. Une fois terminé, cliquez sur Enregistrer les modifications.
CLI_Devices_CommandLinePermish.png
Figure 2 : Appareils → Outils à distance → Autorisé (cliquez pour agrandir)

Utilisation des icônes d’utilitaires

Les icônes du menu de navigation de la fenêtre CLI, PowerShell ou Terminal vous permettent de réaliser les actions suivantes sur l’appareil :

  • Icône du clavier : vous permet d’envoyer la commande « Ctrl+C » pour terminer l’action en cours.
  • Icône « Disque » : vous permet de télécharger le contenu du terminal dans un fichier txt.
  • Icône « Dupliquer » : vous permet de copier le contenu dans le presse-papiers.
  • Icône « X » : termine Cmd.exe sur l'appareil.
CLI_Icone.png
Figure 3 : Icônes des utilitaires de l'interface CLI (cliquez pour agrandir)

Utilisation de l'interface CLI ou de PowerShell sur un appareil Windows

Lancement de la CLI ou de PowerShell

Pour lancer PowerShell depuis NinjaOne, celui-ci doit être installé localement sur votre appareil. L'accès à l'interface CLI n'est pas disponible si l'appareil est hors ligne.

  1. Sur la page « Vue d’ensemble » de l'appareil, placez votre curseur au-dessus de l'icône « CLI à distance ».
  2. Sélectionnez « CMD » ou « PowerShell » dans le menu déroulant, puis choisissez le type d'exécution approprié (« Système » (localsystem) ou « Utilisateur connecté » ) lorsque les options s'affichent. Cliquez sur l'icône à côté de votre choix pour ouvrir la session dans un nouvel onglet.
CLI_LaunchCLI_Windows.png
Figure 4 : Vue d’ensemble de l’appareil Windows → Icône « CLI à distance » et options de lancement (cliquez pour agrandir)
Le contexte de l’utilisateur connecté s’exécutant comme une invite de commande administrateur avec des privilèges élevés, les commandes telles que ` net use ` ne verront pas les lecteurs mappés dans un contexte d’utilisateur standard.

Fonctionnalités de l’outil CLI Windows

L’outil CLI inclut les fonctionnalités suivantes :

FonctionnalitéDescription
Exécuter des shells interactifsExécute n’importe lequel des shells interactifs installés sur le PC, notamment Cmd.exe, powershell.exe (ou pwsh.exe), bash.exe, psql.exe, python.exe et bien d’autres.
Exécuter des scripts dans les shellsCopiez-collez des scripts dans PowerShell.exe, bash.exe ou python.exe ; copiez-collez du code SQL dans psql.exe.
Exécuter WSLExécutez et utilisez WSL (Windows Subsystem for Linux) pour accéder à une distribution Linux installée sous Windows.
Installer et désinstaller des logicielsUtilisez Chocolatey pour installer et désinstaller des logiciels sur le PC. Consultez Chocolatey.org (lien externe) pour plus d'informations.
Utiliser les shells en mode interactif complet

Utiliser tous les shells en mode interactif complet avec prise en charge de tous les événements et d'une pseudo-interface graphique, notamment :

  • Lancer et afficher Far Manager
  • Utilisation de Ctrl+C pour interrompre l'exécution de la tâche en cours (utilisez Maj+Ctrl+C pour copier ; utilisez Maj+Ctrl+V pour coller).
  • Utilisation des clics de souris, du défilement de la souris, des touches fléchées et des raccourcis clavier (F1 à F10) pour Far Manager et d’autres applications pseudo-GUI.

Remarques concernant l’interface en ligne de commande

  • La sélection d’un texte dans l’utilitaire CLI entraîne automatiquement sa copie dans le presse-papiers.
  • Lorsque Cmd.exe est exécuté en tant que système, les commandes SFC ne s’appliquent pas au niveau utilisateur (nous incluons toutefois une commande sfc /scannow dans nos scripts natifs. Reportez-vous à NinjaOne Gestion des terminaux : Scripts d’automatisation natifs pour plus d’informations).
  • Pour utiliser une commande curl, vous devez utiliser l’option -O.
curl -O https://url.zip
  • Pour utiliser wget, ajoutez les paramètres --no-check-certificate --progress=bar:force à la fin de votre URL.
wgethttps://url/somefile.zip--no-check-certificate --progress=bar:force

Lancement de l’interface en ligne de commande (Terminal) sur un appareil Mac ou Linux

Pour afficher les fichiers et dossiers situés sous ~/Users/ dans le terminal distant, vous devez autoriser un accès complet au disque au fichier ninjarmm-macagent (qui se trouve dans le dossier masqué NinjaRMMAgent sous /Applications). Pour ce faire, rendez-vous localement sur la machine dans Préférences Système → Sécurité et confidentialité → Confidentialité.

Lancement de la CLI (Terminal)

L'interface CLI n'est pas disponible si l'appareil est hors ligne.
  1. Sur la page « Aperçu » de l'appareil, placez votre curseur sur l'icône « CLI à distance », sélectionnez « CMD » ou « PowerShell » dans le menu déroulant, puis choisissez le type d'exécution approprié (« Système » (localsystem) ou « Utilisateur connecté » ) lorsque les options s'affichent.
  2. Choisissez de lancer Terminal ou Terminal comme racine. Cliquez sur l’icône à côté de votre choix pour ouvrir la session dans un nouvel onglet.
CMD_LaunchCLI_macOS.png
Figure 5 : Vue d’ensemble de l’appareil macOS → Icône « CLI à distance » et options de lancement (cliquez pour agrandir)

Options supplémentaires de lancement du Terminal

Outre l’utilisation de la page « Vue d’ensemble » de l’appareil, vous pouvez :

  • Lancer une session de ligne de commande depuis une recherche globale.
  • Lancer une session de ligne de commande depuis le tableau de bord de l’organisation.

Lancer la CLI ou le Terminal depuis une recherche globale

Pour lancer l'interface CLI ou le terminal depuis une recherche globale :

  1. Dans NinjaOne, saisissez le nom de l'appareil dans la barre de recherche.
  2. Placez votre curseur sur le nom de l'appareil dans les résultats de recherche, puis cliquez sur l'icône « Exécuter » lorsqu'elle apparaît.
  3. Sélectionnez votre type de connexion dans le menu déroulant :
    • Windows: sélectionnez « CMD » ou « PowerShell », puis choisissez le type d'exécution approprié lorsque les options s'affichent. Cliquez sur l'icône à côté de votre choix pour ouvrir la session dans un nouvel onglet. Reportez-vous à la section « Utilisation de la CLI ou de PowerShell sur un appareil Windows » de cet article pour plus d'informations sur les types de connexion.
    • macOS ou Linux: sélectionnez « Terminal », puis choisissez « Terminal comme racine » ou « Terminal » lorsque les options s’affichent.
CLI_LaunchFormSearch_Windows.png
Figure 6 : Résultat de la recherche globale → Icône « Exécuter » → Options de lancement (cliquez pour agrandir)

Lancer l’interface CLI ou le Terminal depuis le Tableau de bord de l’organisation

Pour lancer la CLI ou le Terminal depuis le tableau de bord de l'organisation :

  1. Sur la page « Vue d’ensemble » de l’organisation, sélectionnez l’appareil, puis cliquez sur l’icône « Exécuter » lorsqu’elle s’affiche.
  2. Sélectionnez votre type de connexion dans le menu déroulant :
    • Windows: sélectionnez CMD ou PowerShell, puis choisissez le type d'exécution approprié lorsque les options s'affichent. Cliquez sur l'icône à côté de votre choix pour ouvrir la session dans un nouvel onglet. Reportez-vous à la section « Utilisation de la CLI ou de PowerShell sur un appareil Windows » de cet article pour plus d'informations sur les types de connexion.
    • macOS ou Linux: sélectionnez « Terminal », puis choisissez « Terminal comme racine » ou « Terminal » lorsque les options s’affichent.
CLI_LaunchFromOrg.png
Figure 7 : Tableau de bord de l’organisation → Icône « Exécuter » → Options de lancement (cliquez pour agrandir)

Ressources complémentaires

Pour consulter la liste des questions fréquemment posées à propos de l’interface de ligne de commande (CLI), reportez-vous à la section Interface de ligne de commande (CLI) : QUESTIONS-RÉPONSES.

FAQ

Pour aller plus loin