⏯️Erste Schritte

PowerShell Universal installieren

Sie müssen den PowerShell Universal-Server installieren. Es gibt viele Möglichkeiten, dies zu tun, aber Sie können die untenstehende Befehlszeile verwenden, um schnell zu starten:

Windows

Sie können PowerShell Universal als Dienst installieren. Stellen Sie sicher, dass PowerShell als Administrator ausgeführt wird, andernfalls wird der Dienst nicht korrekt installiert.

Install-Module Devolutions.PowerShellUniversal
Install-PSUServer

Linux

Sie können PowerShell Universal mit dem folgenden Shell-Skript installieren:

Install-Module Devolutions.PowerShellUniversal
Install-PSUServer

Mac OS X

Sie können PowerShell Universal mit dem Universal PowerShell-Modul installieren:

Install-Module Devolutions.PowerShellUniversal
Install-PSUServer -AddToPath
Start-PSUServer -Port 5000

Raspberry PI OS

wget https://imsreleases.blob.core.windows.net/universal/production/2.4.0/Universal.linux-arm.2.4.0.zip
unzip Universal.linux-arm.2.3.2.zip -d ./PSU
chmod +x ./PSU/Universal.Server
./PSU/Universal.Server

PowerShell Universal öffnen

Standardmäßig läuft PowerShell Universal auf Port 5000 von localhost. Öffnen Sie einen Webbrowser und navigieren Sie zu http://localhost:5000.

Mit einem Devolutions Account anmelden

Wenn Sie zum ersten Mal zu PowerShell Universal navigieren, können Sie sich mit einem Devolutions Account anmelden, um eine kostenlose Entwicklerlizenz zu erhalten. Diese Lizenz aktiviert alle Funktionen und ist für Workflows außerhalb der Produktion vorgesehen.

Dieser Ablauf für die Entwicklerlizenz ist für die lokale Entwicklung vorgesehen und erfordert lokalen Zugriff auf den PowerShell Universal-Host. Wenn Benutzer auf PSU nur über Remote-Browser via Docker, IIS oder einen Reverse-Proxy zugreifen, sollten sie stattdessen einen der Standard-Lizenzwege verwenden.

First Run-Assistent

Optional können Sie auch den First Run-Assistenten ausführen, anstatt sich mit einem Devolutions Account anzumelden, und einen Lizenzschlüssel angeben.

Eine API erstellen

APIs ermöglichen es Ihnen, PowerShell-Skripte über HTTP aufzurufen. Um eine API zu erstellen, klicken Sie auf API \ Endpoints und dann auf Create New Endpoint. Geben Sie eine URL an. Deaktivieren Sie die Authentifizierung für diesen Endpunkt.

Klicken Sie anschließend bei Ihrer neuen API auf Details und geben Sie den folgenden Befehl in den Editor ein:

Get-ComputerInfo

Speichern Sie das Skript und klicken Sie dann auf die Schaltfläche Execute, um es zu testen.

Sie können die API auch über Invoke-RestMethod ausführen.

PS C:\Users\adamr> Invoke-RestMethod http://localhost:5000/hello-world

WindowsBuildLabEx                                       : 22000.1.amd64fre.co_release.210604-1628
WindowsCurrentVersion                                   : 6.3
WindowsEditionId                                        : Professional
WindowsInstallationType                                 : Client
WindowsInstallDateFromRegistry                          : 8/6/2021 4:05:12 PM
WindowsProductId                                        : 00330-52452-93139-AAOEM
WindowsProductName                                      : Windows 10 Pro
WindowsRegisteredOrganization                           :

Ein Skript erstellen

Um ein Skript zu erstellen, klicken Sie auf Automation \ Scripts und dann auf Create New Script.

Geben Sie das folgende Skript in den Editor ein und speichern Sie es:

Read-Host "What should I say?"

1..100 | ForEach-Object {
    Write-Progress -PercentComplete $_ -Activity "Processing..."
}

Get-Service

Sobald das Skript gespeichert ist, klicken Sie auf Run.

Eine App erstellen

Um eine neue PowerShell-basierte Benutzeroberfläche (App) zu erstellen, können Sie auf User Interfaces \ Apps und dann auf Create New App klicken.

Nachdem Sie auf Ok geklickt haben, klicken Sie auf die Schaltfläche Details, um das PowerShell-Skript zu bearbeiten. Fügen Sie das folgende Skript in den Editor ein:

New-UDApp -Title "Hello, World!" -Content {
    New-UDButton -Text "Click Me" -OnClick {
        Show-UDToast -Message 'Success!!'
    }
}

Speichern Sie die App, klicken Sie auf die Schaltfläche Restart und dann auf die Schaltfläche View. Klicken Sie auf die Schaltfläche Click Me.

Erfahren Sie mehr über die verschiedenen Funktionen von PowerShell Universal:

• APIs
• Automatisierung
• Apps

Siehe auch

• Devolutions Academy – Installation