¿Ya eres cliente de NinjaOne? Inicia sesión para ver más guías y las últimas actualizaciones.

NinjaOne IT Asset Management: Crear un dispositivo no gestionado a través de la interfaz de línea de comandos (CLI)

  • Última actualización marzo 11, 2026

Tema

Este artículo explica cómo crear un dispositivo no gestionado en NinjaOne utilizando herramientas de interfaz de línea de comandos (CLI). 

Entorno

NinjaOne Endpoint Management

Descripción

Al crear dispositivos no gestionados a través de la CLI, puede detectar elementos como monitores, impresoras USB y otros periféricos, y definir la relación que estos elementos tienen con los dispositivos gestionados en NinjaOne. Además, puede asignar el dispositivo no gestionado a un usuario a través de la CLI, y NinjaOne rellenará los datos en la consola cuando sea aplicable.

Cuando instala el agente RMM de NinjaOne en el dispositivo, NinjaOne envía los números de serie del sistema y de la BIOS a la carga útil inicial para optimizar la asignación de datos.

Índice

Seleccione una categoría para obtener más información:

Nuevas opciones de línea de comandos

Hemos creado nuevas líneas de comandos y añadido opciones a las líneas de comandos existentes para facilitar este proceso. 

Nombre de la línea de comandosDescripción
unmanaged-newCrea un dispositivo no gestionado y pasa un objeto JSON para definirlo. Cuando creas un dispositivo no gestionado a través de la CLI, el dispositivo se asignará automáticamente a la misma organización y ubicación que su dispositivo gestionado relacionado.
unmanaged-getObtenga los valores de los dispositivos no administrados relacionados con el dispositivo administrado, incluidos los números de identificación de cada activo (excepto los campos seguros). El dispositivo no administrado debe pertenecer a la misma organización y ubicación que su dispositivo administrado relacionado.
unmanaged-setActualizar los valores de los dispositivos no gestionados existentes utilizando el ID del dispositivo. Esta línea de comando solo funciona si el dispositivo no gestionado está relacionado con un dispositivo gestionado existente y pertenece a la misma organización y ubicación.
user-setEstablezca el usuario actualmente asignado al dispositivo. Puede utilizar una dirección de correo electrónico como parámetro y NinjaOne buscará usuarios finales, técnicos y contactos. Si una cuenta o un contacto está limitado a una organización, NinjaOne solo buscará dispositivos que pertenezcan a la misma organización que el usuario. Los técnicos deben tener permiso para acceder al dispositivo. 

En la siguiente tabla se enumeran los campos que puede utilizar con la línea de comandos unmanaged-new para definir dispositivos no gestionados.

Nombre del campoObligatorio (Sí/No)TipoNotas
FunciónSíCadena
NombreSíCadena
RelaciónSíCadenaEl nombre de la relación de activos direccionales entre el dispositivo creador y el creado.
Fecha de inicio de la garantíaNoCadenaAcepta fechas en formato AAAA-MM-DD.
Fecha de finalización de la garantíaNoCadenaAcepta fechas en formato AAAA-MM-DD.
Asignar a usuario del dispositivoNoBooleanoEsta opción está establecida en «falso» de forma predeterminada.
ID del activoNoCadena
Estado del activoNoCadena
Fecha de compraNoCadenaAcepta fechas en formato AAAA-MM-DD.
Importe de la compraNoFloat
Vida útil previstaNoCadenaAcepta 1, 2, 3, 4 o 5 años.
Fecha de fin de vida útilNoCadenaAcepta fechas en formato AAAA-MM-DD.
Número de serie del activoNoCadena
Valores de campos personalizadosNoMúltipleSegún se defina al crearlos.

Por ejemplo:

.ninjarmm-clie.exe unmanaged-new '{ "assignToDeviceUser":true, "assetId": "asset-001", 
"assetSerialNumber": "asset-serial-001", "assetStatus": "in use", "customFieldValues": 
{"exampleCustomFieldName": "Custom Field Value", "typeipaddress": "255.255.255.255"},
"endOfLifeDate": "2025-12-31", "expectedLifetime": "5 años", "name": "Dispositivo de prueba con 
CF", "purchaseAmount": 1000, "purchaseDate": "2020-01-01", "relation": "relacionado con", 
"role": "Otra función", "warrantyEndDate": "31-12-2023", "warrantyStartDate": "01-01-2021"}'

Uso de comandos de PowerShell

NinjaOne admite comandos de PowerShell para lo siguiente:

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

Por ejemplo: 

$DiscoveredMonitor = @{
   role               = "Monitor"
   name               = "AEG-12345 en el escritorio de Luke"
   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

Recursos adicionales

Consulte NinjaOne IT Asset Management: Catálogo de recursos para ver todos los artículos relacionados. 

FAQ

Próximos pasos