> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/it/portale/portal-widgets.md). # Widget del portale Scopra i widget del Portale integrati in PowerShell Universal, inclusi moduli di script, tabelle e grafici, oltre a come creare widget personalizzati con PSBlazor. I widget sono blocchi di interfaccia utente creati con PowerShell e Blazor. Può creare robuste interfacce utente basate sul web con un'esperienza minima di sviluppo web. ## Widget integrati PowerShell Universal offre widget integrati per l'integrazione con altre funzionalità della piattaforma allo scopo di visualizzare elementi dell'interfaccia utente. ### Modulo di script Fornisce un modulo agli utenti finali per eseguire script. L'accesso al Portale viene valutato in tre fasi separate: 1. **Elenco dello script:** l'utente deve disporre di un ruolo corrispondente in **Script Properties > Portal** oppure di un ruolo assegnato a un tag **Display in Portal** associato. 2. **Apertura del modulo dello script:** l'utente deve disporre di un ruolo corrispondente in **Script Properties > Portal**. L'accesso concesso solo tramite un tag non è sufficiente. 3. **Esecuzione dello script:** l'utente deve disporre dell'autorizzazione applicabile **Automation Scripts > Execute**. **Importante:** i ruoli del Portale, i ruoli dei tag e le autorizzazioni di esecuzione non si sostituiscono a vicenda. Uno script può essere elencato ma restituire **Unauthorized** quando viene aperto, oppure può aprirsi ma non riuscire a essere eseguito se l'utente non soddisfa tutti i requisiti applicabili. I tag determinano anche dove viene elencato uno script: | Configurazione | Risultato nel Portale | | ----------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | | Ruolo Portal dello script corrispondente e nessun tag | Elencato nella radice del Portale | | Tag **Display in Portal** autorizzato | Elencato sotto il tag | | Tag autorizzato ma nessun ruolo Portal dello script corrispondente | Elencato sotto il tag, ma restituisce **Unauthorized** quando viene aperto | | Ruolo Portal dello script corrispondente ma nessuna autorizzazione di esecuzione | Può essere elencato e aperto, ma non può essere eseguito | | Solo tag senza **Display in Portal** | Non elencato, anche con un ruolo Portal dello script corrispondente | | Ruolo Portal dello script corrispondente, autorizzazione di esecuzione e un tag **Display in Portal** autorizzato | Elencato sotto il tag e può essere aperto ed eseguito | Un tag è autorizzato quando **Display in Portal** è abilitato e il tag include un ruolo assegnato all'utente. Se uno script ha dei tag, non viene elencato nella radice del Portale. È necessario almeno un tag **Display in Portal** autorizzato affinché sia individuabile. ### Tabella di script Il widget tabella di script visualizza una tabella basata sull'ultimo output di uno script. Seleziona il job più recente e genera la tabella in base alle proprietà degli oggetti restituiti. Ad esempio, provi a eseguire uno script che restituisce i processi sulla macchina corrente. ```powershell Get-Process | Select-Object Name, Id ``` ### Grafico a torta di script Il widget grafico a torta di script visualizza un grafico basato sui dati dell'ultima esecuzione di uno script. Lo script deve produrre dati in un formato particolare per poter definire gli spicchi del grafico. Di seguito è riportato un esempio di come generare i dati per un grafico a torta. ```powershell 1..5 | ForEach-Object { [PSCustomObject]@{ type = "Category $_" value = Get-Random -Min 5 -Max 60 } } ``` Nelle proprietà del widget grafico a torta, imposti la Category Property su `type` e la Value Property `value`. ### Grafico a linee di script Il widget grafico a linee di script visualizza un grafico basato sui dati dell'ultima esecuzione di uno script. Lo script deve produrre dati in un formato particolare per poter definire le linee del grafico. Di seguito è riportato un esempio di come generare i dati per un grafico a linee. ```powershell 1..5 | ForEach-Object { [PSCustomObject]@{ type = "Category $_" value = Get-Random -Min 5 -Max 60 } } ``` Nelle proprietà del widget grafico a linee, imposti XProperty su `type` e YProperty su `value`. ## Widget predefiniti Può trovare i widget creati da Ironman Software e dai membri della community nella[ PowerShell Universal Gallery](/powershell-universal/it/piattaforma/library.md). ## Widget personalizzati Può sviluppare i propri widget personalizzati utilizzando PSBlazor. PSBlazor impiega una sintassi simile a Razor combinata con PowerShell per consentire la creazione di componenti completamente interattivi e personalizzabili. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/it/portale/portal-widgets.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.