⬇️Installation

MSI-Installation (Windows)

Die MSI-Installation erstellt einen PowerShell Universal-Dienst. Standardmäßig lauscht PowerShell Universal auf Port 5000. Sie können zu http://localhost:5000 navigieren

MSI-Downloads sind auf unserer Download-Seite verfügbar.

Systeminstallationen werden als Windows-Dienst ausgeführt. Benutzerinstallationen werden ausgeführt, wenn sich der Benutzer am Computer anmeldet. Die Benutzerinstallation wird im Kontext des Benutzers ausgeführt.

MSI-Parameter

Die folgende Tabelle enthält die Parameter, die Sie angeben können, wenn Sie msiexec zu Automatisierungszwecken für unsere MSI-Installation ausführen:

Parameter	Beschreibung	Standardwert
INSTALLFOLDER	Der Installationsordner für PowerShell Universal	%ProgramFiles(x86)%\Universal
TCPPORT	Der TCP-Port, auf dem der HTTP-Server lauschen wird.	5000
REPOFOLDER	Der Repository-Ordner, in dem die Konfigurationsdateien gespeichert werden.	%ProgramData%\UniversalAutomation\Repository
CONNECTIONSTRING	Die SQL-, SQLite- oder PostgreSQL-Verbindungszeichenfolge.	Data Source=%ProgramData%\UniversalAutomation\database.db
DATABASETYPE	SQL, SQLite oder PostgreSQL	SQLite
STARTSERVICE	Ob der Dienst nach der Installation gestartet werden soll (0 oder 1)	1
SERVICEACCOUNT	Das Dienstkonto, das für den Windows-Dienst festgelegt werden soll. Verwenden Sie das Format domain\username.	Keiner
SERVICEACCOUNTPASSWORD	Das Dienstkontokennwort, das für den Windows-Dienst festgelegt werden soll. Das Passwort wird im Installationsprotokoll mit *** maskiert.	Keiner
TELEMETRY	Anonyme Telemetrieerfassung	0
ADDPSMODULEPATH	Fügt das PowerShell Universal-Modulverzeichnis der Umgebungsvariablen PSModulePath hinzu.	1
STARTSERVICE	Ob der Dienst nach der Installation gestartet werden soll.	1
INSTALLTYPE	Ob eine Server- oder Benutzerinstallation durchgeführt werden soll.	Server

Beispiel

Das folgende Beispiel zeigt, wie msiexec.exe ausgeführt wird, um PowerShell Universal zu installieren und dem Installationsprogramm Parameter zu übergeben:

 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

ZIP-Installation

Sie können das ZIP auch von unserer Downloads-Seite herunterladen, wenn Sie die Dateien unter Windows oder Linux per xcopy bereitstellen möchten.

Windows

Sie können Universal starten, indem Sie den Inhalt entpacken, die Dateien freigeben und dann Universal.Server.exe ausführen.

Expand-Archive -Path .\Universal.zip -DestinationPath .\Universal
Get-ChildItem .\Universal -Recurse | Unblock-File
Start-Process .\Universal\Universal.Server.exe

Linux

Laden Sie das Linux-ZIP-Paket von der Download-Seite herunter und verwenden Sie dann die folgende Befehlszeile, um PowerShell Universal zu installieren und zu starten:

 sudo apt install unzip 
 unzip psu.zip -d PSU
 chmod +x ./PSU/Universal.Server
 ./PSU/Universal.Server

Linux-Dienst

Sie können systemd verwenden, um PowerShell Universal als Dienst zu starten. Das folgende Skript ist ein Beispiel für das Herunterladen einer Version von PowerShell Universal und deren Installation als Dienst:

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

PowerShell-Modul

Sie können das PowerShell Universal PowerShell-Modul verwenden, um den Universal-Server zu installieren. Verwenden Sie zum Installieren des Moduls Install-Module.

Install-Module Devolutions.PowerShellUniversal

Um den Universal-Server zu installieren, können Sie Install-PSUServer verwenden.

Install-PSUServer -LatestVersion

Das Ausführen dieses Befehls unter Windows erstellt und startet einen Windows-Dienst auf Ihrem Computer. Das Ausführen dieses Befehls unter Linux erstellt und startet einen systemd-Dienst auf Ihrem Computer. Das Ausführen dieses Befehls unter Mac OS lädt den PowerShell Universal-Server herunter und extrahiert ihn.

Docker

Siehe die Docker-Seite.

IIS-Installation

Weitere Informationen zur Konfiguration von PowerShell Universal als IIS-Website finden Sie in der IIS-Hosting-Dokumentation.

Antivirus-Konfiguration

PowerShell Universal nutzt PowerShell und das PowerShell SDK vollständig aus. Es enthält PowerShell-Skripte direkt im Produkt. Erwägen Sie, Ihr Antivirenprogramm so zu konfigurieren, dass die Ausführung von PowerShell-Skripten in PowerShell Universal zugelassen wird.

Verzeichnisse

Die folgenden Verzeichnisse enthalten Beispiele eines Standard-Windows-Systems für Skripte und ausführbare Dateien, die Sie möglicherweise von Antivirenprüfungen ausschließen müssen. Das Ändern von Pfaden in der appsettings.json oder im Installationsprogramm erfordert eine Änderung der ausgeschlossenen Verzeichnisse.

Pfad	Beschreibung
%ProgramData%\PowerShellUniversal	Enthält Protokolldateien und appsettings.json
%ProgramData%\UniversalAutomation	Enthält PowerShell-Skripte und Artefakte. Enthält die Einzeldatei-Datenbank, wenn keine SQL-Integration verwendet wird.
%ProgramFiles(x86)\Universal	Enthält ausführbare Programmdateien, Bibliotheken und Module der PowerShell Universal-Anwendung.

Ausführbare Programmdateien

Es kann erforderlich sein, bestimmte ausführbare Programmdateien auszuschließen, die PowerShell-Skripte ausführen. Nachfolgend finden Sie eine Liste der ausführbaren Programmdateien, die PowerShell aus PowerShell Universal ausführen.

Name	Beschreibung
Universal.Server.exe	Der PowerShell Universal-Kerndienst.
PowerShellUniversal.Host.exe	Die ausführbare Programmdatei der PowerShell Universal-Hostumgebung.
pwsh.exe	PowerShell 7.x
PowerShell.exe	PowerShell 5.x

Standard-Administratorname und -Passwort

Sie können die Umgebungsvariablen $ENV:PSUDefaultAdminName und $ENV:PSUDefaultAdminPassword verwenden, um dieses Verhalten zu ändern. Diese Werte werden nur verwendet, wenn noch kein Administratorkonto vorhanden ist. Dies ist bei Cloud-basierten Installationen nützlich.

Agent

Der PowerShell Universal Agent führt Event Hub-Aktionen aus. Installieren Sie ihn je nach Ihrer Umgebung:

Windows (MSI)

Das MSI des PowerShell Universal Agent finden Sie auf unserer Download-Seite. Nach der Installation des MSI wird ein PowerShell Universal Agent-Dienst auf Ihrem Computer ausgeführt. Konfigurieren Sie ihn, um eine Verbindung zu PowerShell Universal herzustellen.

ZIP

ZIP-Dateien für jede von uns unterstützte Plattform finden Sie auf unserer Downloads-Seite. Jedes ZIP enthält eine Datei PSUAgent.exe oder PSUAgent, die einen Agenten starten kann. Führen Sie den Prozess als Dienst aus, damit er bei jedem Neustart des Computers gestartet wird.

Docker

Das Container-Image devolutions/powershell-universal-agent:latest stellt den PowerShell Universal Agent als Linux-Docker-Container bereit.

docker pull devolutions/powershell-universal-agent:latest

Nächste Schritte

Zu diesem Zeitpunkt ist Universal betriebsbereit. Rufen Sie http://localhost:5000 oder Ihren Standardport auf, um zur Admin-Konsole zu navigieren. Melden Sie sich mit dem Standard-Administratornamen und -Passwort an oder erstellen Sie ein Standard-Administratorkonto.

Siehe auch

• Devolutions Academy – Installation