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, Mac e Linux.

Ambiente

  • Gestione degli endpoint NinjaOne
  • Documentazione NinjaOne
  • Microsoft Windows 
  • macOS
  • Linux

Descrizione

Questo file è un eseguibile che puoi utilizzare per accedere e interagire con particolari campi personalizzati e dati della documentazione NinjaOne dall'interfaccia della riga di comando (CLI), dal Terminale o tramite script personalizzati. Consulta Utilizzo dell'interfaccia della riga di comando (CLI) in NinjaOne e Introduzione alla libreria di automazione di NinjaOne (Scripting).

Seleziona una categoria per saperne di più: 

Informazioni sui campi supportati dalla CLI

Tenere presenti queste considerazioni quando si utilizzano i campi supportati dalla CLI:

  • Utilizza la 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. 
  • Il sistema può leggere i dati della documentazione da o scrivere dati della documentazione nella CLI o negli script personalizzati. È 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 regolari, qualsiasi script che utilizza questa funzionalità deve essere eseguito come sistema (oppure le autorizzazioni devono essere modificate 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 della 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, 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 posizione non ha un valore, 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 tendina dei dispositivi ✓ X
Selezione multipla dei dispositivi ✓ X
Menu a tendina ✓ ✓
E-mail ✓ ✓
Numero intero ✓ ✓
Indirizzo IP ✓ ✓
Multilinea ✓ ✓
Selezione multipla ✓ ✓
Menu a tendina Organizzazione ✓ X
Menu a tendina "Sede dell'organizzazione" ✓ X
Selezione multipla della sede dell'organizzazione ✓ X
Selezione multipla dell'organizzazione ✓ X
Telefono ✓ ✓
Sicuro ✓* ✓
Testo ✓ ✓
Ora ✓ ✓
WYSIWYG ✓ ✓
URL  ✓ ✓

Funzionalità aggiuntive supportate

Le seguenti informazioni riguardano i campi calcolati e le impostazioni avanzate.

Campi calcolati

Lo strumento CLI supporta i campi calcolati, consentendo di visualizzare 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 difirstfieldsusecondfieldutilizzando i simboli speciali__ firstfield__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 ore. 

Risorse aggiuntive

Fare riferimento alle seguenti risorse per ulteriori informazioni sui campi personalizzati e sull'automazione in NinjaOne:

Domande frequenti

Passi successivi