Interface en ligne de commande (CLI) :

L'interface de ligne de commande (CLI) de NinjaOne est un outil performant qui vous offre pratiquement les mêmes fonctionnalités et propriétés visuelles que si vous utilisiez cmd.exe sous Windows (ou Terminal sous macOS). Nous avons également la possibilité de lancer PowerShell à distance sur des appareils Windows !

Pour en savoir plus sur le composant ninjarmm-clipour les appareils Windows, Mac et Linux, ainsi que sur l'interaction avec les champs personnalisés, veuillez consulter les sections Champs personnalisés et Documentation : CLI et scripts.

Table des matières :

• Accorder des autorisations CLI à un technicien
• Lancer la CLI ou PowerShell sur un appareil Windows 
  • Présentation de l’utilitaire CLI sous Windows 
• Lancer la CLI (terminal) sur un appareil Mac/Linux
  • Présentation de l'utilitaire Terminal sous Mac/Linux
• Options supplémentaires de lancement du terminal 
  • Lancer la CLI/le terminal à partir de l'onglet « Recherche d'appareils »
  • Lancer l'interface CLI/Terminal depuis le tableau de bord de l'organisation
  • Lancer la session CLI/Terminal dans un onglet distinct

Attribuer des autorisations CLI à un technicien :

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, les autorisations CLI doivent être activées manuellement : 

1. Cliquez sur « Administration » dans le volet de navigation de gauche, puis sélectionnez « Comptes ». Cliquez sur le nom d'un technicien pour modifier son compte.
   
2. Ouvrez l'onglet « Appareils » et sélectionnez l'autorisation « Outils à distance ».
3. Cochez la case en regard de « Ligne de commande » pour l'activer. 
   
4. Cliquez sur « Enregistrer les modifications » pour confirmer.

Pour plus d’informations, consultez la section « Autorisations utilisateur : options d’autorisation ».

Lancer l'interface CLI ou PowerShell sur un appareil Windows :

1. Accédez à l'appareil dont vous souhaitez utiliser la CLI, puis placez le curseur sur l'icône de la CLI à distance située à droite du nom de l'appareil.

2. Vous pouvez ensuite choisir de lancer Cmd.exe ou PowerShell, et de le faire soit en tant que « Système » (qui s'exécute en tant qu'utilisateur « localsystem »), soit en tant qu'utilisateur actuellement connecté. D'autres options permettent de lancer la connexion en mode 32 bits ou 64 bits.
   

   Remarque importante : vous devez vous assurer que PowerShell est installé localement sur la machine pour pouvoir le lancer depuis Ninja. Si PowerShell n’est pas installé sur votre machine, un message d’erreur s’affichera lorsque vous tenterez de vous connecter.

Présentation de l’utilitaire CLI Windows

Nous avons intégré quelques boutons d’outils utiles dans le coin supérieur droit de l’utilitaire CLI.

• Icône du clavier — vous permet d’envoyer la commande « Ctrl+C » pour interrompre l’action en cours.
• Icône «Disque » : vous permet d’exporter le contenu du terminal vers un fichier txt.
• Icône «Dupliquer » : vous permet de copier le contenu dans le presse-papiers.
• Icône « X »: ferme cmd.exe sur le nœud.

La sélection de n'importe quel texte dans l'utilitaire CLI le copie automatiquement dans le presse-papiers !

Depuis la version 4.4, notre outil CLI inclut les nouvelles fonctionnalités suivantes :

• Exécuter n’importe quel shell interactif (s’il est installé sur le PC), tel que cmd.exe, powershell.exe (ou pwsh.exe), bash.exe, psql.exe, python.exe et autres.
• Exécuter des scripts dans les shells :
  • Copier-coller des scripts dans powershell.exe, bash.exe ou python.exe.
  • Copier-coller du code SQL dans psql.exe.
• Lancer et utiliser WSL (sous-système Windows pour Linux) pour accéder à une distribution Linux installée sous Windows. 
• Utilisez Chocolatey pour installer et désinstaller des logiciels sur votre PC.
• Travailler avec tous les shells en mode interactif complet, avec tous les événements et une pseudo-interface graphique, par exemple :
  • Lancez et affichez Far Manager.
  • Utilisez 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.
  • Utilisez les clics de souris, le défilement de la souris, les touches haut/bas et les raccourcis clavier F1 à F10 pour Far Manager et d'autres applications dotées d'une pseudo-interface graphique.

Veuillez noter les points suivants lors de l'utilisation de l'interface en ligne de commande (CLI) :

• Lorsque Cmd.exe est exécuté en tant que « Système », les commandes SFC ne s'appliquent pas au niveau de l'utilisateur (nous incluons toutefois une commande sfc /scannow dans nos scripts natifs).
• Pour utiliser une commande curl, vous devez utiliser l'option -O (par exemple : « curl -O https://url.zip »).
• Pour utiliser wget, ajoutez le paramètre « --no-check-certificate --progress=bar:force » (sans guillemets) à la fin de votre URL.
  (c'est-à-dire wget https://url/somefile.zip --no-check-certificate --progress=bar:force)

Lancer l’interface en ligne de commande (terminal) sur un appareil Mac/Linux :

1. Vous pouvez lancer le terminal distant pour Mac en utilisant la même méthode que pour un appareil Windows dans le tableau de bord Ninja. Accédez à l’appareil dont vous souhaitez accéder à l’interface CLI, puis placez votre curseur sur l’icône de l’interface CLI distante située à droite du nom de l’appareil.
2. Choisissez de lancer le Terminal ou le Terminal en tant qu’administrateur.
   

Présentation de l’utilitaire Terminal sous Mac/Linux :

Mac : 

• Icône du clavier — vous permet d'envoyer la commande « Ctrl+C » pour interrompre l'action en cours.
• Icône en forme de disque — vous permet d'exporter le contenu du Terminal vers un fichier txt.
• Icône «Dupliquer » : permet de copier le contenu dans le presse-papiers.
• Icône « X » — ferme cmd.exe sur le nœud.

Options supplémentaires de lancement du Terminal : 

Lancer l’interface CLI/Terminal à partir de la recherche 

Pour lancer l’interface CLI/Terminal à partir d’une recherche globale, saisissez le nom de l’appareil dans la barre de recherche supérieure de la console et placez votre curseur sur l’icône représentant un bouton de lecture. Ensuite, placez votre curseur sur « Outils à distance » et choisissez le type de session CLI/Terminal à lancer.

Lancer la CLI/le terminal depuis le tableau de bord de l’organisation

Pour lancer l’interface CLI/Terminal depuis le tableau de bord de l’organisation, recherchez l’appareil dans la liste de l’onglet « Aperçu » du tableau de bord de l’organisation et placez le curseur sur l’icône représentant un bouton de lecture. Ensuite, placez le curseur sur « Outils à distance » et choisissez le type de session CLI/Terminal à lancer.

Lancer la session CLI/Terminal dans un onglet distinct

1. Lancez la procédure de création d’une session CLI/Terminal à l’aide de l’une des méthodes décrites ci-dessus.
2. Lorsque vous sélectionnez le type de session à établir, cliquez sur l’icône « » (Lancer la session) plutôt que sur le texte.
   
   La session s’ouvre dans un nouvel onglet, ce qui permet d’avoir plusieurs sessions simultanées sur différents appareils.
   

Pour consulter la liste des questions fréquemment posées concernant l’interface CLI, veuillez vous reporter à la rubrique Interface de ligne de commande (CLI) : FAQ.