PowerShell-Skript ausführen

WMS 2020 (1.0.1)

Eigenschaften

Eingabe

Name	Beschreibung	Datentyp
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	WmsSettingMapping
Ressource verwenden	Kennzeichen, ob eine Ressourcen verwendet werden soll, statt eines Dateinamens	bool

Ausgabe

Name	Beschreibung	Datentyp	Erforderlich
Ergebnis	Das Ergebnis der Ausführung des Skripts. Leer, wenn das Skript kein Ergebnis liefert.	List<PSObject>

Fehlermeldungen

Beschreibung	Code	Datentyp
Die Datei "<Dateiname>" existiert nicht.	11101: EActivityMsgCode.File_NotExists	ActivityException
Der Zugriff auf das Verzeichnis ist Ihrem Mandanten nicht erlaubt ("<Dateiname>"). (siehe Mandanten)	11000: EActivityMsgCode.Dir_UnauthorizedAccess	ActivityException

Parameter

Die Eingabe von Parametern in das Skript ist aktuell noch nicht möglich. Alternativ können Sie in Ihrer Skript-Datei eigene Platzhalter einfügen, die Sie dann vor der Ausführung im Workflow mit den notwendigen Werten ersetzten.

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:

Powershell-Skript

Ausgabe

Workflow

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.

Weitere Beispiele

Viele weitere Beispiele und Anleitungen zur Anwendung von PowerShell-Skripten finden Sie auf den Seiten von Microsoft: → https://docs.microsoft.com/powershell.