> 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 ## Installation MSI (Windows) L'installation MSI crée un service PowerShell Universal. Par défaut, PowerShell Universal écoute sur le port 5000. Vous pouvez accéder à `http://localhost:5000` Les téléchargements MSI sont disponibles sur notre [page de téléchargement](https://ironmansoftware.com/downloads). Les installations système s'exécutent en tant que service Windows. Les installations utilisateur s'exécutent lorsque l'utilisateur ouvre une session sur la machine. L'installation utilisateur s'exécute dans le contexte de l'utilisateur. ### Paramètres MSI Le tableau suivant contient les paramètres que vous pouvez spécifier lors de l'exécution de `msiexec` sur notre installation MSI à des fins d'automatisation : | Paramètre | Description | Valeur par défaut | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | | INSTALLFOLDER | Le dossier d'installation de PowerShell Universal | %ProgramFiles(x86)%\Universal | | TCPPORT | Le port TCP sur lequel le serveur HTTP écoutera. | 5000 | | REPOFOLDER | Le dossier du référentiel dans lequel enregistrer les fichiers de configuration. | %ProgramData%\UniversalAutomation\Repository | | CONNECTIONSTRING | La chaîne de connexion SQL, SQLite ou PostgreSQL. | Data Source=%ProgramData%\UniversalAutomation\database.db | | DATABASETYPE | SQL, SQLite ou PostgreSQL | SQLite | | STARTSERVICE | Indique si le service doit démarrer après l'installation (0 ou 1) | 1 | | SERVICEACCOUNT | Le compte de service à définir pour le service Windows. Utilisez le format domaine\nomutilisateur. | None | | SERVICEACCOUNTPASSWORD | Le mot de passe du compte de service à définir pour le service Windows. Le mot de passe sera masqué par des \*\*\* dans le journal d'installation. | None | | TELEMETRY | Collecte de télémétrie anonyme | 0 | | ADDPSMODULEPATH | Ajoute le répertoire de modules de PowerShell Universal à la variable d'environnement PSModulePath. | 1 | | STARTSERVICE | Indique si le service doit démarrer après l'installation. | 1 | | INSTALLTYPE | Indique s'il faut effectuer une installation serveur ou utilisateur. | Server | ### Exemple L'exemple ci-dessous montre comment exécuter `msiexec.exe` pour installer PowerShell Universal et fournir des paramètres au programme d'installation : {% code overflow="wrap" %} ```powershell Start-Process msiexec.exe -ArgumentList "/I C:\Users\adamr\Downloads\PowerShellUniversal.5.5.2.msi /q /norestart /L*V `"C:\users\adamr\desktop\msi.log.txt`" STARTSERVICE=0 SERVICEACCOUNT=contoso\service_account SERVICEACCOUNTPASSWORD=ThisPasswordWillBeReplacedWithAsterisksInTheMSILogs" -Wait -NoNewWindow ``` {% endcode %} ## Installation ZIP Vous pouvez également télécharger le fichier ZIP depuis notre [page de téléchargements](https://ironmansoftware.com/downloads/) si vous souhaitez déployer les fichiers par copie sur 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 sur Linux pour installer et démarrer PowerShell Universal : ```bash wget -O psu.zip https://powershelluniversal.com/download/psu/linux-x64/latest 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="5.5.2" # Change this to the current version PSU_ARCH="arm64" # Change this to your desired architecture PSU_FILE="Universal.linux-${PSU_ARCH}.${PSU_VERSION}.zip" PSU_URL="https://imsreleases.blob.core.windows.net/universal/production/${PSU_VERSION}/${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_FILE 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 sur Windows crée et démarre un service Windows sur votre machine. L'exécution de cette commande sur Linux crée et démarre un service systemd sur votre machine. L'exécution de cette commande sur Mac OS télécharge et extrait le serveur PowerShell Universal. ## Docker Consultez la [page Docker](/powershell-universal/fr/getting-started/docker.md#installation). ## Installation IIS Veuillez consulter la [documentation d'hébergement IIS](/powershell-universal/fr/config/hosting/hosting-iis.md) pour obtenir des informations sur la configuration de 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 autoriser 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 pourriez avoir besoin d'exclure des vérifications antivirus. La modification des chemins dans appsettings.json ou dans le programme d'installation nécessite de modifier les répertoires exclus. | Chemin | Description | | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | %ProgramData%\PowerShellUniversal | Contient les fichiers journaux et appsettings.json | | %ProgramData%\UniversalAutomation | Contient les scripts PowerShell et les artefacts. Contient la base de données en fichier unique lorsque l'intégration SQL n'est pas utilisée. | | %ProgramFiles(x86)\Universal | Contient les exécutables, bibliothèques et modules de l'application PowerShell Universal. | ### Exécutables Il peut être nécessaire d'exclure certains exécutables qui exécutent des scripts PowerShell. Voici une liste des exécutables qui exécutent PowerShell depuis 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 ne sont utilisées que si aucun compte administrateur n'existe déjà. Cela est utile pour les installations en nuage. ## Agent L'agent PowerShell Universal exécute les actions Event Hub. Installez-le en fonction de votre environnement : ### Windows (MSI) Le MSI de l'agent PowerShell Universal est disponible sur notre page de téléchargement. Après l'installation du MSI, un service d'agent PowerShell Universal s'exécute sur votre machine. [Configurez-le](/powershell-universal/fr/api/event-hubs.md) pour le connecter à PowerShell Universal. ### ZIP Les fichiers ZIP pour chaque plateforme que nous prenons en charge sont disponibles 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 redémarrage de la machine. ### Docker L'image de conteneur `devolutions/powershell-universal-agent:latest` fournit l'agent PowerShell Universal sous forme de conteneur Docker Linux. ``` docker pull devolutions/powershell-universal-agent:latest ``` ## Étapes suivantes À ce stade, Universal est opérationnel. Accédez à `http://localhost:5000` ou à votre port par défaut pour naviguer vers 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: ``` GET https://docs.devolutions.net/powershell-universal/fr/getting-started.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.