Sei già un cliente NinjaOne? Effettua il login per visualizzare le altre guide e gli ultimi aggiornamenti.

Funzionalità e campi supportati della CLI (Command Line Interface)

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. 
  • 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.

CampoAccesso in letturaAccesso 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✓✓
Email✓✓
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
Nell’esempio sopra riportato, abbiamo impostato il valore difirstfield 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:

Domande frequenti

Passi successivi