{"id":598434,"date":"2025-12-01T01:41:09","date_gmt":"2025-12-01T01:41:09","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=pseudo_docs&p=598434"},"modified":"2025-12-01T01:41:09","modified_gmt":"2025-12-01T01:41:09","slug":"campos-personalizados-avanzados","status":"publish","type":"pseudo_docs","link":"https:\/\/www.ninjaone.com\/es\/docs\/inscripcion-de-dispositivos-y-herramientas-de-gestion\/campos-personalizados\/campos-personalizados-avanzados\/","title":{"rendered":"Campos personalizados avanzados"},"content":{"rendered":"

En este documento, cubriremos c\u00f3mo interactuar desde el SO con\u00a0campos<\/strong>\u00a0personalizados avanzados<\/strong>. Se trata de una poderosa herramienta para los administradores de TI con la que pueden supervisar y controlar casi cualquier cosa con NinjaOne.<\/p>\n

Tambi\u00e9n mostraremos qu\u00e9 herramientas ofrece NinjaOne para este fin, y algunos ejemplos.<\/p>\n

\n
\n

\u00bfC\u00f3mo interactuar con el sistema operativo y los campos personalizados de NinjaOne?<\/h2>\n<\/div>\n<\/div>\n
\n
\n

Hay dos maneras, NinjaRMM-Cli y PowerShell.<\/p>\n

1.\u00a0NinjaRMM-Cli<\/strong>\u00a0es una herramienta de l\u00ednea de comandos que puede utilizarse en el sistema operativo junto con el lenguaje de scripting nativo del SO (Batch, Bash, ShellScript, PowerShell). Esta herramienta dispone de comandos espec\u00edficos para interactuar con los campos personalizados.<\/p>\n

La herramienta NinjaRMM-Cli se instala en un endpoint cuando el agente NinjaOne se instala en un endpoint Windows, Mac o Linux.<\/p>\n

Dependiendo del sistema operativo, la ruta para este archivo ejecutable puede estar en las siguientes carpetas.<\/p>\n

    \n
  • Windows: C:\\ProgramData\\NinjaRMMAgent\\ninjarmm-cli.exe.<\/li>\n
  • Mac: \/Applications\/NinjaRMMAgent\/programdata\/ninjarmm-cli.<\/li>\n
  • Linux: \/opt\/NinjaRMMAgent\/programdata\/ninjarmm-cli.<\/li>\n<\/ul>\n

    NinjaRMM-Cli<\/em>\u00a0get es el comando utilizado para obtener o leer un valor de campo personalizado.<\/p>\n

    NinjaRMM-Cli<\/em>\u00a0set es el comando utilizado para asignar un valor a un campo personalizado.<\/p>\n

    La sintaxis es ninjarmm-cli set value (set debe estar en min\u00fasculas)<\/p>\n

    2. PowerShell<\/strong> es una herramienta de automatizaci\u00f3n de tareas y gesti\u00f3n de la configuraci\u00f3n que utiliza una consola de l\u00ednea de comandos y un lenguaje de scripting basado en .NET.<\/p>\n

    Las claves para interactuar entre el sistema operativo y NinjaOne usando PowerShell son los comandos Ninja-Property-Get y Ninja-Property-Set.<\/p>\n

    Ninja-Property-Get<\/em>\u00a0es el comando PowerShell de NinjaOne para obtener o leer un valor de campo personalizado. La sintaxis es la siguiente: Ninja-Property-Get fieldName.<\/p>\n

    Ninja-Property-Set<\/em>\u00a0es el comando PowerShell de NinjaOne para establecer un campo personalizado a un valor espec\u00edfico. La sintaxis es la siguiente: Ninja-Property-Set fieldName Valor.<\/p>\n<\/div>\n<\/div>\n

    \n
    \n

    Estrategias para campos personalizados<\/h2>\n<\/div>\n<\/div>\n
    \n
    \n

    A continuaci\u00f3n mostramos dos ejemplos de c\u00f3mo utilizar campos personalizados, ambos tienen el mismo objetivo, determinar si un dispositivo est\u00e1 unido a un dominio o no. Un ejemplo es usando NinjaRMM-Cli, y el otro es usando PowerShell. Vamos a crear un campo personalizado de rol, de tipo casilla, llamado domainjoined. Servir\u00e1 para ambos ejemplos; la diferencia estar\u00e1 en las automatizaciones.<\/p>\n

    \u00a01. Crea un campo personalizado de rol llamado domainjoined y as\u00edgnalo a port\u00e1tiles, ordenadores y servidores Windows.<\/strong><\/p>\n

    a) Ve a Administraci\u00f3n, luego a Dispositivos, luego a Campos personalizados.<\/p>\n

    b) Haz clic en A\u00f1adir y, a continuaci\u00f3n, selecciona Campo. Aparecer\u00e1 un cuadro de di\u00e1logo.<\/p>\n

    c) Rellena la etiqueta y el nombre. La etiqueta es Domainjoined; el nombre es domainjoined.<\/p>\n

    d) Selecciona la casilla Tipo de campo.<\/p>\n

    e) Haz clic en Crear.<\/p>\n

    f) Asigna permisos para t\u00e9cnicos como solo lectura, permisos para automatizaciones como leer\/escribir y permisos para API como leer\/escribir.<\/p>\n

    g) Rellena opcionalmente la descripci\u00f3n, el texto de la informaci\u00f3n sobre herramientas y el texto del pie de p\u00e1gina. Tambi\u00e9n puedes elegir si este campo personalizado es obligatorio.<\/p>\n

    h) Haz clic en Guardar. Mira la siguiente captura de pantalla que muestra el cuadro de di\u00e1logo Crear campo personalizado de rol.<\/p>\n

    i) Ve a Administraci\u00f3n, luego a Dispositivos, luego a Funciones (o roles)<\/p>\n

    j) Pon el rat\u00f3n por encima del rol de dispositivo de Windows Server. Aparecer\u00e1 a la derecha el bot\u00f3n Editar. Haz clic sobre \u00e9l. Aparecer\u00e1 un cuadro de di\u00e1logo.<\/p>\n

    k) Haz clic en A\u00f1adir. Selecciona Campo.<\/p>\n

    l) En el men\u00fa desplegable, selecciona el campo personalizado Domain Joined.<\/p>\n

    m)Haz clic en Guardar.<\/p>\n

    n) Repite el proceso para los roles de los ordenadores y port\u00e1tiles Windows.<\/p>\n

    2. Crea una automatizaci\u00f3n PowerShell llamada ChkIfDomainJoinedPS.<\/strong><\/p>\n

    a) Ve a Administraci\u00f3n, luego a Biblioteca y luego a Automatizaci\u00f3n.<\/p>\n

    b) Haz clic en A\u00f1adir y, a continuaci\u00f3n, selecciona Nuevo script. Aparecer\u00e1 el cuadro de di\u00e1logo de creaci\u00f3n de script.<\/p>\n

    c) Rellena el campo nombre con este nombre: ChkIfDomainJoinedPS.<\/p>\n

    d) Opcionalmente, rellena la descripci\u00f3n.<\/p>\n

    e) En Categor\u00eda, selecciona la de tu preferencia.<\/p>\n

    f) En Idioma, selecciona PowerShell.<\/p>\n

    g) En Sistema operativo, selecciona Windows.<\/p>\n

    h) En Arquitectura, selecciona Todas.<\/p>\n

    i) Deja vac\u00edos los campos Variables de script y Par\u00e1metros.<\/p>\n

    j) En el lado izquierdo, pega el siguiente c\u00f3digo.<\/p>\n

    if ((gwmi win32_computersystem).partofdomain -eq $true) {<\/p>\n

    Ninja-Property-Set fieldName 1<\/p>\n

    } else {<\/p>\n

    Ninja-Property-Set fieldName 0<\/p>\n

    }<\/p>\n

    k) Haz clic en Guardar. Introduce la respuesta de tu m\u00e9todo MFA y cierra.<\/p>\n

    3. Crea una automatizaci\u00f3n por lotes denominada ChkIfDomainJoinedBatch.<\/strong><\/p>\n

    a) Ve a Administraci\u00f3n, luego a Biblioteca y luego a Automatizaci\u00f3n.<\/p>\n

    b) Haz clic en A\u00f1adir y, a continuaci\u00f3n, selecciona Nuevo script. Aparecer\u00e1 el cuadro de di\u00e1logo de creaci\u00f3n de script.<\/p>\n

    c) Rellena el campo nombre con este nombre: ChkIfDomainJoinedBatch.<\/p>\n

    d) Opcionalmente, rellena la descripci\u00f3n.<\/p>\n

    e) En Categor\u00eda, selecciona la de tu preferencia.<\/p>\n

    f) En Idioma, selecciona Lote.<\/p>\n

    g) En Sistema operativo, selecciona Windows.<\/p>\n

    h) En Arquitectura, selecciona Todas.<\/p>\n

    i) Deja vac\u00edos los campos Variables de script y Par\u00e1metros.<\/p>\n

    j) En el lado izquierdo, pega el siguiente c\u00f3digo:<\/p>\n

    @echo off<\/p>\n

    for \/F \u201ctokens=1*\u201d %%G in (\u2018SYSTEMINFO ^| FIND \/I \u201cDomain:\u201d\u2018) do set \u201csDomain=%%~H\u201d<\/p>\n

    IF \u201c%sDomain%\u201d==\u201dWORKGROUP\u201d (<\/p>\n

    C:\\ProgramData\\NinjaRMMAgent\\NinjaRMM-Cli set domainjoined 0<\/p>\n

    ) ELSE (<\/p>\n

    C:\\ProgramData\\NinjaRMMAgent\\NinjaRMM-Cli set domainjoined 1<\/p>\n

    )<\/p>\n

    k) Haz clic en Guardar. Introduce la respuesta de tu m\u00e9todo MFA y cierra.<\/p>\n

    Ahora, ve al Panel de Dispositivos y elige cualquier ordenador, port\u00e1til o servidor Windows. Comprueba el estado del campo personalizado Domain Joined. Deber\u00eda decir Sin valor. Ejecuta el script ChkIfDomainJoinedPS.<\/p>\n

    A continuaci\u00f3n, elige cualquier otro ordenador, port\u00e1til o servidor Windows y repite el procedimiento anterior pero, esta vez, ejecuta el script ChkIfDomainJoinedBatch.<\/p>\n

    Transcurridos unos segundos, podr\u00e1s comprobar el campo personalizado Domain Joined en ambos dispositivos, y el estado del campo personalizado se actualizar\u00e1 en consecuencia.<\/p>\n

    Puedes ir m\u00e1s all\u00e1 creando una tarea programada y ejecutarla peri\u00f3dicamente en todos tus dispositivos Windows para mantener el estado actualizado.<\/p>\n<\/div>\n<\/div>\n","protected":false},"author":158,"featured_media":0,"parent":388457,"menu_order":0,"template":"","meta":{"_acf_changed":false,"_relevanssi_hide_post":"","_relevanssi_hide_content":"","_relevanssi_pin_for_all":"","_relevanssi_pin_keywords":"","_relevanssi_unpin_keywords":"","_relevanssi_related_keywords":"","_relevanssi_related_include_ids":"","_relevanssi_related_exclude_ids":"","_relevanssi_related_no_append":"","_relevanssi_related_not_related":"","_relevanssi_related_posts":"","_relevanssi_noindex_reason":"","_lmt_disableupdate":"no","_lmt_disable":""},"class_list":["post-598434","pseudo_docs","type-pseudo_docs","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/pseudo_docs\/598434","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/pseudo_docs"}],"about":[{"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/types\/pseudo_docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/users\/158"}],"up":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/pseudo_docs\/388457"}],"wp:attachment":[{"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/media?parent=598434"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}