Power Shell aufrufen (Invoke Power Shell)

UiPath.Core.Activities.InvokePowerShell

Beschreibung

Die Aktivität „Invoke Power Shell“ führt einen PowerShell-Befehl oder ein Skript mit spezifischen Eingabeparametern aus.

Hinweis: Virenschutzrichtlinien, die den PowerShell-Zugriff einschränken, können die Verwendung von PowerShell-bezogenen Aktivitäten verhindern. Zum Beispiel können Sie Invoke Workflow File und Invoke Power Shell nicht verwenden, wenn die Regel-ID 6151 in McAfee Endpoint Security aktiviert ist.

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

• Befehlstext – Der auszuführende PowerShell-Befehl. Dieser Wert kann der Name eines cmdlets oder der Text eines PowerShell-Skripts sein.

Eigenschaften-Panel

Allgemein

• BeiFehlerFortfahren (ContinueOnError) - Gibt an, ob die Automatisierung auch bei Auftreten eines Fehlers weiterlaufen soll. Das Feld unterstützt nur Boolesche Werte (Wahr, Falsch). Der Standardwert ist Falsch. Dadurch wird die Ausführung des Projekts beim Auftreten eines Fehlers angehalten, wenn das Feld leer. Wenn der Wert auf Wahr gesetzt ist, wird das Projekt weiter ausgeführt, auch wenn Fehler auftreten.
  Hinweis: Wenn diese Aktivität in Try Catch enthalten ist und der Wert der Eigenschaft BeiFehlerFortsetzen auf „True“ gesetzt ist, wird kein Fehler beim Ausführen des Projekts aufgefangen.
• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Eingabe

• Parameter – Ein Verzeichnis an PowerShell-Befehlsparametern. Es kann ein bestimmter Befehl (cmdlet) oder Skript verwendet werden.
  • Bestimmter Befehl: Wenn Sie einen bestimmten Befehl aufrufen, muss der Name des Parameters mit dem Namen des Befehlsparameters übereinstimmen.
    Wenn Sie z. B. Get-Command -Module CimCmdlets als Eingabe verwenden, muss der Eingabewert Get-Command sein und der Parameter sollte Module heißen und der Wert auf "CimCmdlets" festgelegt sein.
  • Skript: Zu Beginn des Skripts müssen Sie den Typ des Parameters angeben. Optional können Sie auch einen Parameter als obligatorisch festlegen, um zu gewährleisten, dass ein Skript immer mit dem vom Aufrufer festgelegten Parameter aufgerufen wird.
    Das folgende Skript verwendet z. B. zwei Parameter, einen vom Typ string und einen anderen vom Typ int:

    Param(
       [Parameter(Mandatory=$true)]
       [string]$Name,
       [int]$Age
    )

    Auf diese Parameter kann dann im Skript verwiesen werden, indem $ vor dem Parameternamen hinzugefügt wird.

• Eingabe – Eine Sammlung von PSObjekten, die an den Schreiber der Pipeline übergeben wird, um den Befehl auszuführen. Kann die Ausgabe einer anderen Aktivität vom Typ „InvokePowerShell“ sein. Sie können auf weitergeleitete Eingaben in einem Skript verweisen, indem Sie $input verwenden.
  Hinweis: Diese Variable wird implizit von PowerShell erstellt. Das Definieren von Variablen oder Parametern namens input kann Fehler generieren oder zu Konflikten führen. Es wird empfohlen, den Begriff input für Piping zu reservieren.

Sonstiges

• Ausführungsmodus – Wählen Sie eine Version von PowerShell aus, in der der bereitgestellte Befehl oder das Skript ausgeführt werden soll. Dies ist nur für Windows-Projekte verfügbar. Windows-Legacy-Projekte zielen auf die Version 5.1 (32-Bit) von Windows PowerShell ab.

  Die folgenden Optionen sind verfügbar:

  • PowerShell 7.2 (64-Bit) – Verwendet die PowerShell Core-Shell basierend auf .NET6. In dieser Version wird PowerShell in der .NET 6-Laufzeit gehostet. Alle verwendeten Daten sind für die Aktivität direkt zugänglich und können in den Workflow importiert werden.
  • PowerShell 5.1 (64-Bit) – Verwendet die ausführbare 64-Bit-Windows PowerShell-Datei. In dieser Version ist PowerShell mit Windows gebündelt und befindet sich standardmäßig in C:\Windows\System32\WindowsPowerShell\v1.0\. In diesem Ausführungsmodus wird PowerShell lokal auf der Maschine mithilfe der vorinstallierten Shell remote ausgeführt. Remoting führt dazu, dass Informationen zwischen verschiedenen .NET-Laufzeiten serialisiert und deserialisiert werden müssen, so dass Objekte, die nicht rekonstruiert werden können, in ein PSObject oder PSCustomObject verpackt werden.
  • PowerShell 5.1 (32-Bit) – Verwendet die ausführbare 32-Bit-Windows PowerShell-Datei. In dieser Version ist PowerShell mit Windows gebündelt und befindet sich standardmäßig in C:\Windows\SysWOW64\WindowsPowerShell\v1.0\. In diesem Ausführungsmodus wird PowerShell lokal auf der Maschine mithilfe der vorinstallierten Shell remote ausgeführt. Remoting führt dazu, dass Informationen zwischen verschiedenen .NET-Laufzeiten serialisiert und deserialisiert werden müssen, so dass Objekte, die nicht rekonstruiert werden können, in ein PSObject oder PSCustomObject verpackt werden. PSObject und PSCustomObjects enthalten Informationen über die Gesamtstruktur des ursprünglichen Objekts und können verwendet werden, um die Objekte manuell zu rekonstruieren.
• IstSkript – Gibt an, ob der Befehlstext ein Skript oder ein direkter Befehl ist. Piping, Variablen und Parameter können mit einem einzelnen Befehl oder Skript verwendet werden.
• PowerShellVariablen – Ein Verzeichnis mit benannten Objekten, die Variablen darstellen, die in der aktuellen Sitzung der InvokePowerShell-Aktivität verwendet werden. Ein PowerShell-Befehl oder -Skript kann Informationen von In- und In/Out-Variablen abrufen und Out-Variablen festlegen. Um auf Variablen in Ihrem Skript zu verweisen, verwenden Sie das Variablenbezeichnerzeichen $, um anzugeben, dass der Text danach ein Variablenname ist. Beispiel: $firstVariable.
  Hinweis: Bei den Variablennamen wird nicht zwischen Groß- und Kleinschreibung unterschieden.
• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.
• TypArgument (TypeArgument) - Setzt den Typ der Ausgabevariable.

Ausgabe

• Ausgabe (Output) - Eine Sammlung von Objekten vom Typ TypArgument (TypeArgument), die durch Ausführung des Befehls zurückgegeben wird. Kann als Pipe über mehrere Aktivitäten vom Typ AufrufenPowerShell (InvokePowerShell) verwendet werden.