Grafische Oberfläche (GUI) für PowerShell-Scripts erstellen

Wenn die begrenzten Möglichkeiten von Out-GridView nicht reichen oder man einfach eine individuelle Oberfläche haben möchte, dann kann man dafür auf .NET-Klassen zurückgreifen. In diesem Artikel zeige ich, wie sich in wenigen Schritten eine PowerShell-GUI erstellen lässt. Zusatz­programme sind hierzu nicht erforderlich, die PowerShell ISE reicht.

Die ersten beiden Befehle laden die .NET-Erweiterungen (Assemblies) für die Gestaltung der grafischen Oberfläche in den Arbeitsspeicher:

[void] [System.Reflection.Assembly]::LoadWithPartialName("System.Drawing") [void] [System.Reflection.Assembly]::LoadWithPartialName("System.Windows.Forms")

Mit der nächsten Zeile wird aus der Forms-Bibliothek das eigentliche Fensterobjekt erstellt:

$objForm = New-Object System.Windows.Forms.Form

Ans Ende des Skriptes setze ich folgende Zeile:

[void] $objForm.ShowDialog()

Diese Anweisung sorgt dafür, dass unser Fenster überhaupt angezeigt wird.

Ein erster Test sollte jetzt so ausschauen:

Der bisherige Code erzeugt ein leeres Fenster ohne irgendeine Funktion.

Schön wäre ein weißer statt eines grauen Hintergrunds, so wie man es von vielen Windows-Anwendungen her kennt:

$objForm.Backcolor="white"

Alle, die es gerne etwas bunter haben möchte, können alternativ ein Hintergrundlogo einsetzen:

$objForm.BackgroundImageLayout = 2 $objForm.BackgroundImage =[System.Drawing.Image]::FromFile('C:\logos\xxxx.jpg')

Das BackgroundImageLayout=2 gibt die Formatierung des Bildes an. Spielen Sie hier gerne etwas mit verschiedenen Werten herum, es ist für jeden Geschmack etwas dabei.

Position und Größe des Fensters festlegen

Momentan öffnet sich unser Fenster beim Ausführen des Skriptes an beliebiger Stelle. Auch hat es noch keine vorgegebene Größe.

Die Position des Fensters wird festgelegt mit dem Befehl:

$objForm.StartPosition = "CenterScreen"

In diesem Beispiel erscheint es zentriert auf dem Bildschirm. Alternativ könnte man, wie weiter unten für Textelemente beschrieben, mit der Eigenschaft Location die genauen Koordinaten angeben.

Folgende Anweisung bestimmt die Größe des Fensters:

$objForm.Size = New-Object System.Drawing.Size(800,500)

Titelleiste bearbeiten

Die Überschrift in der Fensterleiste sollte Aufschluss darüber geben, welche Aufgabe unser Script erfüllt.

$objForm.Text = "Mein neues Fenster"

Für alle, die es etwas bunter mögen, lässt sich hier das Icon austauschen.

$objForm.Icon="C:\PowerShell\logos\xxxx.ico"

Text und Combobox

Text und Combobox erkläre ich zusammen, da es so mehr Sinn ergibt, und man das Ergebnis sofort prüfen kann.

Bei einem Text wird die Objektklasse "Label" aus der Forms-Assembly gebraucht. Dies schaut beispielsweise so aus:

$objLabel = New-Object System.Windows.Forms.Label $objLabel.Location = New-Object System.Drawing.Size(300,60) $objLabel.Size = New-Object System.Drawing.Size(800,20) $objLabel.Text = "Bitte geben sie einen Text ein:" $objForm.Controls.Add($objLabel)

Das Textelement kann etwa als Erläuterung über einem Eingabefeld stehen oder als Infotext irgendwo am Rand des Fensters. Folgendes Fragment erzeugt ein Eingabefeld, das man mit einem solchen Text-Label versehen könnte:

$objTextBox = New-Object System.Windows.Forms.TextBox $objTextBox.Location = New-Object System.Drawing.Size(300,100) $objTextBox.Size = New-Object System.Drawing.Size(200,20) $objForm.Controls.Add($objTextBox)

Combo/Listbox/Dropdown lässt sich ebenfalls ganz leicht erstellen und mit Hilfe des Textes um eine Überschrift ergänzen. Hier zuerst ein Beispiel für eine Listbox:

$objListbox = New-Object System.Windows.Forms.Listbox $objListbox.Location = New-Object System.Drawing.Size(300,80) $objListbox.Size = New-Object System.Drawing.Size(260,20) $objListbox.SelectionMode = "MultiExtended" [void] $objListbox.Items.Add("1. User") [void] $objListbox.Items.Add("2. Computer") [void] $objListbox.Items.Add("3. E-Mail") $objListbox.Height = 70 $objForm.Controls.Add($objListbox)

Und hier eines für eine ComboBox:

$objCombobox = New-Object System.Windows.Forms.Combobox # Die nächsten beiden Zeilen legen die Position und die Größe des Buttons fest $objCombobox.Location = New-Object System.Drawing.Size(300,80) $objCombobox.Size = New-Object System.Drawing.Size(200,20) $objCombobox.Height = 70 $objForm.Controls.Add($objCombobox) $objForm.Topmost = $True $objCombobox.Add_SelectedIndexChanged({ })

Den Inhalt einer solchen Listbox kann man entweder durch eine Abfrage füllen, die zum Beispiel alle Benutzer aus dem Active Directory zurückgibt, oder aber mit festen Parametern.

Buttons

Ohne Buttons ist die beste GUI nutzlos. In der Regel wird zumindest ein Button gebraucht, der einen Dialog wieder schließt oder eine Aktion ausführt, für die der Dialog geschaffen wurde.

$CancelButton = New-Object System.Windows.Forms.Button # Die nächsten beiden Zeilen legen die Position und die Größe des Buttons fest $CancelButton.Location = New-Object System.Drawing.Size(600,420) $CancelButton.Size = New-Object System.Drawing.Size(75,23) $CancelButton.Text = "Abbrechen" $CancelButton.Name = "Abbrechen" $CancelButton.DialogResult = "Cancel" #Die folgende Zeile ordnet dem Click-Event die Schließen-Funktion für das Formular zu $CancelButton.Add_Click({$objForm.Close()}) $objForm.Controls.Add($CancelButton)

Einen OK-Button erzeugt man nach dem gleichen Muster, wobei man dann für das Klick-Ereignis jene Funktion einträgt, für die der Dialog letztlich dient. Das könnte eine WMI-Abfrage, das Löschen von Dateien oder das Öffnen einer Remote-Session mit einem Computer aus der Listbox sein.

Beispiel-Script für Uptime

Auf Basis der hier beschriebenen GUI-Elemente habe ich ein Script erstellt, das alle Computer aus dem Active Directory ausliest und sie in ein Listenfeld einfügt. Wählt man von dort einen Namen aus, dann zeigt das Script die Uptime des betreffenden Rechners an.

Sie können das Script von hier herunterladen.