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 aprender más:
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 comandos | Descripción |
|---|---|
| unmanaged-new | Crea 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 relacionado. |
| Unmanaged-get | Obtiene 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 asociado. |
| unmanaged-set | Actualiza 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-set | Establece 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 se pueden utilizar con la línea de comandos «unmanaged-new» para definir dispositivos no gestionados.
| Nombre del campo | Requerido (Sí/No) | Tipo | Notas |
|---|---|---|---|
| Función | Sí | Cadena | |
| Nombre | Sí | Cadena | |
| Relación | Sí | Cadena | Nombre de la relación direccional entre el dispositivo creador y el dispositivo creado. |
| Fecha de inicio de la garantía | No | Cadena | Acepta fechas en formato AAAA-MM-DD. |
| Término de la garantía | No | Cadena | Acepta fechas en formato AAAA-MM-DD. |
| Asignar al usuario del dispositivo | No | Booleano | Esta opción está establecida en «false» 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. |
| Cantidad de la compra | No | Número flotante | |
| 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 los campos personalizados | No | Múltiples | Segú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"}'Usar comandos de Powershell
NinjaOne ofrece soporte para comandos de Powershell para lo siguiente:
- Nuevo-NinjaUnmanagedDevice
- Get-NinjaUnmanagedDevice
- Establecer-NinjaUnmanagedDevice
- Establecer-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 = NuevoNinjaUnmanagedDevice $DiscoveredMonitor
$Devices = Get-NinjaUnmanagedDevice -Role 'Monitor' -Relation 'Conectado'
$UpdateDevice = $Devices[0]
$UpdateDevice.monitorResolution = '5120 x 1440'
$Null = Set-NinjaUnmanagedDevice $UpdateDeviceRecursos adicionales
Consulta «Gestión de activos de TI de NinjaOne: Catálogo de recursos» para ver todos los artículos sobre ITAM.