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

Command Line Interface (CLI)

Die Befehlszeilen-Schnittstelle (CLI) von NinjaOne ist ein robustes Tool, das weitgehend dieselbe Funktionalität und dieselbe Benutzeroberfläche bietet wie die Ausführung von „Cmd.exe“ unter Windows oder „Terminal“ unter macOS. Außerdem können Sie Powershell auf Windows-Geräten aus der Ferne starten.

Weitere Informationen zur Komponente „ninjarmm-cli“für Windows-, Mac- und Linux-Geräte sowie zur Interaktion mit Benutzerdefinierten Feldern finden Sie unter „Befehlszeilenschnittstelle (CLI): Benutzerdefinierte Felder“ und „Dokumentation: Skripting“.

Auswählen Sie ein Thema, um fortzufahren:

CLI-Berechtigungen gewähren

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

  1. Navigieren Sie in NinjaOne zu „Administration“ → „Konten“ → „Technikerrollen“ und wählen Sie eine Technikerrolle aus.
CLI_NavToR_TechRomes.png
Abbildung 1: Seite mit den Einstellungen für Techniker-Rollen, mit dem Pfad „Administration → Konten → Techniker-Rollen“ (zum Vergrößern anklicken)
  1. Navigieren Sie zu „Geräte“ → „Remote-Tools“, klicken Sie dann auf das Dropdown-Menü „Genehmigt“ und aktivieren Sie das Kontrollkästchen „Befehlszeile “. Klicken Sie anschließend auf „Änderungen speichern“.
CLI_Devices_CommandLinePermish.png
Abbildung 2: „Geräte“ → „Remote Tools“ → „Genehmigt“ (zum Vergrößern anklicken)

Die Symbolleiste wird verwendet

Über die Symbole im Navigationsmenü des CLI-, PowerShell- oder Terminal-Fensters können Sie die folgenden Aktionen auf dem Gerät durchführen:

  • Tastatur-Icon: Ermöglicht es Ihnen, den Befehl „Strg+C“ zu senden, um die aktuelle Aktion zu beenden.
  • Datenträger-Icon: Ermöglicht es Ihnen, den Inhalt des Terminals in eine TXT-Datei herunterzuladen.
  • Symbol „Duplizieren“: Ermöglicht es Ihnen, den Inhalt in die Zwischenablage zu kopieren.
  • „X“-Symbol: Beendet „Cmd.exe“ auf dem Gerät.
CLI_Icone.png
Abbildung 3: Icons des CLI-Dienstprogramms (zum Vergrößern anklicken)

Verwendung von CLI oder Powershell auf einem Windows-Gerät

Start von CLI oder Powershell

Um PowerShell über NinjaOne zu starten, muss es lokal auf Ihrem Gerät installiert sein. Der CLI-Zugang ist nicht verfügbar, wenn das Gerät offline ist.

  1. Bewegen Sie den Mauszeiger auf der Seite des Geräte-Überblicks über das Icon „Remote-CLI “.
  2. Wählen Sie „CMD“ oder „PowerShell“ aus dem Dropdown-Menü aus und wählen Sie dann den entsprechenden Ausführungstyp „System (localsystem)“ oder „Angemeldeter Benutzer“, sobald die Optionen angezeigt werden. Klicken Sie auf das Icon neben Ihrer Auswahl, um die Sitzung in einem neuen Tab zu öffnen.
CLI_LaunchCLI_Windows.png
Abbildung 4: Geräte-Überblick → Symbol „Remote-CLI“ und Start-Optionen (zum Vergrößern anklicken)
Da der Kontext des angemeldeten Benutzers wie eine Eingabeaufforderung mit Administratorrechten ausgeführt wird, werden bei Befehlen wie „net use“ keine Laufwerke angezeigt, die im Standardbenutzerkontext zugeordnet wurden.

Funktionalitäten des Windows-CLI-Tools

Das CLI-Tool enthält die folgenden Funktionalitäten:

FunktionalitätBeschreibung
Interaktive Shells ausführenFühren Sie jede auf dem PC installierte interaktive Shell aus, darunter Cmd.exe, powershell.exe (oder pwsh.exe), bash.exe, psql.exe, python.exe und andere.
Skripte in Shells ausführenKopieren 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 ausführenFühren Sie WSL (Windows Subsystem for Linux) aus und nutzen Sie es, um auf eine unter Windows installierte Linux-Distribution zuzugreifen.
Software installieren und deinstallierenVerwenden Sie Chocolatey, um Software auf dem PC zu installieren und zu deinstallieren. Weitere Informationen finden Sie auf Chocolatey.org (Externer Link).
Arbeiten mit Shells im Voll-Interaktiven Modus

Arbeiten Sie mit allen Shells im vollständig interaktiven Modus mit Unterstützung aller Ereignisse und einer Pseudo-GUI, einschließlich:

  • Far Manager ausführen und anzeigen
  • Verwenden von Strg+C zum Anhalten der Ausführung der aktuellen Aufgabe (verwenden Sie Umschalt+Strg+C zum Kopieren; verwenden Sie Umschalt+Strg+V zum Einfügen).
  • Verwenden von Mausklicks, Mausrad, Pfeiltasten und Hotkeys (F1–F10) für Far Manager und andere Pseudo-GUI-Anwendungen.

Hinweise zur Befehlszeile

  • Das Markieren von Text im CLI-Dienstprogramm führt automatisch zum Kopieren in die Zwischenablage.
  • Wenn „Cmd.exe“ als „System“ ausgeführt wird, werden SFC-Befehle nicht auf Benutzerebene ausgeführt (wir fügen in unseren nativen Skripten einen „sfc /scannow “-Befehl ein. Weitere Informationen finden Sie unter „NinjaOne Endpunkt-Management: Native Automation Scripts “.
  • Um einen curl-Befehl zu verwenden, müssen Sie das Flag -O verwenden.
curl -O https://url.zip
  • Um „wget“ zu verwenden, fügen Sie bei Ihrer URL die Parameter „--no-check-certificate“ und „--progress=bar:force“ hinzu.
wgethttps://url/somefile.zip--no-check-certificate --progress=bar:force

Start der CLI (Terminal) auf einem Mac- oder Linux-Gerät

Um die Dateien und Ordner unter ~/Users/ im Remote-Terminal anzuzeigen, müssen Sie der Datei „ninjarmm-macagent“ (die sich im verborgenen Ordner „NinjaRMMAgent“ unter /Applications befindet) den vollen Zugang zum Datenträger gewähren. Dies kann lokal auf dem Rechner unter „Systemeinstellungen“ → „Sicherheit & Datenschutz“ → „Datenschutz“ erfolgen.

Start der CLI (Terminal)

Die CLI ist nicht verfügbar, wenn das Gerät offline ist.
  1. Bewegen Sie auf der Seite des Geräte-Überblicks den Mauszeiger über das Symbol „Remote-CLI“, wählen Sie im Dropdown-Menü „CMD“ oder „PowerShell“ aus und wählen Sie dann den entsprechenden Ausführungstyp „System (localsystem)“ oder „Eingeloggter Benutzer“, sobald die Optionen angezeigt werden.
  2. Wählen Sie aus, ob Sie das Terminal oder das Terminal als Root starten möchten. Klicken Sie auf das Icon neben Ihrer Auswahl, um die Sitzung in einem neuen Tab zu öffnen.
CMD_LaunchCLI_macOS.png
Abbildung 5: Geräte-Überblick für das macOS-Gerät → Symbol „Remote-CLI“ und Startoptionen (zum Vergrößern anklicken)

Weitere Optionen zum Start des Terminals

Neben der Verwendung der Geräte-Überblick-Seite haben Sie folgende Möglichkeiten:

  • Eine Befehlszeilensitzung von der globalen Suche starten.
  • Eine Befehlszeilensitzung von dem OrganisationsDashboard starten.

Start der CLI oder des Terminals von der globalen Suche

So starten Sie die CLI oder das Terminal von der globalen Suche:

  1. Geben Sie in NinjaOne den Gerätenamen in die Suchleiste ein.
  2. Bewegen Sie den Mauszeiger über den Gerätenamen in den Suchergebnissen und klicken Sie dann auf das Icon „Ausführen“, sobald es angezeigt wird.
  3. Wählen Sie Ihren Verbindungstyp aus dem Dropdown-Menü aus:
    • Windows: Wählen Sie „CMD“ oder „PowerShell“ aus und wählen Sie dann den entsprechenden Ausführungstyp aus, sobald die Optionen angezeigt werden. Klicken Sie auf das Symbol neben Ihrer Auswahl, um die Sitzung in einem neuen Tab zu öffnen. Weitere Informationen zu Verbindungstypen finden Sie im Abschnitt „Verwendung der CLI oder PowerShell auf einem Windows-Gerät“ dieses Artikels.
    • macOS oder Linux: Auswählen „Terminal“ und anschließend „Terminal als Root “ oder „Terminal“, sobald die Optionen angezeigt werden.
CLI_LaunchFormSearch_Windows.png
Abbildung 6: Globales Suchergebnis → Symbol „Ausführen“ → Startoptionen (zum Vergrößern anklicken)

Start der CLI oder des Terminals vom OrganisationsDashboard

So starten Sie die CLI oder das Terminal über das OrganisationsDashboard:

  1. Wählen Sie auf der Seite des Organisationsüberblicks das Gerät aus und klicken Sie dann auf das Symbol „Ausführen“, sobald es angezeigt wird.
  2. Wählen Sie Ihren Verbindungstyp aus dem Dropdown-Menü aus:
    • Windows: Wählen Sie „CMD“ oder „PowerShell“ aus und wählen Sie anschließend den entsprechenden Ausführungstyp aus, sobald die Optionen angezeigt werden. Klicken Sie auf das Symbol neben Ihrer Auswahl, um die Sitzung in einem neuen Tab zu öffnen. Weitere Informationen zu Verbindungstypen finden Sie im Abschnitt „Verwenden der CLI oder PowerShell auf einem Windows-Gerät“ dieses Artikels.
    • macOS oder Linux: Wählen Sie „Terminal“ aus und wählen Sie anschließend „Terminal als Root“ oder „Terminal“ aus, sobald die Optionen angezeigt werden.
CLI_LaunchFromOrg.png
Abbildung 7: OrganisationsDashboard → Symbol „Ausführen“ → Startoptionen (zum Vergrößern anklicken)

Zusätzliche Ressourcen

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

FAQ

Nächste Schritte