Sie sind bereits NinjaOne-Kunde? Melden Sie sich an, um weitere Leitfäden und die neuesten Updates zu sehen.

Command Line Interface (CLI)

Die Befehlszeilenschnittstelle (CLI) von NinjaOne ist ein leistungsstarkes Tool, das Ihnen weitgehend dieselben Funktionen und visuellen Eigenschaften bietet, als würden Sie „cmd.exe“ unter Windows (oder „Terminal“ unter macOS) ausführen. Außerdem können wir PowerShell auf Windows-Geräten aus der Ferne starten!

Weitere Informationen zur Komponente „ninjarmm-cli“en für Windows-, Mac- und Linux-Geräte sowie zur Arbeit mit benutzerdefinierten Feldern finden Sie unter „Benutzerdefinierte Felder“ und in der Dokumentation: „CLI und Skripting“.

Inhaltsverzeichnis:

CLI-Berechtigungen für einen Techniker erteilen:

Systemadministratoren haben standardmäßig Zugriff auf die CLI. Für andere Technikerrollen oder Techniker ohne Rolle müssen die CLI-Berechtigungen manuell aktiviert werden: 

  1. Klicken Sie im linken Navigationsbereich auf „Administration“ und wählen Sie „Konten“ aus . Klicken Sie auf den Namen eines Technikers, um dessen Konto zu bearbeiten.
    admin_accounts_.png
  2. Öffnen Sie die Registerkarte „Geräte“ und wählen Sie die Berechtigung „Remote-Tools“ aus.
  3. Aktivieren Sie das Kontrollkästchen neben „Befehlszeile“, um die Berechtigung zu aktivieren. 
    admin_account_devices_remote tools_cli.png
  4. Klicken Sie auf „Änderungen speichern“, um den Vorgang zu bestätigen.

Weitere Informationen finden Sie unter „Benutzerberechtigungen: Berechtigungsoptionen “.

Starten Sie die CLI oder PowerShell auf einem Windows-Gerät:

Wichtiger Hinweis: Die CLI ist nicht verfügbar, wenn das Gerät offline ist. 
  1. Navigieren Sie zu dem Gerät, auf dessen CLI Sie zugreifen möchten, und bewegen Sie den Mauszeiger über das Symbol für die Remote-CLI „ Screen_Shot_2019-11-06_at_1.48.14_PM.png “ rechts neben dem Gerätenamen.
  2. Anschließend können Sie wählen, ob Sie „Cmd.exe“ oder „PowerShell“ starten möchten, und beide entweder als „System“ (das als „localsystem“-Benutzer ausgeführt wird) oder als aktuell angemeldeter Benutzer starten. Es gibt zusätzliche Optionen, um die Verbindung im 32-Bit- oder 64-Bit-Modus zu starten.
    device_windows_action_CLI.png

    Wichtiger Hinweis: Sie müssen sicherstellen, dass PowerShell lokal auf dem Rechner installiert ist, um PowerShell über Ninja starten zu können. Wenn auf Ihrem Rechner kein PowerShell installiert ist, erhalten Sie beim Verbindungsversuch eine Fehlermeldung.

Übersicht über das Windows-CLI-Dienstprogramm

device_windows_action_CLI_terminal.png

Wir haben in der oberen rechten Ecke des CLI-Dienstprogramms einige nützliche Werkzeugschaltflächen integriert.

cmd2.png

  • Tastatur-Symbol – ermöglicht es Ihnen, den Befehl „Strg+C“ zu senden, um die aktuelle Aktion zu beenden.
  • Festplattensymbol – Hiermit können Sie den Inhalt des Terminals in eine TXT-Datei herunterladen.
  • Symbol „Duplizieren“ – Damit können Sie den Inhalt in die Zwischenablage kopieren.
  • „X“-Symbol – Beendet „cmd.exe“ auf dem Knoten.
tip_icon_bw.pngWenn Sie Text im CLI-Dienstprogramm markieren, wird dieser automatisch in die Zwischenablage kopiert!
Wichtige Hinweise:

Ab Version 4.4 bietet unser CLI-Tool die folgenden neuen Funktionen:

  • Ausführen beliebiger interaktiver Shells (sofern auf dem PC installiert), wie z. B. cmd.exe, powershell.exe (oder pwsh.exe), bash.exe, psql.exe, python.exe und andere.
  • Skripte innerhalb von Shells ausführen:
    • Kopieren Sie Skripte und fügen Sie sie in powershell.exe, bash.exe oder python.exe ein.
    • Kopieren Sie SQL-Befehle und fügen Sie sie in psql.exe ein.
  • WSL (Windows-Subsystem für Linux) ausführen und nutzen, um auf unter Windows installierte Linux-Distributionen zuzugreifen. 
  • Verwenden Sie Chocolatey zum Installieren und Deinstallieren von Software auf dem PC.
  • Arbeiten Sie mit allen Shells im vollständig interaktiven Modus mit allen Ereignissen und einer Pseudo-GUI, zum Beispiel:
    • Starten und Anzeigen von Far Manager.
    • Verwenden Sie Strg+C, um die Ausführung der aktuellen Aufgabe zu beenden.
      • Verwenden Sie Umschalt+Strg+C zum Kopieren.
      • Verwenden Sie Umschalt+Strg+V zum Einfügen.
    • Verwenden Sie Mausklicks, das Scrollen mit der Maus, die Auf-/Ab-Tasten sowie die Hotkeys F1–F10 für Far Manager und andere Pseudo-GUI-Anwendungen.

Bitte beachten Sie bei der Verwendung der Befehlszeile Folgendes:

  • Wenn Sie „Cmd.exe“ als System ausführen, werden SFC-Befehle nicht auf Benutzerebene ausgeführt (wir haben einen „sfc /scannow“-Befehl in unsere nativen Skripte integriert).
  • Um einen curl-Befehl zu verwenden, müssen Sie das Flag -O verwenden (z. B. „curl -O https://url.zip“).
  • Um „wget“ zu verwenden, fügen Sie den Parameter „--no-check-certificate --progress=bar:force“ (ohne Anführungszeichen) am Ende Ihrer URL ein.
    (d. h. wget https://url/somefile.zip --no-check-certificate --progress=bar:force)

Starten Sie die CLI (Terminal) auf einem Mac-/Linux-Gerät:

Wichtiger Hinweis: Die CLI ist nicht verfügbar, wenn das Gerät offline ist. 
  1. Sie können das Remote-Terminal für Mac auf dieselbe Weise wie bei einem Windows-Gerät im Ninja-Dashboard starten. Navigieren Sie zu dem Gerät, auf dessen CLI Sie zugreifen möchten, und bewegen Sie den Mauszeiger über das Remote-CLI-Symbol Screen_Shot_2019-11-06_at_1.48.14_PM.png rechts neben dem Gerätenamen.
  2. Wählen Sie aus, ob Sie das Terminal oder das Terminal als Root starten möchten.
    device_mac_action_CLI.png

Übersicht über das Mac/Linux-Terminal-Dienstprogramm:

Mac: 

device_mac_action_CLI_terminal.png

  • Tastatur-Symbol – ermöglicht es Ihnen, den Befehl „Strg+C“ zu senden, um den aktuellen Vorgang zu beenden.
  • Festplattensymbol – Hiermit können Sie den Inhalt des Terminals in eine TXT-Datei herunterladen.
  • Symbol „Duplizieren“ – ermöglicht es Ihnen, den Inhalt in die Zwischenablage zu kopieren.
  • „X“-Symbol – Beendet „cmd.exe“ auf dem Knoten.
Wichtiger Hinweis: Umdie Dateien und Ordner unter ~/Users/ imRemote-Terminal anzuzeigen, müssen Sie der Datei„ninjarmm-macagent“(die sich im versteckten Ordner „NinjaRMMAgent“ unter /Applications befindet) den vollen Festplattenzugriff gewähren. Dies kann lokal auf dem Rechner unter„Systemeinstellungen“>„Sicherheit & Datenschutz“>„Datenschutz“ vorgenommen werden.

Zusätzliche Optionen zum Starten des Terminals: 

Starten der CLI/des Terminals über die Suche 

Um die CLI/das Terminal über die globale Suche zu starten, geben Sie den Namen des Geräts in die obere Suchleiste der Konsole ein und bewegen Sie den Mauszeiger über das Symbol mit der Wiedergabetaste. Bewegen Sie den Mauszeiger anschließend über „Remote-Tools“ und wählen Sie die Art der zu startenden CLI-/Terminal-Sitzung aus.

CLI from search.png

CLI/Terminal über das Organisations-Dashboard starten

Um die CLI/das Terminal über das Organisations-Dashboard zu starten, suchen Sie das Gerät in der Liste auf der Registerkarte „Übersicht“ des Organisations-Dashboards und bewegen Sie den Mauszeiger über das Symbol mit der Wiedergabetaste. Bewegen Sie anschließend den Mauszeiger über „Remote-Tools“ und wählen Sie den Typ der zu startenden CLI-/Terminal-Sitzung aus.

CLI from org dashboard.png

Starten der CLI-/Terminal-Sitzung in einem separaten Tab

  1. Starten Sie den Vorgang zum Einrichten einer CLI-/Terminal-Sitzung mit einer der oben beschriebenen Methoden.
  2. Klicken Sie bei der Auswahl des zu erstellenden Sitzungstyps auf das Symbol „ Screen_Shot_2021-03-10_at_12.04.16_PM.png “ anstelle des Textes.
    CLI in separate tab.png
    Die Sitzung wird in einem neuen Tab gestartet, sodass mehrere Sitzungen gleichzeitig auf verschiedenen Geräten möglich sind.
    Screen_Shot_2021-03-10_at_8.33.03_AM.png
Wichtiger Hinweis: DieseFunktion steht auch Endbenutzern zur Verfügung, wenn sie CLI-/Terminal-Sitzungen auf ihren Rechnern starten.

Eine Liste häufig gestellter Fragen zur CLI finden Sie unter „Befehlszeilenschnittstelle (CLI): FAQ“.

FAQ

Nächste Schritte