{"id":148515,"date":"2022-10-13T09:42:29","date_gmt":"2022-10-13T09:42:29","guid":{"rendered":"https:\/\/www.ninjaone.com\/blog\/como-automatizar-la-documentacion\/"},"modified":"2024-10-18T21:18:23","modified_gmt":"2024-10-18T21:18:23","slug":"como-automatizar-la-documentacion","status":"publish","type":"post","link":"https:\/\/www.ninjaone.com\/es\/blog\/como-automatizar-la-documentacion\/","title":{"rendered":"La \u00faltima actualizaci\u00f3n de Ninja te ahorra horas de documentaci\u00f3n"},"content":{"rendered":"<p><img fetchpriority=\"high\" decoding=\"async\" class=\"alignnone size-full wp-image-120688\" src=\"https:\/\/www.ninjaone.com\/wp-content\/uploads\/2023\/10\/ninjaone-social-1.jpg\" alt=\"\" width=\"1194\" height=\"627\" \/><\/p>\n<p>Desde que agregamos campos personalizados a Ninja, hemos podido leer y escribir campos personalizados a nivel de dispositivo a trav\u00e9s de scripts y la terminal. Los campos personalizados a nivel de organizaci\u00f3n (disponibles como parte de <a href=\"https:\/\/www.ninjaone.com\/es\/it-documentacion\/\">la funcionalidad de documentaci\u00f3n de Ninja<\/a>) siempre se han podido leer a trav\u00e9s de scripts, pero hasta ahora no se pod\u00edan escribir.<\/p>\n<p>Con la <a href=\"https:\/\/ninjarmm.zendesk.com\/hc\/en-us\/articles\/8327976337677-08-29-2022-NinjaOne-Release-5-3-5\" target=\"_blank\" rel=\"noopener\">versi\u00f3n 5.3.5 de Ninja<\/a>, hemos a\u00f1adido la posibilidad de escribir en los campos personalizados a nivel de organizaci\u00f3n a trav\u00e9s de scripts o del terminal para la documentaci\u00f3n autom\u00e1tica. <b data-stringify-type=\"bold\">La versi\u00f3n 5.3.5 est\u00e1 disponible en las instancias de CA \/ OC \/ EU hoy y estar\u00e1 disponible en NA el 21 de septiembre.<\/b><\/p>\n<h2>Ah\u00f3rrate horas de documentaci\u00f3n manual con un mundo de nuevas posibilidades de automatizaci\u00f3n<\/h2>\n<p>Con frecuencia hay datos que ser\u00edan \u00fatiles para el scripting en todos o muchos puntos finales de una organizaci\u00f3n. Esta informaci\u00f3n puede ser recogida y a\u00f1adida a NinjaOne manualmente, pero permitir que los campos personalizados a nivel de organizaci\u00f3n sean escritos a trav\u00e9s de un script permite posibilidades casi ilimitadas para la documentaci\u00f3n automatizada.<\/p>\n<p><strong>Algunos casos de uso del mundo real para escribir en los campos personalizados de la organizaci\u00f3n incluyen:<\/strong><\/p>\n<ul>\n<li>Extraer las claves de licencia de las configuraciones de puntos finales existentes y documentar dichas claves de licencia autom\u00e1ticamente.<\/li>\n<li>Extraer y documentar los ID de los inquilinos para aplicaciones como Azure, Printix, Keeper y otras soluciones multi-inquilinos.<\/li>\n<li>Extraer y documentar las configuraciones de la aplicaci\u00f3n, la herramienta y el hardware como un blog XML o JSON desde el punto final.<\/li>\n<\/ul>\n<p>El beneficio m\u00e1s importante de esta nueva funci\u00f3n es la capacidad de los usuarios de automatizar tareas como \u00e9stas y evitar que su equipo pase horas con la documentaci\u00f3n manual. Para los usuarios m\u00e1s avanzados, estas claves de licencia extra\u00eddas, los ID de los inquilinos y las configuraciones se pueden referenciar en un script o con condiciones para supervisar y alertar sobre los cambios, desplegar software o unir un dispositivo a un inquilino autom\u00e1ticamente.<\/p>\n<h2>C\u00f3mo escribir en los campos personalizados de la organizaci\u00f3n en Ninja<\/h2>\n<p><strong>1) Nombrar una m\u00e1quina delegada<\/strong><\/p>\n<p>La escritura en los campos personalizados de la organizaci\u00f3n requiere el uso de un delegado. Esto impide que varios dispositivos escriban simult\u00e1neamente en un campo a nivel de organizaci\u00f3n, lo que podr\u00eda causar resultados no deseados. Los delegados se pueden configurar en la pesta\u00f1a de organizaciones, en la secci\u00f3n de documentaci\u00f3n.<\/p>\n<p><video class=\"gif-video\" autoplay=\"autoplay\" loop=\"loop\" muted=\"\" width=\"640\" height=\"279\"><source src=\"https:\/\/www.ninjaone.com\/wp-content\/uploads\/2022\/11\/Documentation5.3.5.mp4\" \/><\/video><\/p>\n<p>&nbsp;<\/p>\n<p><strong>2) Configure su campo personalizado<\/strong><\/p>\n<p>Necesitar\u00e1 un campo personalizado a nivel de organizaci\u00f3n para escribir en \u00e9l. Estos campos se configuran como formularios en la aplicaci\u00f3n Documentaci\u00f3n. Para escribir en un campo a trav\u00e9s de un script o un terminal, tendr\u00e1s que configurar el campo de scripts como \u00abS\u00f3lo escritura\u00bb o \u00abLectura\/escritura\u00bb.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-136704\" src=\"https:\/\/www.ninjaone.com\/wp-content\/uploads\/2023\/10\/Setting-read-status-for-scripts.png\" alt=\"Establecer el estado de lectura de los scripts\" width=\"600\" height=\"335\" \/><\/p>\n<p>&nbsp;<\/p>\n<p><strong>3) Escribe tu script<\/strong><\/p>\n<p>Esta actualizaci\u00f3n ha a\u00f1adido tres nuevos comandos para la creaci\u00f3n de scripts en Ninja:<\/p>\n<ul>\n<li><strong>Ninja-Property-Docs<\/strong>$TemplateID \u00ab$DocumentName\u00bb $AttributeName<\/li>\n<li><strong>Ninja-Property-Docs-Set-Single <\/strong>\u00abtemplateName\u00bb \u00abfieldName\u00bb \u00abnew value\u00bb<\/li>\n<\/ul>\n<p>Para hacer esto m\u00e1s real, vamos a esbozar lo que puede parecer para documentar autom\u00e1ticamente un ID de inquilino de Azure con Ninja.<\/p>\n<p>Supongamos que hemos asignado nuestro delegado y creado el documento que aparece a continuaci\u00f3n.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-136716\" src=\"https:\/\/www.ninjaone.com\/wp-content\/uploads\/2023\/10\/ad-documentation-example-1.png\" alt=\"ejemplo de documentaci\u00f3n publicitaria 1\" width=\"936\" height=\"334\" \/><\/p>\n<p>&nbsp;<\/p>\n<p>Vamos a escribir nuestro script:<\/p>\n<ul>\n<li>El ID \/ nombre de la plantilla es \u00abActive Directory\u00bb<\/li>\n<li>El nombre del documento es \u00abTyrell Active Directory\u00bb<\/li>\n<li>El nombre del atributo es azureTenantID<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\">$tenantId = (Get-AzureADTenantDetail).objectId\n\nNinja-Property-Docs-Set 'Active Directory' 'Tyrell Active Directory' azureTenantID $tenantId\n<\/pre>\n<p><strong>4) Despliega tu script<\/strong><\/p>\n<p>Por \u00faltimo, es necesario desplegar el script en el punto final apropiado del delegado. Una vez ejecutado el script, \u00e9ste escribir\u00e1 en el campo personalizado a nivel de organizaci\u00f3n y se completar\u00e1 con \u00e9xito.<\/p>\n<p>A continuaci\u00f3n, ejecutamos esto en nuestra m\u00e1quina delegada para actualizar la plantilla.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-136728\" src=\"https:\/\/www.ninjaone.com\/wp-content\/uploads\/2023\/10\/ad-documentation-example-2.png\" alt=\"ejemplo de documentaci\u00f3n publicitaria 2\" width=\"936\" height=\"334\" \/><\/p>\n<h2>\u00bfQuieres ver a Ninja en acci\u00f3n?<\/h2>\n<p><a href=\"https:\/\/www.ninjaone.com\/es\/free-demo\/\">Mira una breve demostraci\u00f3n gratuita<\/a> o pruebaestas funciones registr\u00e1ndote para <a href=\"https:\/\/www.ninjaone.com\/es\/prueba-gratuita-formulario\/\">una prueba gratuita sin compromiso<\/a>.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Desde que agregamos campos personalizados a Ninja, hemos podido leer y escribir campos personalizados a nivel de dispositivo a trav\u00e9s de scripts y la terminal. Los campos personalizados a nivel de organizaci\u00f3n (disponibles como parte de la funcionalidad de documentaci\u00f3n de Ninja) siempre se han podido leer a trav\u00e9s de scripts, pero hasta ahora no [&hellip;]<\/p>\n","protected":false},"author":39,"featured_media":137741,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","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":"","_lmt_disable":"","footnotes":""},"categories":[4339,4327,3231],"tags":[],"class_list":["post-148515","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-documentacion-de-ti","category-ninjaone-es","category-rmm-es"],"acf":[],"modified_by":null,"_links":{"self":[{"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/posts\/148515","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/users\/39"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/comments?post=148515"}],"version-history":[{"count":0,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/posts\/148515\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/media\/137741"}],"wp:attachment":[{"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/media?parent=148515"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/categories?post=148515"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.ninjaone.com\/es\/wp-json\/wp\/v2\/tags?post=148515"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}