> 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

## 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.

```powershell
Install-Module Devolutions.PowerShellUniversal
Install-PSUServer
```

{% endtab %}

{% tab title="Linux" %}
Può installare PowerShell Universal utilizzando il seguente script della shell:

```powershell
Install-Module Devolutions.PowerShellUniversal
Install-PSUServer
```

{% endtab %}

{% tab title="Mac OS X" %}
Può installare PowerShell Universal utilizzando il modulo PowerShell Universal:

```powershell
Install-Module Devolutions.PowerShellUniversal
Install-PSUServer -AddToPath
Start-PSUServer -Port 5000
```

{% endtab %}

{% tab title="Raspberry PI OS" %}

```
wget https://imsreleases.blob.core.windows.net/universal/production/2.4.0/Universal.linux-arm.2.4.0.zip
unzip Universal.linux-arm.2.3.2.zip -d ./PSU
chmod +x ./PSU/Universal.Server
./PSU/Universal.Server

```

{% 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 richiamare script PowerShell tramite HTTP. Per creare un'API, clicchi su API \ Endpoints e clicchi su Create New Endpoint. Specifichi un URL. Disabiliti l'autenticazione per questo endpoint.

Successivamente, clicchi su details nella sua nuova API e inserisca il comando seguente nell'editor:

```powershell
Get-ComputerInfo
```

Salvi lo script e poi clicchi sul pulsante Execute per provarlo.

Può anche eseguire l'API tramite `Invoke-RestMethod`.

```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                           :
```

## Creare uno script

Per creare uno script, clicchi su Automation \ Scripts e poi clicchi su Create New Script.

Inserisca il seguente script nell'editor e salvi:

```powershell
Read-Host "What should I say?"

1..100 | ForEach-Object {
    Write-Progress -PercentComplete $_ -Activity "Processing..."
}

Get-Service
```

Una volta salvato lo script, clicchi su Run.

## Creare un'app

Per creare una nuova interfaccia utente basata su PowerShell (app), può cliccare su User Interfaces \ Apps e poi su Create New App.

Dopo aver cliccato su Ok, clicchi sul pulsante Details per modificare lo script PowerShell. Aggiunga il seguente script all'editor:

```powershell
New-UDApp -Title "Hello, World!" -Content {
    New-UDButton -Text "Click Me" -OnClick {
        Show-UDToast -Message 'Success!!'
    }
}
```

Salvi l'app, clicchi sul pulsante Restart e poi clicchi sul pulsante View. Clicchi sul pulsante 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/path/3465905/activity/5612249)


---

# 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=<question>&goal=<endgoal>
```

`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.
