{"id":148246,"date":"2023-09-18T09:19:25","date_gmt":"2023-09-18T09:19:25","guid":{"rendered":"https:\/\/www.ninjaone.com\/blog\/come-automatizzare-la-documentazione-it\/"},"modified":"2026-09-23T06:36:12","modified_gmt":"2026-09-23T06:36:12","slug":"come-automatizzare-la-documentazione-it","status":"publish","type":"post","link":"https:\/\/www.ninjaone.com\/it\/blog\/come-automatizzare-la-documentazione-it\/","title":{"rendered":"L&#8217;aggiornamento delle funzionalit\u00e0 di NinjaOne ti fa risparmiare ore di documentazione"},"content":{"rendered":"<div class=\"in-context-cta\"><h2 style=\"margin-top: 0px;\">Punti chiave<\/h2>\n<ul>\n<li>L\u2019aggiornamento di NinjaOne 5.3.5 consente agli utenti di creare script in grado di definire campi personalizzati a livello di organizzazione per la documentazione IT relativa a chiavi di licenza, ID tenant e configurazioni.<\/li>\n<li>Assegna un computer delegato per controllare quali endpoint possono modificare i campi a livello di organizzazione e prevenire eventuali conflitti.<\/li>\n<li>Crea un campo personalizzato a livello di organizzazione nell&#8217;app Documentazione e imposta i permessi dello script su &#8220;Solo scrittura&#8221; o &#8220;Lettura\/scrittura&#8221;.<\/li>\n<li>Esegui questi comandi nel tuo script sostituendo l&#8217;ID del modello, il nome del documento e il nome dell&#8217;attributo corretti:\n<ul>\n<li>Ninja-Property-Docs-Set $TemplateID \u201c$DocumentName\u201d $AttributeName<\/li>\n<li>Ninja-Property-Docs-Set-Single \u201cnome-modello\u201d \u201cnome-campo\u201d \u201cnuovo valore\u201d<\/li>\n<\/ul>\n<\/li>\n<li>Esegui lo script sul computer delegato.<\/li>\n<\/ul>\n<\/div>\n<p>Da quando sono stati aggiunti i campi personalizzati su NinjaOne, abbiamo la possibilit\u00e0 di leggere e scrivere nei campi personalizzati a livello di dispositivo tramite script e il terminale. I campi personalizzati a livello di organizzazione (disponibili nell&#8217;ambito delle funzionalit\u00e0 di documentazione di <a href=\"https:\/\/www.ninjaone.com\/it\/documentazione\/\">NinjaOne<\/a>) sono sempre stati leggibili tramite script, ma fino ad ora non era possibile modificarli.<\/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\">versione 5.3.5 di NinjaOne<\/a>, abbiamo aggiunto la possibilit\u00e0 di scrivere nei campi personalizzati a livello di organizzazione tramite script o terminale, per automatizzare i processi legati alla documentazione. <b data-stringify-type=\"bold\">La versione 5.3.5 \u00e8 disponibile oggi nelle zone CA \/ OC \/ EU e sar\u00e0 disponibile in NA il 21 settembre.<\/b><\/p>\n<h2>Risparmia ore di documentazione manuale e automatizza la documentazione IT<\/h2>\n<p>Spesso si dispone di dati che potrebbero rivelarsi utili per l&#8217;esecuzione di script su tutti o su molti endpoint di un\u2019organizzazione. Queste informazioni possono essere raccolte e aggiunte a NinjaOne manualmente, ma la possibilit\u00e0 di scrivere in campi personalizzati a livello di organizzazione tramite script offre opzioni quasi illimitate di documentazione automatica.<\/p>\n<p><strong>Alcune situazioni d&#8217;uso concrete per la scrittura nei campi personalizzati dell&#8217;organizzazione sono i seguenti:<\/strong><\/p>\n<ul>\n<li>Estrazione delle chiavi di licenza dalle configurazioni di endpoint esistenti e documentazione automatica di tali chiavi di licenza.<\/li>\n<li>Estrazione e documentazione degli ID dei tenant per applicazioni come Azure, Printix, Keeper e altre soluzioni multi-tenant.<\/li>\n<li>Estrazione e documentazione delle configurazioni di applicazioni, strumenti e hardware sotto forma di file XML, <a href=\"https:\/\/www.ninjaone.com\/it\/blog\/come-automatizzare-la-documentazione-it\/\">YAML<\/a> o JSON dall&#8217;endpoint.<\/li>\n<\/ul>\n<p>Il vantaggio pi\u00f9 importante di questa nuova funzione \u00e8 la possibilit\u00e0 per gli utenti di automatizzare attivit\u00e0 come queste e di risparmiare al proprio team ore di documentazione manuale. Per gli utenti pi\u00f9 esperti c\u2019\u00e8 anche la possibilit\u00e0 di creare un sistema di riferimenti in uno script o di applicare determinate condizioni alle chiavi di licenza, agli ID dei tenant e alle configurazioni estratti, in modo da poterli monitorare e venire avvisati delle modifiche, distribuire software o registrare automaticamente un dispositivo in un tenant.<\/p>\n<h2>Come scrivere nei campi personalizzati dell&#8217;organizzazione in NinjaOne<\/h2>\n<p><strong>1) Designare una macchina delegata<\/strong><\/p>\n<p>Per scrivere nei campi personalizzati di un&#8217;organizzazione \u00e8 necessario utilizzare un delegato. Ci\u00f2 impedisce che pi\u00f9 dispositivi scrivano contemporaneamente in un campo a livello di organizzazione, il che potrebbe causare risultati indesiderati. I delegati possono essere impostati nella scheda organizzazioni, alla voce documentazione.<\/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) Configura il tuo campo personalizzato<\/strong><\/p>\n<p>Ti servir\u00e0 un campo personalizzato a livello di organizzazione in cui inserire i dati. Questi campi sono impostati come moduli nell&#8217;applicazione Documentazione. Per scrivere in un campo tramite script o terminale, \u00e8 necessario impostare il campo su &#8220;Solo scrittura&#8221; o &#8220;Lettura\/scrittura&#8221;.<\/p>\n<p><img fetchpriority=\"high\" 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=\"Impostazione dello stato di lettura per gli script\" width=\"600\" height=\"335\" \/><\/p>\n<p>&nbsp;<\/p>\n<p><strong>3) Scrivi i tuoi script<\/strong><\/p>\n<p>Questo aggiornamento ha aggiunto tre nuovi comandi per la creazione di script in NinjaOne:<\/p>\n<ul>\n<li><strong>Ninja-Property-Docs-Set <\/strong>$TemplateID &#8220;$DocumentName&#8221; $AttributeName<\/li>\n<li><strong>Ninja-Property-Docs-Set-Single <\/strong> \u201cnome-modello\u201d \u201cnome-campo\u201d \u201cnuovo valore\u201d<\/li>\n<\/ul>\n<p>Per rendere l&#8217;esempio pi\u00f9 concreto, vediamo come potrebbe essere organizzata con NinjaOne la documentazione automatica di un ID tenant di Azure.<\/p>\n<p>Supponiamo di aver assegnato il nostro delegato e di aver creato il documento sottostante.<\/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=\"esempio di documentazione 1\" width=\"936\" height=\"334\" \/><\/p>\n<p>&nbsp;<\/p>\n<p>Scrivi il tuo script:<\/p>\n<ul>\n<li>L&#8217;ID\/nome del modello \u00e8 &#8220;Active Directory&#8221;<\/li>\n<li>Il nome del documento \u00e8 &#8220;Tyrell Active Directory&#8221;<\/li>\n<li>Il nome dell&#8217;attributo \u00e8 azureTenantID<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\">$tenantId = (Get-AzureADTenantDetail).objectId\r\n\r\nNinja-Property-Docs-Set \u2018Active Directory\u2019 \u2018Tyrell Active Directory\u2019 azureTenantID $tenantId\r\n<\/pre>\n<p><strong>4) Distribuisci lo script<\/strong><\/p>\n<p>Infine, devi distribuire lo script sull&#8217;endpoint delegato appropriato. Una volta eseguito, lo script scriver\u00e0 nel campo personalizzato a livello di organizzazione e completer\u00e0 l&#8217;operazione con successo.<\/p>\n<p>A questo punto esegui questa operazione sul tuo computer delegato per aggiornare il modello.<\/p>\n<p><img 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=\"esempio di documentazione 2\" width=\"936\" height=\"334\" \/><\/p>\n<h2>Vuoi vedere NinjaOne in azione?<\/h2>\n<p><a href=\"https:\/\/www.ninjaone.com\/it\/demo-gratuita\/\">Guarda una breve demo gratuita su<\/a> oppure prova tu stesso queste funzionalit\u00e0 iscrivendoti a una <a href=\"https:\/\/www.ninjaone.com\/it\/prova-gratuita\/\">prova gratuita senza impegno<\/a>.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Da quando sono stati aggiunti i campi personalizzati su NinjaOne, abbiamo la possibilit\u00e0 di leggere e scrivere nei campi personalizzati a livello di dispositivo tramite script e il terminale. I campi personalizzati a livello di organizzazione (disponibili nell&#8217;ambito delle funzionalit\u00e0 di documentazione di NinjaOne) sono sempre stati leggibili tramite script, ma fino ad ora non [&hellip;]<\/p>\n","protected":false},"author":39,"featured_media":137736,"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":"no","_lmt_disable":"","footnotes":""},"categories":[4338,4326],"tags":[],"class_list":["post-148246","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-documentazione-it","category-ninjaone-it"],"acf":[],"modified_by":"Chiara Cavalletti","_links":{"self":[{"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/posts\/148246","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/users\/39"}],"replies":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/comments?post=148246"}],"version-history":[{"count":2,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/posts\/148246\/revisions"}],"predecessor-version":[{"id":882856,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/posts\/148246\/revisions\/882856"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/media\/137736"}],"wp:attachment":[{"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/media?parent=148246"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/categories?post=148246"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.ninjaone.com\/it\/wp-json\/wp\/v2\/tags?post=148246"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}