¿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 22 de abril de 2026

Tema

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

Entorno

Gestión de activos de TI (ITAM) de NinjaOne

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 completará los datos en la consola cuando sea aplicable.

Al instalar el agente RMM de NinjaOne en el dispositivo, NinjaOne envía los números de serie del sistema y del 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 hemos 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-getObtiene los valores de los dispositivos no gestionados relacionados con el dispositivo gestionado, incluidos los números de identificación de cada activo (excluyendo los campos seguros). El dispositivo no gestionado debe pertenecer a la misma organización y ubicación que su dispositivo gestionado relacionado.
unmanaged-setActualiza los valores de los dispositivos no gestionados existentes utilizando el ID del dispositivo. Esta línea de comandos 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-setEstablece el usuario asignado actualmente al dispositivo. Puede utilizar una dirección de correo electrónico como parámetro, y NinjaOne buscará entre usuarios finales, técnicos y contactos. Si una cuenta o un contacto está limitado a una organización, NinjaOne solo emparejará dispositivos que pertenezcan a la misma organización que el usuario. Los técnicos deben tener permiso para acceder al dispositivo. 

La siguiente tabla enumera 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íCadenaNombre de la relación direccional 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 «false» de forma predeterminada.
ID del activoNoCadena
Estado del activoNoCadena
Fecha de compraNoCadenaAcepta fechas en formato AAAA-MM-DD.
Importe de la compraNoNúmero flotante
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 definió al crearlos.

Por ejemplo:

.ninjarmm-clie.exe unmanaged-new '{ "assignToDeviceUser":true, "assetId": "asset-001", 
"assetSerialNumber": "asset-serial-001", "assetStatus": "in use", "customFieldValues": 
{"exampleCustomFieldName": "Valor del campo personalizado", "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", 
"función": "Otra función", "fechaFinGarantía": "31-12-2023", "fechaInicioGarantía": "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           = "Conectado 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

Recursos adicionales

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

FAQ

Próximos pasos