¿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 comandos Descripción
unmanaged-new Crea 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-get Obtenga 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-set Actualizar 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-set Establezca 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 campo Obligatorio (Sí/No) Tipo Notas
Función Sí Cadena
Nombre Sí Cadena
Relación Sí Cadena El nombre de la relación de activos direccionales entre el dispositivo creador y el creado.
Fecha de inicio de la garantía No Cadena Acepta fechas en formato AAAA-MM-DD.
Fecha de finalización de la garantía No Cadena Acepta fechas en formato AAAA-MM-DD.
Asignar a usuario del dispositivo No Booleano Esta opción está establecida en «falso» de forma predeterminada.
ID del activo No Cadena
Estado del activo No Cadena
Fecha de compra No Cadena Acepta fechas en formato AAAA-MM-DD.
Importe de la compra No Float
Vida útil prevista No Cadena Acepta 1, 2, 3, 4 o 5 años.
Fecha de fin de vida útil No Cadena Acepta fechas en formato AAAA-MM-DD.
Número de serie del activo No Cadena
Valores de campos personalizados No Múltiple Segú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