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 en ligne de commande (CLI) de NinjaOne est un outil performant, qui vous permet de bénéficier de la plupart des fonctionnalités et des propriétés visuelles de cmd.exe sous Windows (ou de Terminal sous macOS). Nous vous permettons également de lancer PowerShell à distance sur les appareils Windows !

Pour en savoir plus sur le composant ninjarmm-cli pour les appareils Windows, Mac et Linux et l'interaction avec les champs personnalisés, veuillez consulter Champs Personnalisés et documentation : interface en ligne de commande (CLI) et écriture de script.

 

Table des matières :

 

Accorder des autorisations CLI à un technicien :

Les administrateurs système ont par défaut accès à la CLI. Pour les autres rôles de technicien, ou les techniciens sans rôle, les autorisations CLI doivent être activées manuellement : 

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

Veuillez consulter Autorisations utilisateur : options d'autorisation pour plus d'informations.

 

Lancer la CLI ou PowerShell sur un appareil Windows : 

Remarque importante : La CLI n'est pas disponible si l'appareil est hors ligne. 
  1. Naviguez jusqu'à l'appareil dont vous souhaitez accéder à la CLI, puis survolez l'icône d'accès à distance à la CLI Screen_Shot_2019-11-06_at_1.48.14_PM.png, à droite du nom de l'appareil.
  2. Vous pouvez ensuite choisir de lancer Cmd.exe ou Powershell, en tant que Système (qui s'exécute en tant qu' utilisateur du système local) ou en tant qu'utilisateur connecté au moment de l'action. Des options supplémentaires permettent de lancer la connexion en mode 32 bits ou 64 bits.
    device_windows_action_CLI.png
    Remarque importante : Vous devez vous assurer que PowerShell est installé localement sur la machine pour pouvoir lancer PowerShell à partir de NinjaOne. Si ce n'est pas le cas, vous recevrez une erreur lors de la tentative de connexion.

Présentation de l'utilitaire CLI de Windows

device_windows_action_CLI_terminal.png

Nous avons inclus des boutons qui vous permettront d'accéder à des outils utiles dans le coin supérieur droit de l'utilitaire CLI.

cmd2.png

  • Icône clavier : permet d'envoyer la commande « Ctrl+C » pour mettre fin à l'action en cours.
  • Icône disquette : permet de télécharger le contenu du terminal dans un fichier txt.
  • Icône dupliquer : permet de copier le contenu dans le presse-papiers.
  • icône "X" : termine cmd.exe sur le nœud.
tip_icon_bw.pngSurligner du texte dans l'utilitaire CLI le copie automatiquement dans le presse-papiers !
Remarques importantes :

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

  • Lancer n'importe quelle interface système interactive (si elle est installée sur le PC), comme cmd.exe, powershell.exe (ou pwsh.exe), bash.exe, psql.exe, python.exe et autres.
  • Exécuter des scripts dans des interfaces système :
    • Copier/coller des scripts dans powershell.exe, bash.exe ou python.exe.
    • Copier/coller du code SQL dans psql.exe.
  • Exécuter et utiliser WSL (Windows Subsystem for Linux) pour accéder à la distribution Linux installée sous Windows. 
  • Utiliser Chocolatey pour installer et désinstaller des logiciels sur votre PC.
  • Travailler avec toutes les interfaces système en mode interactif avec tous les événements et une pseudo interface graphique (GUI) :
    • Lancer et afficher Far Manager.
    • Utiliser Ctrl+C pour arrêter l'exécution de la tâche en cours.
      • Utiliser Shift+Ctrl+C pour copier.
      • Utiliser Shift+Ctrl+V pour coller.
    • Avec la souris, cliquez ou faites défiler, utilisez les touches haut/bas, les touches de raccourci F1-F10 pour Far Manager et autres applications de pseudo interface graphique.

À retenir lorsque vous utilisez la CLI :

  • Quand vous exécutez cmd.exe en tant que système, les commandes SFC ne répareront rien au niveau de l'utilisateur (nous incluons une commande sfc/scannow dans nos scripts natifs).
  • Pour utiliser une commande curl, vous devez utiliser le marqueur -O (par exemple, « curl -O https://url.zip »).
  • Pour utiliser wget, utilisez le paramètre « --no-check-certificate --progress=bar:force » (sans les guillemets) à la fin de votre URL.  
    (par exemple,  wget https://url/somefile.zip --no-check-certificate --progress=bar:force)

 

Lancer la CLI (Terminal) sur un appareil Mac/Linux :

Remarque importante : La CLI n'est pas disponible si l'appareil est hors ligne. 
  1. Vous pouvez lancer le terminal à distance pour Mac en utilisant la même méthode que pour un appareil Windows dans le tableau de bord NinjaOne. Naviguez jusqu'à l'appareil dont vous souhaitez accéder à la CLI, puis passez votre curseur sur l'icône d'accès à distance à la CLI Screen_Shot_2019-11-06_at_1.48.14_PM.png, à droite du nom de l'appareil.
  2. Choisissez de lancer Terminal ou Terminal comme racine.
    device_mac_action_CLI.png

Aperçu de l'utilitaire de terminal Mac/Linux :

Mac : 

device_mac_action_CLI_terminal.png

Linux :

device_linux_action_CLI_terminal.png

Nous avons inclus des boutons qui vous permettront d'accéder à des outils utiles dans le coin supérieur droit de l'utilitaire CLI.

cmd2.png

  • Icône clavier : permet d'envoyer la commande « Ctrl+C » pour mettre fin à l'action en cours.
  • Icône disquette : permet de télécharger le contenu du terminal dans un fichier txt.
  • Icône dupliquer : permet de copier le contenu dans le presse-papiers.
  • icône "X" : termine cmd.exe sur le nœud.
Remarque importante : Pour voir les fichiers et les dossiers sous ~/Users/ dans le terminal à distance, vous devez accorder un accès complet au fichier ninjarmm-macagent (qui se trouve dans le dossier caché NinjaRMMAgent sous /Applications). Cette opération peut être effectuée localement sur l'ordinateur, sous Préférences système > Sécurité et Confidentialité > Confidentialité.

 

Options de lancement supplémentaires pour Terminal : 

Lancer la CLI/Terminal à partir de la recherche 

Pour lancer la CLI/Terminal à partir d'une recherche générale, saisissez le nom de l'appareil dans la barre de recherche en haut de l'interface de la console et survolez l'icône du bouton de lecture. Survolez ensuite Outils à distance et choisissez le type de session CLI/Terminal à lancer.

CLI from search.png

 

Lancer la CLI/Terminal à partir du Tableau de bord de l'organisation

Pour lancer la CLI/Terminal à partir du tableau de bord de l'organisation, recherchez l'appareil depuis la liste dans l'onglet Vue d'ensemble du tableau de bord de l'organisation et survolez l'icône de lecture. Survolez ensuite Outils à distance et choisissez le type de session CLI/Terminal à lancer.

CLI from org dashboard.png

 

Lancer la session CLI/Terminal dans un onglet séparé

  1. Le processus d'ouverture d'une session CLI/Terminal est le même que celui précédemment évoqué, à une exception près :
  2. Lorsque vous sélectionnez le type de session à établir, cliquez sur l'icône Screen_Shot_2021-03-10_at_12.04.16_PM.pnget non sur le texte.
    CLI in separate tab.png
    La session est lancée dans un nouvel onglet, ce qui permet d'avoir plusieurs sessions simultanées sur différents appareils.
    Screen_Shot_2021-03-10_at_8.33.03_AM.png
Remarque importante : Cette capacité est également disponible pour les utilisateurs finaux quand ces derniers lancent des sessions CLI/Terminal sur leurs machines.

 

Pour une liste des questions fréquemment posées sur l'interface de ligne de commande, veuillez consulter CLI (interface en ligne de commande) : FAQ.

FAQ

Pour aller plus loin