> 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/fr/getting-started.md). # Installation Installer PowerShell Universal à l'aide du MSI, du ZIP ou du module PowerShell sous Windows et Linux, y compris les exclusions d'antivirus et les identifiants d'administrateur par défaut. PowerShell Universal prend en charge les installations par MSI Windows, ZIP, module PowerShell, Docker, IIS et service Linux. Choisissez la méthode qui correspond à votre environnement d'hébergement. ### Voir aussi * [Devolutions Academy – Installation](https://academy.devolutions.net/student/activity/3465938-installation) ## Installation MSI (Windows) L'installation MSI crée un service PowerShell Universal. Par défaut, PowerShell Universal écoute sur le port 5000. Vous pouvez naviguer vers `http://localhost:5000` Les téléchargements MSI sont disponibles sur notre [page de téléchargement](https://devolutions.net/download-center/powershell-universal/). Les installations système s'exécutent en tant que service Windows. Les installations utilisateur s'exécutent lorsque l'utilisateur se connecte à la machine. L'installation utilisateur s'exécute dans le contexte de l'utilisateur. ### Paramètres MSI Utilisez des arguments `PROPERTY=value` en majuscules avec `msiexec`. Les valeurs par défaut ci-dessous s'appliquent à une nouvelle installation à l'échelle de la machine, sauf si une valeur par défaut par utilisateur est indiquée. | Paramètre | Description | Valeur par défaut | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `INSTALLFOLDER` | Dossier où PowerShell Universal est installé. | Machine : `%ProgramFiles%\Universal` ; par utilisateur : `%LocalAppData%\Programs\PowerShellUniversal` | | `MSIINSTALLPERUSER` | Portée de l'installation. Définissez-le à `1` pour une installation par utilisateur ; définissez-le à `0` pour une installation à l'échelle de la machine. | `0` | | `TCPPORT` | Port HTTP du serveur. | `5000` | | `HTTPSPORT` | Port HTTPS lorsque `DEVCERT=1`. | `5001` | | `DEVCERT` | Crée et installe un certificat de développement localhost et active le terminal HTTPS. Ceci est désactivé pour les installations par utilisateur. | Machine : `1` ; par utilisateur : `0` | | `REPOFOLDER` | Dossier du dépôt pour les fichiers de configuration de PowerShell Universal. | Machine : `%ProgramData%\UniversalAutomation\Repository` ; par utilisateur : `%LocalAppData%\PowerShellUniversal\Repository` | | `CONNECTIONSTRING` | Chaîne de connexion pour le fournisseur de persistance sélectionné. | Machine : `Data Source=%ProgramData%\UniversalAutomation\database.db` ; par utilisateur : `Data Source=%LocalAppData%\PowerShellUniversal\database.db` | | `DATABASETYPE` | Fournisseur de persistance. Les valeurs valides sont `SQLite`, `PostgreSQL` et `Microsoft SQL Server`. | `SQLite` | | `APPSETTINGSPATH` | Chemin où l'installateur écrit `appsettings.json` lorsqu'il n'existe pas déjà. | Machine : `%ProgramData%\PowerShellUniversal\appsettings.json` ; par utilisateur : `%LocalAppData%\PowerShellUniversal\appsettings.json` | | `INSTALLTYPE` | Définit la valeur `Mode` écrite dans `appsettings.json`. `Desktop` écrit le mode Desktop ; toute autre valeur écrit le mode Server. | `Server` | | `STARTSERVICE` | Démarre le service Windows PowerShell Universal après l'installation. Ceci ne s'applique pas aux installations par utilisateur, car elles n'installent pas de service Windows. | Machine : `1` ; par utilisateur : `0` | | `SERVICEACCOUNT` | Compte de service Windows pleinement qualifié, tel que `CONTOSO\psu_svc`. Laissez vide pour exécuter en tant que Système local. Installations à l'échelle de la machine seulement. | Vide (Système local) | | `SERVICEACCOUNTPASSWORD` | Mot de passe pour `SERVICEACCOUNT`. L'installateur masque cette valeur dans son journal. Installations à l'échelle de la machine seulement. | Vide | | `OPENBROWSER` | Ouvre l'interface Web après le démarrage réussi du service Windows. Installations à l'échelle de la machine seulement. | `1` | | `ADDPSMODULEPATH` | Ajoute le répertoire du module PowerShell Universal à `PSModulePath`. | `1` | | `TELEMETRY` | Active la collecte de télémétrie anonyme. | `1` | | `STARTUPSHORTCUT` | Crée un raccourci de démarrage pour une installation par utilisateur. | Par utilisateur : `1` | ### Exemple L'exemple ci-dessous exécute une installation MSI silencieuse à l'échelle de la machine sans démarrer le service. Les valeurs de compte et de mot de passe sont des exemples seulement. {% 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 %} ## Installation ZIP Vous pouvez aussi télécharger le ZIP depuis notre [page de téléchargements](https://devolutions.net/download-center/powershell-universal/) si vous souhaitez déployer les fichiers par xcopy sous Windows ou Linux. ### Windows Vous pouvez démarrer Universal en décompressant le contenu, en débloquant les fichiers puis en exécutant `Universal.Server.exe`. ```powershell Expand-Archive -Path .\Universal.zip -DestinationPath .\Universal Get-ChildItem .\Universal -Recurse | Unblock-File Start-Process .\Universal\Universal.Server.exe ``` ### Linux Vous pouvez utiliser la ligne de commande suivante sous Linux pour installer et démarrer 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 ``` ## Service Linux Vous pouvez utiliser `systemd` pour démarrer PowerShell Universal en tant que service. Le script ci-dessous est un exemple de téléchargement d'une version de PowerShell Universal et de son installation en tant que service : ```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 # ---- ``` ## Module PowerShell Vous pouvez utiliser le module PowerShell de PowerShell Universal pour installer le serveur Universal. Pour installer le module, utilisez `Install-Module`. ```powershell Install-Module Devolutions.PowerShellUniversal ``` Pour installer le serveur Universal, vous pouvez utiliser `Install-PSUServer`. ```powershell Install-PSUServer -LatestVersion ``` L'exécution de cette commande sous Windows crée et démarre un service Windows sur votre machine. L'exécution de cette commande sous Linux crée et démarre un service systemd sur votre machine. L'exécution de cette commande sous Mac OS télécharge et extrait le serveur PowerShell Universal. ## Docker Consultez la page Docker. ## Installation IIS Veuillez consulter la documentation d'hébergement IIS pour savoir comment configurer PowerShell Universal en tant que site Web IIS. ## Configuration de l'antivirus PowerShell Universal tire pleinement parti de PowerShell et du SDK PowerShell. Il inclut des scripts PowerShell directement dans le produit. Envisagez de configurer l'antivirus pour permettre l'exécution des scripts PowerShell dans PowerShell Universal. ### Répertoires Les répertoires suivants contiennent des exemples, provenant d'un système Windows standard, de scripts et de fichiers exécutables que vous devrez peut-être exclure des vérifications antivirus. La modification des chemins dans appsettings.json ou dans l'installateur exige de changer les répertoires exclus. | Chemin | Description | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `%ProgramData%\PowerShellUniversal` | Contient les fichiers journaux et appsettings.json | | `%ProgramData%\UniversalAutomation` | Contient des scripts PowerShell et des artéfacts. Contient la base de données à fichier unique lorsque l'intégration SQL n'est pas utilisée. | | `%ProgramFiles%\Universal` | Contient les exécutables, les bibliothèques et les modules de l'application PowerShell Universal. | ### Exécutables Il peut être nécessaire d'exclure certains exécutables qui exécutent des scripts PowerShell. Vous trouverez ci-dessous une liste des exécutables qui exécutent PowerShell à partir de PowerShell Universal. | Nom | Description | | ---------------------------- | ------------------------------------------------------------- | | Universal.Server.exe | Le service principal de PowerShell Universal. | | PowerShellUniversal.Host.exe | L'exécutable de l'environnement hôte de PowerShell Universal. | | pwsh.exe | PowerShell 7.x | | PowerShell.exe | PowerShell 5.x | ## Nom et mot de passe d'administrateur par défaut Vous pouvez utiliser les variables d'environnement `$ENV:PSUDefaultAdminName` et `$ENV:PSUDefaultAdminPassword` pour modifier ce comportement. Ces valeurs sont utilisées uniquement si aucun compte administrateur n'existe déjà. Ceci est utile pour les installations infonuagiques. ## Agent Le PowerShell Universal Agent exécute les actions du Event Hub. Installez-le selon votre environnement : ### Windows (MSI) Le MSI de PowerShell Universal Agent se trouve sur notre page de téléchargement. Après l'installation du MSI, un service PowerShell Universal Agent s'exécute sur votre machine. Configurez-le pour qu'il se connecte à PowerShell Universal. ### ZIP Les fichiers ZIP pour chaque plateforme que nous prenons en charge se trouvent sur notre page de téléchargements. Chaque ZIP contient un fichier `PSUAgent.exe` ou `PSUAgent` qui peut démarrer un agent. Exécutez le processus en tant que service pour qu'il démarre chaque fois que la machine redémarre. ### Docker L'image de conteneur `devolutions/powershell-universal-agent:latest` fournit le PowerShell Universal Agent en tant que conteneur docker Linux. ``` docker pull devolutions/powershell-universal-agent:latest ``` ## Prochaines étapes À ce stade, Universal est opérationnel. Visitez `http://localhost:5000` ou votre port par défaut pour accéder à la console d'administration. Connectez-vous avec le nom et le mot de passe d'administrateur par défaut ou créez un compte administrateur par défaut. --- # 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/fr/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.