| Status | ||||
|---|---|---|---|---|
|
Die Aktivität führt ein beliebiges von Ihnen entwickelte Powershell-Skript aus einer Datei aus.
| Status | ||||
|---|---|---|---|---|
|
Mit einer überarbeiteten Version kann das PowerShell-Skript jetzt direkt angegeben werden. Ebenso können Parameter definiert und dem Skript übergeben werden.
Inhalt
| 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
| Alternativ zur Angabe einer PowerShell-Skript-Datei können jetzt auch PowerShell-Befehle direkt in ein Textfeld eingegeben werden. | string | |||||||
Parameter definieren…
| 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
| 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
| Status | ||||
|---|---|---|---|---|
|
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:
| Codeblock | ||
|---|---|---|
| ||
$obj = [PSCustomObject]@{
Name = 'MyName'
Description = 'MyDescription'
State = 'ok'
} |
Im Workflow:
| Codeblock | ||
|---|---|---|
| ||
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
| Info |
|---|
Beachten Sie, dass das WMS das Skript weder verarbeitet noch auswertet oder prüft. Somit erfolgt auch keine Prüfung der Mandantenverzeichnisse. |
| Info |
|---|
Beachten Sie auch, dass die Accantum GmbH keine Verantwortung für Schäden übernimmt, welche durch die Ausführung von Skripten verursacht werden. Das WMS hat keinen Einfluss auf die Skripten und kann deren Inhalt auch nicht prüfen. Mit einem PowerShell-Skript können sicherheitsrelevante Einschränkungen umgangen und somit nicht gewollte Aktionen ausgeführt werden. |
Viele weitere Beispiele und Anleitungen zur Anwendung von PowerShell-Skripten finden Sie auf den Seiten von Microsoft: → https://docs.microsoft.com/powershell.