3.2.3.11. PowerShell

Dieser Step ruft Powershell auf und führt Befehle bzw. ein Skript in Powershell aus.

Die entsprechende Powershell-Version muss auf dem Server installiert sein.

Um diesen Step hinzufügen oder ausführen zu können, muss auf Serverebene in den Applikationseinstellungen Powershell aktiviert sein.

3.2.3.11.1. PowerShell-Step hinzufügen

• Wählen Sie den gewünschten Step aus:

• Wenn der Step ausgewählt wird, öffnet sich eine Übersicht:

3.2.3.11.2. Einstellungen (a)

• Die PowerShell-Version 5.1 - 64bit ist standardmäßig eingestellt.

• Bei der Verwendung von Powershell 7 sollte die Einstellung 6+ (Core) - 64 bit verwendet werden.

• Über ein Drop-down-Menü kann eine andere Version ausgewählt werden.

• Mit der im Drop-down ausgewählten Version von PowerShell führt OCT den PowerShell-Step aus.

• Ist die ausgewählte PowerShell-Version nicht vorhanden, dann zeigt OCT einen Fehler sowie Link zum notwendigen Download an. Nach der (Neu-)Installation der korrekten PowerShell-Version müssen Sie den OCT-Dienst neu starten.

3.2.3.11.3. Skript (b)

Aus Sicherheitsgründen kann nur ein Applikationsadministrator auf Serverebene mit den entsprechenden Rechten den Editor sehen.

3.2.3.11.3.1. Editor

• Der Editor ist ein Pflichtfeld.

• Im Editor kann ein PowerShell Skript für einen Datenabruf verfasst werden.

• Das Powershell Skript wird mit den Rechten des OCT Dienstbenutzers ausgeführt.

Icon “Skript-Editor öffnen”

Mit einem Linksklick auf das Icon kann ein separater Dialog mit einem vergrößerten Skript-Editor geöffnet werden.

3.2.3.11.3.2. Server-Dateisystem

3.2.3.11.4. Parameter (c)

• Im Step definierte Parameter sind im Skript in der Standard PowerShell Variable $args verfügbar.

• Einer Prozedur können beliebig viele Parameter übergeben werden - dazu zählen z.B. auch globale Parameter für Pipelines.

• Es können globale Parameter mit $[Variablenname] referenziert werden.

Nach dem Hinzufügen eines Steps muss dieser gespeichert werden. Danach kann über das Icon in der Menüleiste die Pipeline gestartet werden.

Während die Pipeline ausgeführt wird, erscheint solange ein sich drehender Kreis in der Pipelinezeile, bis der Prozess beendet ist.