Argomento
Questa documentazione descrive il componente ninjarmm-cliper dispositivi Windows, Linux e Mac.
Ambiente
- Endpoint management NinjaOne
- NinjaOne Documentation
- Microsoft Windows
- macOS
- Linux
Descrizione
Questo file è un eseguibile che è possibile utilizzare per accedere e interagire con specifici campi personalizzati e dati della documentazione di NinjaOne dall'interfaccia della riga di comando (CLI), dal Terminale o tramite script personalizzati. Fare riferimento alle sezioni "Utilizzo dell'interfaccia della riga di comando (CLI) in NinjaOne" e "Introduzione alla Libreria delle automazioni di NinjaOne (scripting)".
Seleziona una categoria per ulteriori informazioni:
Informazioni sui campi supportati dalla CLI
Mantieni presente quanto segue quando utilizzi i campi supportati dalla CLI:
- Utilizzare la CLI per impostare l'ID risorsa del dispositivo su qualsiasi valore supportato.
- I campi protetti sono di sola scrittura per i campi della NinjaOne Documentation.
- Per altre informazioni sui campi personalizzati, consultare la sezione Impostazione del campo personalizzato. Per ulteriori dettagli, consultare la sezione Impostazione del campo personalizzato.
- Per ulteriori informazioni sui campi della documentazione, consultare " NinjaOne Documentation: App e servizi".
- Il sistema è in grado di leggere i dati della documentazione dalla CLI o dagli script personalizzati, oppure di scriverli su di essi. È possibile ottenere un elenco di modelli, un elenco di documenti in base al nome o all’ID del modello e il valore di ciascun campo in 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, oppure 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 (oppure è necessario modificare le autorizzazioni di conseguenza).
- Solo i dispositivi assegnati come delegati possono aggiornare i campi della documentazione tramite CLI o script. Per ulteriori informazioni, consultare la sezione Assegnazione dei dispositivi come delegati per la documentazione.
- I dispositivi leggono il valore più vicino loro assegnato in base all’ereditarietà con il flusso di lavoro: Dispositivo → utente finale assegnato al dispositivo → posizione del dispositivo → organizzazione del dispositivo.
- Se il risultato dell’ereditarietà del dispositivo non ha un valore, il dispositivo erediterà il valore dall’utente finale.
- Se il risultato dell’ereditarietà per l’utente finale non ha un valore, erediterà il valore dalla posizione.
- Se il risultato dell’ereditarietà della sede non ha un valore, il dispositivo erediterà il valore dall’organizzazione.
- Se il risultato dell’ereditarietà per l’organizzazione non ha un valore, il campo rimarrà vuoto.
Campi personalizzati e Documentazione Campi supportati
La tabella seguente illustra quali campi supportano l’accesso tramite CLI e script personalizzati.
| Campo | Accesso in lettura | Accesso in scrittura |
|---|---|---|
| Allegato | ✓ | X |
| Casella di controllo | ✓ | ✓ |
| Data | ✓ | ✓ |
| Data e ora | ✓ | ✓ |
| Decimale | ✓ | ✓ |
| Menu a discesa dei dispositivi | ✓ | X |
| Selezione multipla dispositivi | ✓ | X |
| Menu a discesa | ✓ | ✓ |
| ✓ | ✓ | |
| Numero intero | ✓ | ✓ |
| Indirizzo IP | ✓ | ✓ |
| Multilinea | ✓ | ✓ |
| Selezione multipla | ✓ | ✓ |
| Menu a discesa "Organizzazione" | ✓ | X |
| Menu a discesa "Posizione dell'organizzazione" | ✓ | X |
| Selezione multipla posizioni dell'organizzazione | ✓ | X |
| Selezione multipla organizzazioni | ✓ | X |
| Telefono | ✓ | ✓ |
| Sicurezza | ✓* | ✓ |
| Testo | ✓ | ✓ |
| Ora | ✓ | ✓ |
| WYSIWYG | ✓ | ✓ |
| URL | ✓ | ✓ |
Funzionalità aggiuntive di supporto
Le informazioni seguenti riguardano i campi calcolati e le impostazioni avanzate.
Campi calcolati
Lo strumento CLI supporta i campi calcolati, consentendo di mostrare valori generati automaticamente da altri dati. Ad esempio, è possibile eseguire operazioni come queste:
> 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 susecondfield utilizzando i simboli speciali__firstfield__nell’operazione di impostazione.Impostazioni avanzate
L’utilità CLI è in grado di 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 sole ore.
Risorse aggiuntive
Per ulteriori informazioni sui campi personalizzati e sull’automazione in NinjaOne, consultare le seguenti risorse: