Argomento
Questa documentazione descrive il componente ninjarmm-cli per dispositivi Windows, Mac e Linux.
Ambiente
- Gestione degli endpoint NinjaOne
- NinjaOne Documentation
- Finestre
- MacOS
- Linux
Descrizione
Questo file è un eseguibile che può essere utilizzato per accedere e interagire con particolari campi personalizzati e dati di NinjaOne Documentation dall'interfaccia della riga di comando (CLI), dal Terminale o da script personalizzati. Consultare Utilizzo dell'interfaccia della riga di comando (CLI) in NinjaOne e Introduzione alla libreria di automazione di NinjaOne (Scripting).
Selezionate una categoria per saperne di più:
Informazioni sui campi supportati dalla CLI
Tenere presente queste considerazioni quando si utilizzano i campi supportati dalla CLI:
- Utilizzare l'interfaccia CLI per impostare l'ID risorsa del dispositivo su qualsiasi valore supportato.
- I campi protetti sono di sola scrittura per i campi della Documentazione NinjaOne.
- Per ulteriori informazioni sui campi personalizzati, consultare la sezione Impostazione dei campi personalizzati. Per ulteriori dettagli, consultare la sezione Impostazione dei campi personalizzati.
- Per saperne di più sui campi della documentazione, consultare Documentazione di NinjaOne: Applicazioni e servizi.
- Il sistema può leggere o scrivere dati di documentazione dalla CLI o da script personalizzati. È possibile ottenere un elenco di modelli, un elenco di documenti per nome o ID del modello e il valore di ciascun campo di un documento.
- Solo i modelli o i documenti con almeno un campo compilato sono accessibili tramite la CLI o gli script personalizzati. Il sistema non visualizza modelli o documenti vuoti.
- È possibile utilizzare script personalizzati scritti in Batch o PowerShell per Windows, o in ShellScript per macOS e Linux.
- Poiché ninjarmm-cli.exe risiede in una cartella protetta inaccessibile agli utenti normali, qualsiasi script che utilizzi questa funzionalità deve essere eseguito come sistema (o i permessi devono essere modificati di conseguenza).
- Solo i dispositivi assegnati come delegati possono aggiornare i campi della documentazione tramite CLI o script. Per ulteriori informazioni, consultare Assegnazione di dispositivi come delegati alla documentazione.
- I dispositivi leggono il valore più vicino a loro impostato in base all'ereditarietà con il flusso di lavoro di: Dispositivo → utente finale assegnato al dispositivo → ubicazione del dispositivo → organizzazione del dispositivo.
- Se l'esito dell'ereditarietà del dispositivo non ha un valore, erediterà il valore dall'utente finale.
- Se l'esito dell'ereditarietà per l'utente finale non ha un valore, erediterà il valore dalla posizione.
- Se l'esito dell'ereditarietà del luogo non ha un valore, erediterà il valore dall'organizzazione.
- Se il risultato dell'eredità per l'organizzazione non ha valore, il campo rimarrà vuoto.
Campi personalizzati e documentazione Campi supportati
La tabella seguente indica quali campi supportano l'accesso tramite CLI e script personalizzati.
| Campo | Leggi l'accesso | Accesso in scrittura |
|---|---|---|
| Allegati | ✓ | X |
| Casella di controllo | ✓ | ✓ |
| Data | ✓ | ✓ |
| Data e ora | ✓ | ✓ |
| Decimale | ✓ | ✓ |
| Dispositivo a discesa | ✓ | X |
| Selezione multipla di dispositivi | ✓ | X |
| Menu a discesa | ✓ | ✓ |
| ✓ | ✓ | |
| Numero intero | ✓ | ✓ |
| Indirizzo IP | ✓ | ✓ |
| Multilinea | ✓ | ✓ |
| Selezione multipla | ✓ | ✓ |
| Menu a tendina dell'organizzazione | ✓ | X |
| Menu a tendina Posizione dell'organizzazione | ✓ | X |
| Selezione multipla della posizione delle organizzazioni | ✓ | X |
| Selezione multipla delle organizzazioni | ✓ | X |
| Telefono | ✓ | ✓ |
| Protetti | ✓* | ✓ |
| Testo | ✓ | ✓ |
| Ora | ✓ | ✓ |
| WYSIWYG | ✓ | ✓ |
| URL | ✓ | ✓ |
Funzionalità aggiuntiva supportata
Le seguenti informazioni riguardano i campi calcolati e le impostazioni avanzate.
Campi calcolati
Lo strumento CLI supporta i campi computati, consentendo di visualizzare valori generati automaticamente da altri dati. Ad esempio, si può fare qualcosa di simile:
> 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
primo campo al valore secondo campo utilizzando i simboli speciali __ primocampo__ nell'operazione di impostazione.Impostazioni avanzate
L'utilità CLI può gestire impostazioni avanzate, che possono essere definite durante la configurazione dei diversi campi. Ad esempio, è possibile definire intervalli per numeri interi, decimali, date, date e ore e orari.
Risorse aggiuntive:
Per saperne di più sui campi personalizzati e sull'automazione in NinjaOne, consultate le seguenti risorse: