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, nonché 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 l’agente RMM di NinjaOne è installato 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
Non gestito-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.
Non gestito getRecupera 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 alla stessa sede del dispositivo gestito a cui è associato.
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 è associato a un dispositivo gestito esistente e appartiene alla stessa organizzazione e alla stessa sede.
user-setImposta l'utente assegnato al dispositivo. È possibile utilizzare un indirizzo e-mail come parametro e NinjaOne cercherà tra utenti finali, tecnici e 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 del 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 fine garanziaNoStringaAccetta date nel formato AAAA-MM-GG.
Assegna a utente del dispositivoNoBooleanoPer impostazione predefinita, questa opzione è "falso".
ID risorsaNoStringa
Stato della 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 del beneNoStringa
Valori dei campi personalizzatiNoPiù di unoCome definito al momento della creazione.

Ad esempio:

.ninjarmm-cli.exe unmanaged-new '{ "assignToDeviceUser":true, "assetId": "asset-001", 
"assetSerialNumber": "asset-serial-001", "assetStatus": "in uso", "customFieldValues": 
{"exampleCustomFieldName": "Valore del campo personalizzato", "typeipaddress": "255.255.255.255"},
"endOfLifeDate": "2025-12-31", "expectedLifetime": "5 anni", "name": "Dispositivo di prova con 
CF", "purchaseAmount": 1000, "purchaseDate": "2020-01-01", "relation": "correlato a", 
"role": "Un altro Ruolo", "warrantyEndDate": "2023-12-31", "warrantyStartDate": "2021-01-01"}'

Uso dei comandi Powershell

NinjaOne fornisce supporto per i comandi Powershell per il seguente elenco:

  • Nuovo NinjaUnmanagedDevice
  • Get-NinjaUnmanagedDevice
  • Set-NinjaUnmanagedDevice
  • Set-NinjaUser

Ad esempio:

$DiscoveredMonitor = @{
   ruolo               = "Monitoraggio"
   nome               = "AEG-12345 sul desktop di Luke"
   relazione           = "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 'Connesso'
$UpdateDevice = $Devices[0]
$UpdateDevice.monitorResolution = '5120 x 1440'
$Null = Set-NinjaUnmanagedDevice $UpdateDevice

Risorse aggiuntive

Consulta NinjaOne IT Asset Management: Catalogo delle risorse per visualizzare tutti gli articoli sull’ITAM.

Domande frequenti

Passi successivi