> 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/get-started.md). # Per iniziare Inizi a usare PowerShell Universal installando il server, effettuando l'accesso e creando il suo primo endpoint API, script e app. ## Installare PowerShell Universal Sarà necessario installare il server PowerShell Universal. [Esistono molti modi per farlo,](/powershell-universal/it/getting-started.md) ma può utilizzare la riga di comando seguente per iniziare rapidamente: {% tabs %} {% tab title="Windows" %} Può installare PowerShell Universal come servizio. Si assicuri che PowerShell sia in esecuzione come amministratore, altrimenti il servizio non verrà installato correttamente. {% code collapsedlinecount="10" %} ```powershell Install-Module Devolutions.PowerShellUniversal Install-PSUServer ``` {% endcode %} {% endtab %} {% tab title="Linux" %} Può installare PowerShell Universal utilizzando il seguente script della shell: {% code collapsedlinecount="10" %} ```powershell Install-Module Devolutions.PowerShellUniversal Install-PSUServer ``` {% endcode %} {% endtab %} {% tab title="Mac OS X" %} Può installare PowerShell Universal utilizzando il modulo PowerShell Universal: {% code collapsedlinecount="10" %} ```powershell Install-Module Devolutions.PowerShellUniversal Install-PSUServer -AddToPath Start-PSUServer -Port 5000 ``` {% endcode %} {% endtab %} {% tab title="Raspberry PI OS" %} {% code collapsedlinecount="10" %} ``` wget https://cdn.devolutions.net/download/Devolutions.PowerShellUniversal.linux-arm.2026.3.0.0.zip unzip Devolutions.PowerShellUniversal.linux-arm.2026.3.0.0.zip -d ./PSU chmod +x ./PSU/Universal.Server ./PSU/Universal.Server ``` {% endcode %} {% endtab %} {% endtabs %} ## Aprire PowerShell Universal Per impostazione predefinita, PowerShell Universal è in esecuzione sulla porta 5000 di localhost. Apra un browser web e vada a `http://localhost:5000`. ### Accedere con un Devolutions Account La prima volta che accede a PowerShell Universal, può effettuare l'accesso con un [Devolutions account](https://docs.devolutions.net/portal/it/profile/create-your-devolutions-account) per ricevere una licenza gratuita per sviluppatori. Questa licenza abiliterà tutte le funzionalità ed è destinata a flussi di lavoro non di produzione. Questo flusso di licenza per sviluppatori è destinato allo sviluppo locale e richiede l'accesso locale all'host di PowerShell Universal. Se gli utenti accedono a PSU solo da browser remoti tramite Docker, IIS o un reverse proxy, dovrebbero utilizzare invece uno dei percorsi di licenza standard. ### Procedura guidata di primo avvio Facoltativamente, può scegliere di eseguire la configurazione tramite la procedura guidata di primo avvio invece di accedere con un Devolutions account e fornire una chiave di licenza. ## Creare un'API Le API consentono di chiamare script PowerShell tramite HTTP. Vada su Build > APIs > Endpoints e selezioni Create Endpoint. Specifichi un URL, disabiliti l'autenticazione e selezioni Save. Selezioni il nuovo endpoint per aprire il relativo editor, quindi inserisca il comando seguente: {% code collapsedlinecount="10" %} ```powershell Get-ComputerInfo ``` {% endcode %} Salvi lo script e poi clicchi sul pulsante Execute per provarlo. Può anche eseguire l'API tramite `Invoke-RestMethod`. {% code collapsedlinecount="10" %} ```powershell PS C:\Users\adamr> Invoke-RestMethod http://localhost:5000/hello-world WindowsBuildLabEx : 22000.1.amd64fre.co_release.210604-1628 WindowsCurrentVersion : 6.3 WindowsEditionId : Professional WindowsInstallationType : Client WindowsInstallDateFromRegistry : 8/6/2021 4:05:12 PM WindowsProductId : 00330-52452-93139-AAOEM WindowsProductName : Windows 10 Pro WindowsRegisteredOrganization : ``` {% endcode %} ## Creare uno script Per creare uno script, vada su Build > Scripts e selezioni Create Script. Inserisca un nome e selezioni Save. PowerShell Universal apre l'editor di script. Inserisca il seguente script nell'editor e salvi: {% code collapsedlinecount="10" %} ```powershell Read-Host "What should I say?" 1..100 | ForEach-Object { Write-Progress -PercentComplete $_ -Activity "Processing..." } Get-Service ``` {% endcode %} Una volta salvato lo script, clicchi su Run. ## Creare un'app Per creare una nuova interfaccia utente basata su PowerShell, vada su Build > Apps e selezioni Create App. Inserisca un nome e un URL per l'app. Selezioni Save, quindi selezioni il nome dell'app per aprire il relativo editor. Sostituisca lo script generato con il seguente: {% code collapsedlinecount="10" %} ```powershell New-UDApp -Title "Hello, World!" -Content { New-UDButton -Text "Click Me" -OnClick { Show-UDToast -Message 'Success!!' } } ``` {% endcode %} Salvi l'app, selezioni Restart, quindi selezioni View App. Nell'app, selezioni Click Me. Maggiori informazioni sulle varie funzionalità di PowerShell Universal: * [API](/powershell-universal/it/api/about.md) * [Automazione](/powershell-universal/it/automazione/about.md) * [App](/powershell-universal/it/app/building-dashboards.md) ### Vedere anche * [Devolutions Academy – Installazione](https://academy.devolutions.net/student/activity/3465938-installation) --- # 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/get-started.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.