Thema
Diese Dokumentation beschreibt die ninjarmm-cli-Komponente „“ für Windows-, Linux- und Mac-Geräte.
Umgebung
- NinjaOne Endpunkt-Management
- NinjaOne Documentation
- Microsoft Windows
- macOS
- Linux
Beschreibung
Bei dieser Datei handelt es sich um eine ausführbare Datei, mit der Sie über die Befehlszeilenschnittstelle (CLI), das Terminal oder benutzerdefinierte Skripte auf bestimmte benutzerdefinierte Felder und Daten der NinjaOne-Dokumentation zugreifen und mit diesen interagieren können. Weitere Informationen finden Sie unter „Verwendung 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 folgende Punkte:
- Verwenden Sie die CLI, um die Asset-ID des Geräts auf einen beliebigen unterstützten Wert einzustellen.
- Sichere Felder sind für NinjaOne Documentation-Felder nur zum Schreiben zugänglich.
- Weitere Informationen zu benutzerdefinierten Feldern finden Sie unter „Benutzerdefinierte Feld Einrichtung“. Weitere Details finden Sie unter „Benutzerdefinierte Feld Einrichtung “.
- Mehr über Dokumentfelder erfahren Sie unter „NinjaOne-Dokumentation: Anwendungen und Dienstleistungen“.
- Das System kann Dokumentationsdaten aus der CLI oder benutzerdefinierten Skripten lesen oder dort schreiben. Sie können eine Liste der Vorlagen, eine Liste der Dokumente nach Vorlagenname oder --ID sowie den Wert jedes Feldes in einem Dokument abrufen.
- Über die CLI oder benutzerdefinierten Skripte sind nur Vorlagen oder Dokumente zugänglich, die mindestens ein ausgefülltes Feld enthalten. Leere Vorlagen oder Dokumente werden vom System nicht angezeigt.
- 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 Geräte, die als Delegierte zugewiesen sind, 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 zugewiesen wurde, wobei folgender Workflow gilt: Gerät → dem Gerät zugewiesener Endbenutzer → Standort des Geräts → Organisation des Geräts.
- Wenn das Vererbungsergebnis des Geräts keinen Wert enthält, erbt es den Wert vom Endbenutzer.
- Wenn das Vererbungsergebnis für den Endnutzer keinen Wert enthält, wird der Wert vom Standort vererbt.
- 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 Zugang über die CLI und benutzerdefinierte Skripte unterstützen.
| Feld | Lesezugang | Schreibzugang |
|---|---|---|
| Anhang | ✓ | X |
| Kontrollkästchen | ✓ | ✓ |
| Datum | ✓ | ✓ |
| Datum und Uhrzeit | ✓ | ✓ |
| Dezimal | ✓ | ✓ |
| Geräte-Dropdown | ✓ | X |
| Geräte-Multiselect | ✓ | X |
| Drop-down | ✓ | ✓ |
| ✓ | ✓ | |
| Ganze Zahl | ✓ | ✓ |
| IP-Adresse | ✓ | ✓ |
| Mehrzeilig | ✓ | ✓ |
| Mehrfachauswahl | ✓ | ✓ |
| Dropdown-Menü „Organisation“ | ✓ | X |
| Dropdown-Menü „Standort der Organisation“ | ✓ | X |
| Multiselect Organisation Location | ✓ | X |
| Organisations-Multiselect | ✓ | X |
| Telefon | ✓ | ✓ |
| Password | ✓* | ✓ |
| Text | ✓ | ✓ |
| Zeit | ✓ | ✓ |
| WYSIWYG | ✓ | ✓ |
| URL | ✓ | ✓ |
Zusätzlich unterstützte Funktionalitäten
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
„“ („firstfield“) auf den Wertvon „“ („secondfield“) ein, indem wir bei 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. So können Sie beispielsweise Bereiche für Ganzzahlen, Dezimalzahlen, Datumsangaben, Datums- und Uhrzeit-Angaben sowie Uhrzeit-Angaben festlegen.
Zusätzliche Ressourcen
Weitere Informationen zu benutzerdefinierten Feldern und zur Automatisierung in NinjaOne finden Sie in den folgenden Ressourcen: