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 a riga di comando (CLI). 

Ambiente

NinjaOne IT Asset Management (ITAM)

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 inserirà i dati nella console, ove applicabile.

Quando si installa l'agente RMM di 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 a quelle 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 alla stessa posizione del dispositivo gestito correlato.
unmanaged-getOttiene i valori dei dispositivi non gestiti correlati al dispositivo gestito, inclusi i numeri ID per ciascuna risorsa (esclusi i campi protetti). Il dispositivo non gestito deve appartenere alla stessa organizzazione e alla stessa sede 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 alla stessa posizione.
user-setImposta l'utente attualmente assegnato al dispositivo. È possibile utilizzare un indirizzo e-mail come parametro e NinjaOne cercherà gli utenti finali, i tecnici e i contatti. Se un account o un contatto è limitato a un'organizzazione, NinjaOne abbinerà solo i dispositivi che appartengono alla stessa organizzazione dell'utente. I tecnici devono disporre dell'autorizzazione per 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ìStringa
NomeSìStringa
RelazioneSìStringaNome della relazione direzionale tra il dispositivo creatore e quello creato.
Data di inizio della garanziaNoStringaAccetta date nel formato AAAA-MM-GG.
Data di scadenza della garanziaNoStringaAccetta date nel formato AAAA-MM-GG.
Assegna a utente dispositivoNoBooleanoQuesta opzione è impostata su "false" per impostazione predefinita.
ID risorsaNoStringa
Stato risorsaNoStringa
Data di acquistoNoStringaAccetta date nel formato AAAA-MM-GG.
Importo dell'acquistoNoFloat
Durata previstaNoStringaAccetta 1, 2, 3, 4 o 5 anni.
Data di fine vitaNoStringaAccetta date nel formato AAAA-MM-GG.
Numero di serie dell'assetNoStringa
Valori dei campi personalizzatiNoMoltepliciCome 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": "31-12-2025", "expectedLifetime": "5 anni", "name": "Dispositivo di prova con 
CF", "purchaseAmount": 1000, "purchaseDate": "01-01-2020", "relation": "correlato a", 
"role": "Another Role", "warrantyEndDate": "31/12/2023", "warrantyStartDate": "01/01/2021"}'

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 sul desktop di Luke"
   relation           = "Connesso a"
   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