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

NinjaOne IT Asset Management: Crea un dispositivo non gestito tramite l’interfaccia della riga di comando (CLI)

Argomento

Questo articolo spiega come creare un dispositivo non gestito in NinjaOne utilizzando gli strumenti dell'interfaccia della riga di comando (CLI). 

Ambiente

NinjaOne Endpoint Management

Descrizione

Quando si creano dispositivi non gestiti tramite CLI, è possibile rilevare elementi quali monitor, stampanti USB e altre periferiche e definire la relazione che questi elementi hanno con i dispositivi gestiti in NinjaOne. Inoltre, è possibile assegnare il dispositivo non gestito a un utente tramite CLI e NinjaOne popolerà i dati nella console, ove applicabile.

Quando si installa l'agente RMM NinjaOne sul dispositivo, NinjaOne invia i numeri di serie del sistema e del BIOS al payload iniziale per ottimizzare la mappatura dei dati.

Indice

Selezionare una categoria per ulteriori informazioni:

Nuove opzioni della riga di comando

Abbiamo creato nuove righe di comando e aggiunto opzioni alle righe di comando esistenti per facilitare questo processo. 

Nome della riga di comandoDescrizione
unmanaged-newCrea un dispositivo non gestito e passa un oggetto JSON per definirlo. Quando crei un dispositivo non gestito tramite la CLI, il dispositivo verrà automaticamente assegnato alla stessa organizzazione e posizione del dispositivo gestito correlato.
unmanaged-getOttiene i valori dei dispositivi non gestiti correlati al dispositivo gestito, inclusi i numeri ID di ciascuna risorsa (esclusi i campi protetti). Il dispositivo non gestito deve appartenere alla stessa organizzazione e posizione del dispositivo gestito correlato.
unmanaged-setAggiorna i valori dei dispositivi non gestiti esistenti utilizzando l'ID del dispositivo. Questa riga di comando funziona solo se il dispositivo non gestito è correlato a un dispositivo gestito esistente e appartiene alla stessa organizzazione e posizione.
user-setImposta l'utente attualmente assegnato al dispositivo. È possibile utilizzare un indirizzo e-mail come parametro e NinjaOne cercherà utenti finali, tecnici e contatti. Se un account o un contatto è limitato a un'organizzazione, NinjaOne troverà solo i dispositivi che appartengono alla stessa organizzazione dell'utente. I tecnici devono avere il permesso di accedere al dispositivo. 

La tabella seguente elenca i campi che è possibile utilizzare con la riga di comando unmanaged-new per definire i dispositivi non gestiti.

Nome campoObbligatorio (Sì/No)TipoNote
RuoloSìString
NomeSìString
RelazioneSìStringIl nome della relazione direzionale tra il dispositivo creatore e quello creato.
Data di inizio della garanziaNoStringAccetta date nel formato AAAA-MM-GG.
Data di scadenza della garanziaNoStringAccetta date nel formato AAAA-MM-GG.
Assegna a utente dispositivoNoBooleanoQuesta opzione è impostata su "falso" per impostazione predefinita.
ID risorsaNoStringa
Stato risorsaNoString
Data di acquistoNoStringAccetta date nel formato AAAA-MM-GG.
Importo dell'acquistoNoFloat
Durata previstaNoStringAccetta 1, 2, 3, 4 o 5 anni.
Data di fine vitaNoStringAccetta date nel formato AAAA-MM-GG.
Numero di serie dell'assetNoString
Valori dei campi personalizzatiNoMultiploCome definito al momento della creazione.

Ad esempio:

.ninjarmm-clie.exe unmanaged-new '{ "assignToDeviceUser":true, "assetId": "asset-001", 
"assetSerialNumber": "asset-serial-001", "assetStatus": "in use", "customFieldValues": 
{"exampleCustomFieldName": "Valore campo personalizzato", "typeipaddress": "255.255.255.255"},
"endOfLifeDate": "2025-12-31", "expectedLifetime": "5 years", "name": "Test Device with 
CF", "purchaseAmount": 1000, "purchaseDate": "2020-01-01", "relation": "related to", 
"ruolo": "Un altro ruolo", "data di scadenza della garanzia": "2023-12-31", "data di inizio della garanzia": "2021-01-01"}'

Utilizzo dei comandi PowerShell

NinjaOne supporta i comandi PowerShell per quanto segue:

  • New-NinjaUnmanagedDevice
  • Get-NinjaUnmanagedDevice
  • Set-NinjaUnmanagedDevice
  • Set-NinjaUser

Ad esempio: 

$DiscoveredMonitor = @{
   role               = "Monitor"
   name               = "AEG-12345 su Lukes Desktop"
   relation           = "Connected To"
   assignToDeviceUser = $true
   assetId            = "123456"
   assetSerialNumber  = "123456"
   customFieldHashMap = @{
       monitorResolution   = "1920 x 1080"
       monitorManufacturer = "AEG"
       monitorModel        = "12345"
   }
}
$Null = New-NinjaUnmanagedDevice $DiscoveredMonitor
$Devices = Get-NinjaUnmanagedDevice -Role 'Monitor' -Relation 'Connected To'
$UpdateDevice = $Devices[0]
$UpdateDevice.monitorResolution = '5120 x 1440'
$Null = Set-NinjaUnmanagedDevice $UpdateDevice

Risorse aggiuntive

Fare riferimento a NinjaOne IT Asset Management: Catalogo delle risorse per visualizzare tutti gli articoli correlati. 

Domande frequenti

Passi successivi