> 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 ## 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 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` für Automatisierungszwecke mit unserer 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 Dienstkontopasswort, das für den Windows-Dienst festgelegt werden soll. Das Passwort wird im Installationsprotokoll mit \*\*\* maskiert. | Keiner | | TELEMETRY | Anonyme Telemetriedatenerfassung | 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 eine 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: {% 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 %} ## ZIP-Installation Sie können die ZIP-Datei auch von unserer [Downloads-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://powershelluniversal.com/download/psu/linux-x64/latest 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 dafür, wie eine Version von PowerShell Universal heruntergeladen und als Dienst installiert wird: ```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 # ---- ``` ## 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`. ```powershell Install-Module Devolutions.PowerShellUniversal ``` Um den Universal-Server zu installieren, können Sie `Install-PSUServer` verwenden. ```powershell Install-PSUServer -LatestVersion ``` Wenn Sie diesen Befehl unter Windows ausführen, wird ein Windows-Dienst auf Ihrem Computer erstellt und gestartet. Wenn Sie diesen Befehl unter Linux ausführen, wird ein systemd-Dienst auf Ihrem Computer erstellt und gestartet. Wenn Sie diesen Befehl unter Mac OS ausführen, wird der PowerShell Universal-Server heruntergeladen und extrahiert. ## Docker Siehe die [Docker-Seite](/powershell-universal/de/getting-started/docker.md#installation). ## IIS-Installation Informationen dazu, wie Sie PowerShell Universal als IIS-Website konfigurieren, finden Sie in der [IIS-Hosting-Dokumentation](/powershell-universal/de/config/hosting/hosting-iis.md). ## Antivirus-Konfiguration PowerShell Universal nutzt PowerShell und das PowerShell SDK vollständig aus. Es enthält PowerShell-Skripte direkt im Produkt. Erwägen Sie, den Antivirus so zu konfigurieren, dass die Ausführung von PowerShell-Skripten in PowerShell Universal zugelassen wird. ### Verzeichnisse Die folgenden Verzeichnisse enthalten Beispiele von einem Standard-Windows-System für Skripte und ausführbare Dateien, die Sie möglicherweise von Antivirus-Prüfungen ausschließen müssen. Wenn Sie Pfade in appsettings.json oder im Installationsprogramm ändern, müssen Sie auch ändern, welche Verzeichnisse ausgeschlossen 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(x86)\Universal | Enthält ausführbare Programmdateien, Bibliotheken und Module der PowerShell Universal-Anwendung. | ### Ausführbare Programmdateien Es kann notwendig 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 für Cloud-basierte Installationen nützlich. ## Agent Der PowerShell Universal Agent führt Event Hub-Aktionen aus. Installieren Sie ihn abhängig von Ihrer Umgebung: ### Windows (MSI) Die MSI des PowerShell Universal Agent befindet sich auf unserer Download-Seite. Nach der Installation der MSI wird ein PowerShell Universal Agent-Dienst auf Ihrem Computer ausgeführt. [Konfigurieren Sie ihn](/powershell-universal/de/api/event-hubs.md), um sich mit PowerShell Universal zu verbinden. ### ZIP ZIP-Dateien für jede von uns unterstützte Plattform befinden sich auf unserer Downloads-Seite. Jede ZIP-Datei 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 Admin-Konsole 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.