> 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/de/getting-started.md). # Installation Installieren Sie PowerShell Universal mit dem MSI, ZIP oder PowerShell-Modul unter Windows und Linux, einschließlich Antivirus-Ausschlüssen und Standard-Administrator- Anmeldeinformationen. PowerShell Universal unterstützt Installationen als Windows-MSI, ZIP, PowerShell-Modul, Docker, IIS und Linux-Dienst. Wählen Sie die Methode, die zu Ihrer Hosting-Umgebung passt. ### Siehe auch * [Devolutions Academy – Installation](https://academy.devolutions.net/student/activity/3465938-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](https://devolutions.net/download-center/powershell-universal/) verfügbar. Systeminstallationen laufen als Windows-Dienst. Benutzerinstallationen werden ausgeführt, wenn sich der Benutzer am Computer anmeldet. Die Benutzerinstallation läuft im Kontext des Benutzers. ### MSI-Parameter Verwenden Sie Argumente in Großschreibung im Format `PROPERTY=value` mit `msiexec`. Die folgenden Standardwerte gelten für eine neue computerweite Installation, sofern kein benutzerspezifischer Standardwert aufgeführt ist. | Parameter | Beschreibung | Standardwert | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `INSTALLFOLDER` | Ordner, in dem PowerShell Universal installiert wird. | Computer: `%ProgramFiles%\Universal`; benutzerspezifisch: `%LocalAppData%\Programs\PowerShellUniversal` | | `MSIINSTALLPERUSER` | Installationsumfang. Setzen Sie den Wert auf `1` für eine benutzerspezifische Installation; setzen Sie ihn auf `0` für eine computerweite Installation. | `0` | | `TCPPORT` | HTTP-Port für den Server. | `5000` | | `HTTPSPORT` | HTTPS-Port, wenn `DEVCERT=1`. | `5001` | | `DEVCERT` | Erstellt und installiert ein localhost-Entwicklungszertifikat und aktiviert den HTTPS-Endpunkt. Bei benutzerspezifischen Installationen ist dies deaktiviert. | Computer: `1`; benutzerspezifisch: `0` | | `REPOFOLDER` | Repository-Ordner für PowerShell Universal-Konfigurationsdateien. | Computer: `%ProgramData%\UniversalAutomation\Repository`; benutzerspezifisch: `%LocalAppData%\PowerShellUniversal\Repository` | | `CONNECTIONSTRING` | Verbindungszeichenfolge für den ausgewählten Persistenzanbieter. | Computer: `Data Source=%ProgramData%\UniversalAutomation\database.db`; benutzerspezifisch: `Data Source=%LocalAppData%\PowerShellUniversal\database.db` | | `DATABASETYPE` | Persistenzanbieter. Gültige Werte sind `SQLite`, `PostgreSQL` und `Microsoft SQL Server`. | `SQLite` | | `APPSETTINGSPATH` | Pfad, in den das Installationsprogramm `appsettings.json` schreibt, wenn die Datei noch nicht vorhanden ist. | Computer: `%ProgramData%\PowerShellUniversal\appsettings.json`; benutzerspezifisch: `%LocalAppData%\PowerShellUniversal\appsettings.json` | | `INSTALLTYPE` | Legt den Wert `Mode` fest, der in `appsettings.json` geschrieben wird. `Desktop` schreibt den Desktop-Modus; jeder andere Wert schreibt den Server-Modus. | `Server` | | `STARTSERVICE` | Startet den PowerShell Universal-Windows-Dienst nach der Installation. Dies gilt nicht für benutzerspezifische Installationen, da diese keinen Windows-Dienst installieren. | Computer: `1`; benutzerspezifisch: `0` | | `SERVICEACCOUNT` | Vollqualifiziertes Windows-Dienstkonto, z. B. `CONTOSO\psu_svc`. Leer lassen, um als Local System zu laufen. Nur computerweite Installationen. | Leer (Local System) | | `SERVICEACCOUNTPASSWORD` | Passwort für `SERVICEACCOUNT`. Das Installationsprogramm maskiert diesen Wert in seinem Protokoll. Nur computerweite Installationen. | Leer | | `OPENBROWSER` | Öffnet die Web-Benutzeroberfläche, nachdem der Windows-Dienst erfolgreich gestartet wurde. Nur computerweite Installationen. | `1` | | `ADDPSMODULEPATH` | Fügt das PowerShell Universal-Modulverzeichnis zu `PSModulePath` hinzu. | `1` | | `TELEMETRY` | Aktiviert die anonyme Telemetrieerfassung. | `1` | | `STARTUPSHORTCUT` | Erstellt eine Startverknüpfung für eine benutzerspezifische Installation. | Benutzerspezifisch: `1` | ### Beispiel Das folgende Beispiel führt eine unbeaufsichtigte, computerweite MSI-Installation ohne Start des Dienstes aus. Die Werte für Konto und Passwort sind nur Beispiele. {% 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 %} ## ZIP-Installation Sie können das ZIP auch von unserer [Download-Seite](https://devolutions.net/download-center/powershell-universal/) herunterladen, wenn Sie die Dateien per xcopy unter Windows oder Linux bereitstellen möchten. ### Windows Sie können Universal starten, indem Sie den Inhalt entpacken, die Dateien freigeben und dann `Universal.Server.exe` ausführen. ```powershell Expand-Archive -Path .\Universal.zip -DestinationPath .\Universal Get-ChildItem .\Universal -Recurse | Unblock-File Start-Process .\Universal\Universal.Server.exe ``` ### Linux Sie können die folgende Befehlszeile unter Linux verwenden, um PowerShell Universal zu installieren und zu starten: ```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 ``` ## 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: ```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 # ---- ``` ## PowerShell-Modul Sie können das PowerShell Universal-PowerShell-Modul verwenden, um den Universal-Server zu installieren. Verwenden Sie `Install-Module`, um das Modul zu installieren. ```powershell Install-Module Devolutions.PowerShellUniversal ``` Um den Universal-Server zu installieren, können Sie `Install-PSUServer` verwenden. ```powershell 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 entpackt ihn. ## Docker Siehe die Docker-Seite. ## IIS-Installation 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 erlaubt ist. ### Verzeichnisse Die folgenden Verzeichnisse enthalten Beispiele aus einem Standard-Windows-System für Skripte und ausführbare Dateien, die Sie möglicherweise von Antivirus-Prüfungen ausschließen müssen. Werden Pfade in appsettings.json oder im Installationsprogramm geändert, müssen die ausgeschlossenen Verzeichnisse entsprechend angepasst werden. | 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%\Universal` | Enthält die ausführbaren Dateien, Bibliotheken und Module der PowerShell Universal-Anwendung. | ### Ausführbare Dateien Es kann erforderlich sein, bestimmte ausführbare Dateien auszuschließen, die PowerShell-Skripte ausführen. Nachfolgend finden Sie eine Liste der ausführbaren Dateien, 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 nützlich für Cloud-basierte Installationen. ## 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 läuft ein PowerShell Universal Agent-Dienst auf Ihrem Computer. Konfigurieren Sie ihn so, dass er sich mit PowerShell Universal verbindet. ### ZIP ZIP-Dateien für jede von uns unterstützte Plattform finden Sie auf unserer Download-Seite. Jedes ZIP enthält eine Datei `PSUAgent.exe` oder `PSUAgent`, mit der ein Agent gestartet werden 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 An diesem Punkt ist Universal betriebsbereit. Rufen Sie `http://localhost:5000` oder Ihren Standardport auf, um zur Administrationskonsole zu navigieren. Melden Sie sich mit dem Standard-Administratornamen und -Passwort an oder erstellen Sie ein Standard-Administratorkonto. --- # 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/de/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.