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

Command Line Interface (CLI) Unterstützte Felder und Funktionsweise

Thema

Diese Dokumentation beschreibt die Komponente ninjarmm-cli für Windows-, Mac- und Linux-Geräte.

Umgebung

  • NinjaOne Endpunkt-Verwaltung
  • NinjaOne Documentation
  • Windows 
  • MacOS
  • Linux

Beschreibung

Diese Datei ist eine ausführbare Datei, die Sie verwenden können, um auf bestimmte benutzerdefinierte Felder und Daten der NinjaOne-Dokumentation über die Befehlszeilenschnittstelle (CLI), das Terminal oder benutzerdefinierte Skripte zuzugreifen und mit ihnen zu interagieren. Siehe Befehlszeilenschnittstelle (CLI) in NinjaOne verwenden und Erste Schritte mit der NinjaOne Automatisierungsbibliothek (Skripting).

Wählen Sie eine Kategorie, um mehr zu erfahren: 

Über CLI-unterstützte Felder

Beachten Sie diese Überlegungen, wenn Sie CLI-unterstützte Felder verwenden:

  • Verwenden Sie CLI, um die Asset-ID des Geräts auf einen beliebigen unterstützten Wert zu setzen. 
  • Sichere Felder sind für NinjaOne-Dokumentationsfelder schreibgeschützt. 
  • Das System kann Dokumentationsdaten aus der CLI oder aus benutzerdefinierten Skripten lesen oder in diese schreiben. Sie können eine Liste von Vorlagen, eine Liste von Dokumenten nach Vorlagenname oder ID und den Wert jedes Feldes in einem Dokument erhalten.
    • Nur Vorlagen oder Dokumente mit mindestens einem ausgefüllten Feld sind über die CLI oder benutzerdefinierte Skripte zugänglich. Das System zeigt keine leeren Vorlagen oder Dokumente an.
  • Sie können benutzerdefinierte Skripts verwenden, die entweder in Batch oder PowerShell für Windows oder in ShellScript für macOS und Linux geschrieben wurden.
    • Da sich ninjarmm-cli.exe in einem geschützten Ordner befindet, der für normale Benutzer unzugänglich ist, sollte jedes Skript, das diese Funktion verwendet, als System ausgeführt werden (oder die Berechtigungen sollten entsprechend geändert werden).
  • Nur Geräte, die als Delegierte zugewiesen sind, können Dokumentationsfelder über CLI oder Skripte aktualisieren. Weitere Informationen finden Sie unter Zuweisung von Geräten als Dokumentationsdelegierte
  • Geräte lesen den nächstgelegenen Wert, der ihnen aufgrund der Vererbung mit dem Arbeitsablauf von zugeordnet ist: Gerät → dem Gerät zugewiesener Endnutzer → Gerätestandort → Geräteorganisation. 
    • Wenn das Vererbungsergebnis des Geräts keinen Wert hat, erbt es den Wert vom Endbenutzer. 
    • Wenn das Vererbungsergebnis für den Endbenutzer keinen Wert hat, erbt er den Wert vom Standort. 
    • Wenn das Vererbungsergebnis des Standorts keinen Wert hat, erbt er den Wert von der Organisation. 
    • Wenn das Ergebnis der Vererbung für die Organisation keinen Wert hat, bleibt das Feld leer.

Benutzerdefinierte Felder und Dokumentation Unterstützte Felder

In der folgenden Tabelle ist aufgeführt, welche Felder den Zugriff über CLI und benutzerdefinierte Skripts unterstützen.

FeldZugang lesenSchreibzugriff
AnhangX
Kontrollkästchen
Datum
Datum und Uhrzeit
Dezimalzahl
Dropdown-Menü GerätX
Geräte-MehrfachauswahlX
Dropdown-Menü
E-Mail
Ganze Zahl
IP-Adresse
Mehrzeilig
Mehrfachauswahl
Dropdown-Menü OrganisationX
Dropdown-Liste "OrganisationsstandortX
Organisationsstandort-MehrfachauswahlX
Organisations-MehrfachauswahlX
Telefon
Sichern*
Text
Uhrzeit
WYSIWYG
URL 

Darüber hinaus unterstützte Funktionen

Im Folgenden werden die berechneten Felder und erweiterten Einstellungen erläutert.

Berechnete Felder

Das CLI-Tool unterstützt berechnete Felder, mit denen Sie automatisch aus anderen Daten generierte Werte anzeigen können. Sie können zum Beispiel so vorgehen:

> ninjarmm-cli.exe set firstfield myvalue
myvalue
> ninjarmm-cli.exe get firstfield
myvalue
> ninjarmm-cli.exe get secondfield
othervalue
> ninjarmm-cli.exe set secondfield __firstfield__
myvalue
> ninjarmm-cli.exe get secondfield
myvalue
Im obigen Beispiel setzen wir den Wert des Feldes erstenFeldes auf das zweiten Feldes durch die Verwendung spezieller Symbole __ erstesfeld__ in der Mengenoperation.

Erweiterte Einstellungen

Das CLI-Dienstprogramm kann erweiterte Einstellungen vornehmen, die bei der Konfiguration der verschiedenen Felder festgelegt werden können. Sie können zum Beispiel Bereiche für ganze Zahlen, Dezimalzahlen, Datumsangaben, Datums- und Zeitangaben sowie Zeitangaben definieren. 

Zusätzliche Ressourcen:

Lesen Sie die folgenden Ressourcen, um mehr über benutzerdefinierte Felder und Automatisierung in NinjaOne zu erfahren:

 

FAQ

Nächste Schritte