Thema
Diese Dokumentation beschreibt die ninjarmm-cli-Komponente „“ für Windows-, Mac- und Linux-Geräte.
Umgebung
- NinjaOne Endpoint Management
- NinjaOne-Dokumentation
- Microsoft Windows
- macOS
- Linux
Beschreibung
Diese Datei ist eine ausführbare Datei, mit der Sie über die Befehlszeilenschnittstelle (CLI), das Terminal oder benutzerdefinierte Skripte auf bestimmte benutzerdefinierte Felder und NinjaOne-Dokumentationsdaten zugreifen und mit diesen interagieren können. Weitere Informationen finden Sie unter „Verwenden der Befehlszeilenschnittstelle (CLI) in NinjaOne“ und „Erste Schritte mit der NinjaOne-Automatisierungsbibliothek (Skripting)“.
Wählen Sie eine Kategorie aus, um mehr zu erfahren:
Über CLI-unterstützte Felder
Beachten Sie bei der Verwendung von CLI-unterstützten Feldern Folgendes:
- Verwenden Sie die 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.
- Weitere Informationen zu benutzerdefinierten Feldern finden Sie unter „Einrichtung benutzerdefinierter Felder“. Weitere Details finden Sie unter „Einrichtung benutzerdefinierter Felder “.
- Weitere Informationen zu Dokumentationsfeldern finden Sie unter NinjaOne-Dokumentation: Apps und Dienste.
- Das System kann Dokumentationsdaten aus der CLI oder benutzerdefinierten Skripten lesen oder in diese schreiben. Sie können eine Liste von Vorlagen, eine Liste von Dokumenten nach Vorlagenname oder -ID sowie den Wert jedes Feldes in einem Dokument abrufen.
- Über die CLI oder benutzerdefinierte Skripte sind nur Vorlagen oder Dokumente zugänglich, die mindestens ein ausgefülltes Feld enthalten. Das System zeigt keine leeren Vorlagen oder Dokumente an.
- Sie können benutzerdefinierte Skripte verwenden, die entweder in Batch oder PowerShell für Windows oder in ShellScript für macOS und Linux geschrieben sind.
- Da sich ninjarmm-cli.exe in einem geschützten Ordner befindet, auf den normale Benutzer keinen Zugriff haben, sollte jedes Skript, das diese Funktionalität nutzt, als System ausgeführt werden (oder die Berechtigungen sollten entsprechend geändert werden).
- Nur als Delegierte zugewiesene Geräte können Dokumentationsfelder über die CLI oder Skripte aktualisieren. Weitere Informationen finden Sie unter „Geräte als Dokumentationsdelegierte zuweisen “.
-
Geräte lesen den ihnen am nächsten liegenden Wert, der ihnen basierend auf der Vererbung mit folgendem Workflow zugewiesen wurde: Gerät → dem Gerät zugewiesener Endbenutzer → Gerätestandort → Geräteorganisation.
- Wenn das Vererbungsergebnis des Geräts keinen Wert enthält, erbt es den Wert vom Endbenutzer.
- Wenn das Vererbungsergebnis für den Endbenutzer keinen Wert enthält, wird der Wert vom Standort geerbt.
- Wenn das Vererbungsergebnis des Standorts keinen Wert enthält, wird der Wert von der Organisation geerbt.
- Wenn das Vererbungsergebnis für die Organisation keinen Wert enthält, bleibt das Feld leer.
Benutzerdefinierte Felder und Dokumentation Unterstützte Felder
Die folgende Tabelle gibt einen Überblick darüber, welche Felder den Zugriff über die CLI und benutzerdefinierte Skripte unterstützen.
| Feld | Lesezugriff | Schreibzugriff |
|---|---|---|
| Anhang | ✓ | X |
| Kontrollkästchen | ✓ | ✓ |
| Datum | ✓ | ✓ |
| Datum und Uhrzeit | ✓ | ✓ |
| Dezimal | ✓ | ✓ |
| Geräte-Dropdown | ✓ | X |
| Mehrfachauswahl von Geräten | ✓ | X |
| Dropdown | ✓ | ✓ |
| ✓ | ✓ | |
| Ganzzahl | ✓ | ✓ |
| IP-Adresse | ✓ | ✓ |
| Mehrzeilig | ✓ | ✓ |
| Mehrfachauswahl | ✓ | ✓ |
| Dropdown-Menü „Organisation“ | ✓ | X |
| Dropdown-Menü „Standort der Organisation“ | ✓ | X |
| Mehrfachauswahl für den Standort der Organisation | ✓ | X |
| Mehrfachauswahl für Organisation | ✓ | X |
| Telefon | ✓ | ✓ |
| Sicher | ✓* | ✓ |
| Text | ✓ | ✓ |
| Zeit | ✓ | ✓ |
| WYSIWYG | ✓ | ✓ |
| URL | ✓ | ✓ |
Zusätzliche unterstützte Funktionen
Die folgenden Informationen befassen sich mit berechneten Feldern und erweiterten Einstellungen.
Berechnete Felder
Das CLI-Tool unterstützt berechnete Felder, mit denen Sie Werte anzeigen können, die automatisch aus anderen Daten generiert werden. Sie können beispielsweise Folgendes tun:
> 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
„“ firstfieldauf den Wertvon „“ secondfield, indem wir in der Set-Operation die speziellen Symbole__ firstfield__verwenden.Erweiterte Einstellungen
Das CLI-Dienstprogramm unterstützt erweiterte Einstellungen, die bei der Konfiguration der verschiedenen Felder definiert werden können. Sie können beispielsweise Bereiche für Ganzzahlen, Dezimalzahlen, Datumsangaben, Datums- und Zeitangaben sowie Zeitangaben definieren.
Weitere Ressourcen
Weitere Informationen zu benutzerdefinierten Feldern und Automatisierung in NinjaOne finden Sie in den folgenden Ressourcen: