¿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 10 de julio de 2026

Tema

En este artículo se explica cómo crear un dispositivo no gestionado en NinjaOne mediante herramientas de la 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, puedes 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, puedes 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 de la BIOS a la carga útil inicial para optimizar la asignación de datos.

Índice

Selecciona 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 ya 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 se crea 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 asociado.
unmanaged-getObtiene los valores de los dispositivos no gestionados relacionados con el dispositivo gestionado, incluidos los números de identificación de cada activo (excluidos los campos seguros). El dispositivo no gestionado debe pertenecer a la misma organización y ubicación que su dispositivo gestionado asociado.
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. Puedes 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 encontrará 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 al 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 los campos personalizadosNoMúltiplesSegún se haya definido al crearlos.

Por ejemplo:

.ninjarmm-cli.exe unmanaged-new '{ "assignToDeviceUser":true, "assetId": "asset-001", 
"assetSerialNumber": "asset-serial-001", "assetStatus": "en uso", "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", 
"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           = "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

Consulta NinjaOne: Catálogo de recursos» para ver todos los artículos sobre ITAM.

FAQ

Próximos pasos