Invoke Power Shell

Invoke PowerShell activity that executes a PowerShell command or script with specified input parameters.

UiPath.Core.Activities.InvokePowerShell

Beschreibung

The Invoke PowerShell activity executes a PowerShell command or script with specified input parameters.

Hinweis:

Antivirus policies that restrict PowerShell access may prevent the use of PowerShell-related activities. For example, you cannot use Invoke Workflow File and Invoke PowerShell when rule ID 6151 is enabled in McAfee Endpoint Security.

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

• Fortfahren bei Fehler (Continue On Error) – Gibt an, ob die Automation fortgesetzt werden soll, auch wenn die Aktivität einen Fehler ausgibt. Dieses Feld unterstützt nur boolesche Werte (wahr, falsch). Der Standardwert ist falsch. Als Ergebnis ist das Feld leer und ein Fehler wird ausgegeben; die Ausführung des Projekts wird angehalten. Wenn der Wert auf Wahr gesetzt wird, wird die Ausführung des Projekts unabhängig von Fehlern fortgesetzt.
  Hinweis:

  Wenn die Aktivität in Abfangen versuchen (Try Catch) enthalten ist und der Wert der Eigenschaft BeiFehlerFortfahren (ContinueOnError) auf Wahr (True) gesetzt ist, wird kein Fehler bei der Ausführung des Projekts abgefangen.

• 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.

• Input - A collection of PSObjects that are passed to the writer of the pipeline used to execute the command. Can be the output of another Invoke PowerShell activity. You can reference piped input in a script by using $input.
  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.

Optionen

• 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.
• 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.15 (64-Bit) – Verwendet die PowerShell Core-Shell basierend auf .NET6. In dieser Version wird PowerShell innerhalb der.NET 6-Runtime 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.
• PowerShellVariables - A dictionary of named objects that represent variables used within the current session of the Invoke PowerShell activity. A PowerShell command or script can retrieve information from In and In/Out variables and can set Out variables. To reference variables in your script, use the variable identifier character $ to denote that the text after is a variable name. Example: $firstVariable.
  Hinweis:

  Bei Variablennamen wird nicht zwischen Groß- und Kleinschreibung unterschieden.

• Aktueller Typ – Legt den Typ der in der Ausgabe zurückgegebenen Objekte fest.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Ausgabe

• Output - A collection of objects of the type set in Current type, returned by the execution of the command. Can be used to pipe several Invoke PowerShell activities.