> 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/getting-started.md). # Installazione Installi PowerShell Universal utilizzando l'MSI, lo ZIP o il modulo PowerShell su Windows e Linux, incluse le esclusioni antivirus e le credenziali di amministratore predefinite. PowerShell Universal supporta installazioni MSI per Windows, ZIP, modulo PowerShell, Docker, IIS e servizio Linux. Scelga il metodo corrispondente al suo ambiente di hosting. ### Vedere anche * [Devolutions Academy – Installazione](https://academy.devolutions.net/student/activity/3465938-installation) ## Installazione MSI (Windows) L'installazione MSI crea un servizio PowerShell Universal. Per impostazione predefinita, PowerShell Universal è in ascolto sulla porta 5000. Può navigare a `http://localhost:5000` I download MSI sono disponibili nella nostra [pagina di download](https://devolutions.net/download-center/powershell-universal/). Le installazioni di sistema vengono eseguite come servizio Windows. Le installazioni utente vengono eseguite quando l'utente accede alla macchina. L'installazione utente viene eseguita nel contesto dell'utente. ### Parametri MSI Utilizzi argomenti `PROPERTY=value` in maiuscolo con `msiexec`. I valori predefiniti riportati di seguito si applicano a una nuova installazione a livello di macchina, a meno che non sia indicato un valore predefinito per singolo utente. | Parametro | Descrizione | Valore predefinito | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `INSTALLFOLDER` | Cartella in cui viene installato PowerShell Universal. | Macchina: `%ProgramFiles%\Universal`; per singolo utente: `%LocalAppData%\Programs\PowerShellUniversal` | | `MSIINSTALLPERUSER` | Ambito di installazione. Impostare su `1` per un'installazione per singolo utente; impostare su `0` per un'installazione a livello di macchina. | `0` | | `TCPPORT` | Porta HTTP per il server. | `5000` | | `HTTPSPORT` | Porta HTTPS quando `DEVCERT=1`. | `5001` | | `DEVCERT` | Crea e installa un certificato di sviluppo localhost e abilita l'endpoint HTTPS. Questo è disabilitato per le installazioni per singolo utente. | Macchina: `1`; per singolo utente: `0` | | `REPOFOLDER` | Cartella del repository per i file di configurazione di PowerShell Universal. | Macchina: `%ProgramData%\UniversalAutomation\Repository`; per singolo utente: `%LocalAppData%\PowerShellUniversal\Repository` | | `CONNECTIONSTRING` | Stringa di connessione per il provider di persistenza selezionato. | Macchina: `Data Source=%ProgramData%\UniversalAutomation\database.db`; per singolo utente: `Data Source=%LocalAppData%\PowerShellUniversal\database.db` | | `DATABASETYPE` | Provider di persistenza. I valori validi sono `SQLite`, `PostgreSQL` e `Microsoft SQL Server`. | `SQLite` | | `APPSETTINGSPATH` | Percorso in cui il programma di installazione scrive `appsettings.json` quando non esiste già. | Macchina: `%ProgramData%\PowerShellUniversal\appsettings.json`; per singolo utente: `%LocalAppData%\PowerShellUniversal\appsettings.json` | | `INSTALLTYPE` | Imposta il valore `Mode` scritto in `appsettings.json`. `Desktop` scrive la modalità Desktop; qualsiasi altro valore scrive la modalità Server. | `Server` | | `STARTSERVICE` | Avvia il servizio Windows di PowerShell Universal dopo l'installazione. Questo non si applica alle installazioni per singolo utente perché non installano un servizio Windows. | Macchina: `1`; per singolo utente: `0` | | `SERVICEACCOUNT` | Account del servizio Windows completo, ad esempio `CONTOSO\psu_svc`. Lasciare vuoto per l'esecuzione come Local System. Solo installazioni a livello di macchina. | Vuoto (Local System) | | `SERVICEACCOUNTPASSWORD` | Password per `SERVICEACCOUNT`. Il programma di installazione maschera questo valore nel proprio log. Solo installazioni a livello di macchina. | Vuoto | | `OPENBROWSER` | Apre l'interfaccia web dopo l'avvio corretto del servizio Windows. Solo installazioni a livello di macchina. | `1` | | `ADDPSMODULEPATH` | Aggiunge la directory del modulo PowerShell Universal a `PSModulePath`. | `1` | | `TELEMETRY` | Abilita la raccolta anonima di dati di telemetria. | `1` | | `STARTUPSHORTCUT` | Crea un collegamento di avvio per un'installazione per singolo utente. | Per singolo utente: `1` | ### Esempio L'esempio seguente esegue un'installazione MSI silenziosa a livello di macchina senza avviare il servizio. I valori dell'account e della password sono solo esempi. {% code overflow="wrap" %} ```powershell Start-Process msiexec.exe -ArgumentList '/i "C:\Installers\PowerShellUniversal.msi" /q /norestart /L*V "C:\Logs\powershell-universal-msi.log" MSIINSTALLPERUSER=0 STARTSERVICE=0 SERVICEACCOUNT=CONTOSO\psu_svc SERVICEACCOUNTPASSWORD=ReplaceWithASecurePassword' -Wait -NoNewWindow ``` {% endcode %} ## Installazione ZIP Può anche scaricare lo ZIP dalla nostra [pagina di download](https://devolutions.net/download-center/powershell-universal/) se desidera distribuire i file tramite xcopy su Windows o Linux. ### Windows Può avviare Universal decomprimendo il contenuto, sbloccando i file ed eseguendo poi `Universal.Server.exe`. ```powershell Expand-Archive -Path .\Universal.zip -DestinationPath .\Universal Get-ChildItem .\Universal -Recurse | Unblock-File Start-Process .\Universal\Universal.Server.exe ``` ### Linux Può utilizzare la seguente riga di comando su Linux per installare e avviare PowerShell Universal: ```bash wget -O psu.zip https://cdn.devolutions.net/download/Devolutions.PowerShellUniversal.linux-x64.2026.3.0.0.zip sudo apt install unzip unzip psu.zip -d PSU chmod +x ./PSU/Universal.Server ./PSU/Universal.Server ``` ## Servizio Linux Può utilizzare `systemd` per avviare PowerShell Universal come servizio. Lo script seguente è un esempio di download di una versione di PowerShell Universal e della sua installazione come servizio: ```bash # ---- # This script will install PowerShell Universal on Linux as a service # This has been tested on Ubuntu 20.04 (ARM64) on a Raspberry Pi 4 # ---- # Dependencies: # wget # unzip # # Make sure they are installed # ---- # These are used to derive the download URL PSU_VERSION="2026.3.0.0" # Change this to the desired version PSU_ARCH="arm64" # Change this to your desired architecture PSU_FILE="Devolutions.PowerShellUniversal.linux-${PSU_ARCH}.${PSU_VERSION}.zip" PSU_URL="https://cdn.devolutions.net/download/${PSU_FILE}" # These are used for installing PowerShell Universal # If you'd like to use a different path, change this PSU_PATH="/opt/psuniversal" PSU_EXEC="${PSU_PATH}/Universal.Server" # These are for installing it as a service PSU_SERVICE="psuniversal" PSU_USER="psuniversal" # ---- # BEGIN # ---- echo "Creating $PSU_PATH and granting access to $USER" sudo mkdir $PSU_PATH sudo setfacl -m "u:${USER}:rwx" $PSU_PATH echo "Creating user $PSU_USER and making it the owner of $PSU_PATH" sudo useradd $PSU_USER -m sudo chown $PSU_USER -R $PSU_PATH echo "Downloading PowerShell Universal $PSU_VERSION ($PSU_ARCH)" wget -q $PSU_URL -O $PSU_FILE echo "Extracting PSU files to $PSU_PATH" unzip -o -qq $PSU_FILE -d $PSU_PATH echo "Make $PSU_EXEC executable" sudo chmod +x $PSU_EXEC echo "Creating service configuration" cat < ~/$PSU_SERVICE.service [Unit] Description=PowerShell Universal [Service] ExecStart=$PSU_EXEC SyslogIdentifier=psuniversal User=$PSU_USER Restart=always RestartSec=5 [Install] WantedBy=multi-user.target EOF echo "Creating and starting service" sudo cp -f ~/$PSU_SERVICE.service /etc/systemd/system sudo systemctl daemon-reload sudo systemctl enable $PSU_SERVICE sudo systemctl start $PSU_SERVICE sudo systemctl status $PSU_SERVICE --no-pager # If you don't use UFW, you can comment this out echo "Allow port 5000/tcp" sudo ufw allow 5000/tcp # ---- # END # ---- ``` ## Modulo PowerShell Può utilizzare il modulo PowerShell di PowerShell Universal per installare il server Universal. Per installare il modulo, utilizzi `Install-Module`. ```powershell Install-Module Devolutions.PowerShellUniversal ``` Per installare il server Universal, può utilizzare `Install-PSUServer`. ```powershell Install-PSUServer -LatestVersion ``` L'esecuzione di questo comando su Windows crea e avvia un servizio Windows sulla sua macchina. L'esecuzione di questo comando su Linux crea e avvia un servizio systemd sulla sua macchina. L'esecuzione di questo comando su Mac OS scarica ed estrae il server PowerShell Universal. ## Docker Consulti la pagina Docker. ## Installazione IIS Consulti la documentazione sull'hosting IIS per informazioni su come configurare PowerShell Universal come sito web IIS. ## Configurazione dell'antivirus PowerShell Universal sfrutta appieno PowerShell e l'SDK di PowerShell. Include script PowerShell direttamente nel prodotto. Consideri la possibilità di configurare l'antivirus per consentire l'esecuzione degli script PowerShell in PowerShell Universal. ### Directory Le directory seguenti contengono esempi, tratti da un sistema Windows standard, di script e file eseguibili che potrebbe essere necessario escludere dai controlli antivirus. La modifica dei percorsi in appsettings.json o nel programma di installazione richiede la modifica delle directory escluse. | Percorso | Descrizione | | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | `%ProgramData%\PowerShellUniversal` | Contiene i file di log e appsettings.json | | `%ProgramData%\UniversalAutomation` | Contiene script e artefatti PowerShell. Contiene il database a file singolo quando non si utilizza l'integrazione SQL. | | `%ProgramFiles%\Universal` | Contiene gli eseguibili, le librerie e i moduli dell'applicazione PowerShell Universal. | ### Eseguibili Potrebbe essere necessario escludere determinati eseguibili che eseguono script PowerShell. Di seguito è riportato un elenco di eseguibili che eseguono PowerShell da PowerShell Universal. | Nome | Descrizione | | ---------------------------- | -------------------------------------------------------- | | Universal.Server.exe | Il servizio principale di PowerShell Universal. | | PowerShellUniversal.Host.exe | L'eseguibile dell'ambiente host di PowerShell Universal. | | pwsh.exe | PowerShell 7.x | | PowerShell.exe | PowerShell 5.x | ## Nome e password predefiniti dell'amministratore Può utilizzare le variabili di ambiente `$ENV:PSUDefaultAdminName` e `$ENV:PSUDefaultAdminPassword` per modificare questo comportamento. Questi valori vengono utilizzati solo se non esiste già un account amministratore. Questo è utile per le installazioni basate sul cloud. ## Agent PowerShell Universal Agent esegue le azioni dell'Event Hub. Lo installi in base al suo ambiente: ### Windows (MSI) L'MSI di PowerShell Universal Agent si trova nella nostra pagina di download. Dopo aver installato l'MSI, un servizio PowerShell Universal Agent viene eseguito sulla sua macchina. Lo configuri per connettersi a PowerShell Universal. ### ZIP I file ZIP per ciascuna piattaforma supportata si trovano nella nostra pagina di download. Ogni ZIP contiene un file `PSUAgent.exe` o `PSUAgent` che può avviare un agent. Esegua il processo come servizio affinché venga avviato ogni volta che la macchina viene riavviata. ### Docker L'immagine del container `devolutions/powershell-universal-agent:latest` fornisce PowerShell Universal Agent come container Docker Linux. ``` docker pull devolutions/powershell-universal-agent:latest ``` ## Passi successivi A questo punto, Universal è attivo e funzionante. Visiti `http://localhost:5000` o la sua porta predefinita per accedere alla console di amministrazione. Effettui l'accesso con il nome e la password predefiniti dell'amministratore oppure crei un account amministratore predefinito. --- # 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/getting-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.