⬇️Installation

Instructions d'installation de PowerShell Universal.

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.

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 :

 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

Installation ZIP

Vous pouvez également télécharger le fichier ZIP depuis notre page de téléchargements 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.

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 :

 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 :

# ----
# 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 <<EOF > ~/$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.

Install-Module Devolutions.PowerShellUniversal

Pour installer le serveur Universal, vous pouvez utiliser Install-PSUServer.

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.

Installation IIS

Veuillez consulter la documentation d'hébergement IIS 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 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.