WMS 2020 (1.0.1)
Die Aktivität führt ein beliebiges von Ihnen entwickelte Powershell-Skript aus einer Datei aus.
WMS 2.1.0
Mit einer überarbeiteten Version kann das PowerShell-Skript jetzt direkt angegeben werden. Ebenso können Parameter definiert und dem Skript übergeben werden.
Inhalt
Eigenschaften
Eingabe
Name | Beschreibung | Datentyp | Erforderlich |
|---|---|---|---|
Dateiname | Name der Datei, die das Skript enthält. | string |
|
Verzeichnis | Verzeichnis, in dem die Datei liegt | string |
|
Ressource | Ressourcedatei, die das Skript enthält, siehe dazu Ressourcen Einstellungen und Zuordnungen | ||
Ressource verwenden | Kennzeichen, ob eine Ressourcen verwendet werden soll, statt eines Dateinamens | bool | |
Text WMS 2.1.0 | Alternativ zur Angabe einer PowerShell-Skript-Datei können jetzt auch PowerShell-Befehle direkt in ein Textfeld eingegeben werden. | string | |
Parameter definieren… WMS 2.1.0 | Beim Klick auf die Schaltfläche öffnet sich ein Dialog, in dem Parameter definiert werden können, auf die bei der Ausführung des PowerShell-Skripts zugegriffen werden kann. | Auflistung |
Ausgabe
Name | Beschreibung | Datentyp | Erforderlich |
|---|---|---|---|
Ergebnis | Das Ergebnis der Ausführung des Skripts. Leer, wenn das Skript kein Ergebnis liefert. | List<PSObject> | |
Informationen WMS 2.1.0 | Meldungen, welche während der Ausführung des PowerShell-Skripts ausgegeben wurden. Im Skript können die Meldungen mit den Aufrufen von write-error, write-warning, write-information, etc. protokolliert werden. | List<PowerShellMessageItem> |
Parameter
Ab WMS 2.1.0 können Sie in der Aktivität auch Parameter definieren. Mit Klick auf die Schaltfläche “Parameter definieren…“ öffnet sich ein Dialog, in dem eine Liste von Parametern angelegt werden kann. Als Werte können beliebige Objekte verwendet werden.
Um im PowerShell-Skript auf die Parameter zugreifen zu können, müssen diese im Skript wie folgt definiert werden:
param( [string]$ParamString,
[Int]$ParamInt,
[double]$ParamDouble,
[datetime]$ParamDateTime)
Innerhalb von param(…) müssen die Parameter in einer Komma separierten Liste angegeben werden. Dabei ist vor dem Namen des Parameters das Zeichen “$” zu setzen (z.B. lautet für Parametername “ParamString” die Variable “$ParamString”).
Optional kann vor dem Variablennamen in eckigen Klammern der Datentyp angegeben werden (z.B. [string]$ParamString). Wir empfehlen dies, weil dadurch eine Differenz des Datentyps bei einem übergebenen Wert sofort zu einem Fehler führt und somit ein ungewolltes Verhalten bei der Ausführung des Skripts vermieden werden kann.
Ergebnis (PSObject)
Beispiel 1: String-Werte
Das Ergebnis der Aktivität ist eine Liste der Ausgaben aus dem Powershell-Script. Mittels ToString können sie den Wert aus dem PSObject ermitteln.
In folgenden Beispiel enthält die Liste zwei Werte:
Beispiel 2: Komplexe Ergebnistypen (z.B. von einem Web-Request)
Handelt es sich bei einer Rückgabe um einen komplexeren Typ, können dessen Eigenschaften über die Namen abgerufen werden.
Powershell-Skript:
$obj = [PSCustomObject]@{
Name = 'MyName'
Description = 'MyDescription'
State = 'ok'
}
Im Workflow:
psObject.Properties["Description"].Value.ToString()
Der Value der Eigenschaft ist dabei vom Typ "object". d.h. um damit weiter arbeiten zu können müssen Sie den Typ kennen und konvertieren.
Hinweise und Hilfe
Beachten Sie, dass das WMS das Skript weder verarbeitet noch auswertet oder prüft. Somit erfolgt auch keine Prüfung der Mandantenverzeichnisse.
Viele weitere Beispiele und Anleitungen zur Anwendung von PowerShell-Skripten finden Sie auf den Seiten von Microsoft: → https://docs.microsoft.com/powershell.