Invocar PowerShell

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

UiPath.Core.Activities.InvokePowerShell

Descripción

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

Nota:

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.

Compatibilidad de Proyectos

Windows: heredado | Windows

Configuración

• TextoDeComando : el comando de PowerShell que se ejecutará. Este valor puede ser el nombre de un cmdlet o el texto de un script de PowerShell.

Panel de propiedades

Común

• ContinuarEnCasoDeError: especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Por lo tanto, si el campo está vacío y se produce un error, se detiene la ejecución del proyecto. Si el valor es Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.
  Nota:

  Si esta actividad se incluye en Intentar capturar y el valor de la propiedad Continuar en caso de error es Verdadero, no se captura ningún error cuando se ejecuta el proyecto.

• Nombre para mostrar: el nombre para mostrar de la actividad.

Entrada

• Parámetros : un diccionario de parámetros de comandos de PowerShell. Se puede utilizar un comando específico (cmdlet) o script.
  • Comando específico: al invocar un comando específico, el nombre del parámetro debe coincidir con el nombre del parámetro del comando.

Por ejemplo, si utilizas Get-Command -Module CimCmdlets como entrada, el valor de entrada debe ser Get-Command y el parámetro debe llamarse Module con el valor establecido en "CimCmdlets".

• Script: al inicio del script debes especificar el tipo de parámetro . Opcionalmente, también puedes hacer que un parámetro sea obligatorio para forzar que un script sea llamado siempre con el parámetro establecido por el llamador.

Por ejemplo, el siguiente script toma dos parámetros, uno de tipo string y otro de tipo int:

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

Se puede hacer referencia a estos parámetros en el script añadiendo $ delante del nombre del parámetro.

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

  PowerShell crea implícitamente esta variable. Definir variables o parámetros con nombre input puede generar errores o dar lugar a conflictos. Se recomienda reservar el término input para la canalización.

Opciones

• IsScript : especifica si el texto del comando es un script o un comando directo. La canalización, las variables y los parámetros se pueden utilizar con un solo comando o script.
• Modo de ejecución : selecciona una versión de PowerShell en la que ejecutar el comando o script proporcionado. Esto solo está disponible para proyectos de Windows, los proyectos de Windows heredados tienen como objetivo la versión de Windows PowerShell 5.1 (32 bits). Las siguientes opciones están disponibles:
  • PowerShell 7.2.15 (64 bits) : utiliza el shell PowerShell Core basado en .NET6. En esta versión, PowerShell está alojado dentro del tiempo de ejecución de .NET 6. La actividad puede acceder directamente a cualquier dato utilizado, que puede importarse en el flujo de trabajo.
  • PowerShell 5.1 (64 bits) : utiliza el ejecutable de Windows PowerShell de 64 bits. En esta versión, PowerShell se incluye con Windows y se encuentra de forma predeterminada en C:\Windows\System32\WindowsPowerShell\v1.0\. En este modo de ejecución, PowerShell se controla de forma remota localmente en la máquina utilizando el shell preinstalado. La comunicación remota introduce la necesidad de serializar y deserializar información entre diferentes tiempos de ejecución .NET y, como tales, los objetos que no se pueden reconstruir se envuelven dentro de un PSObject o PSCustomObject.
  • PowerShell 5.1 (32 bits) : utiliza el ejecutable de Windows PowerShell de 32 bits. En esta versión, PowerShell se incluye con Windows y se encuentra de forma predeterminada en C:\Windows\SysWOW64\WindowsPowerShell\v1.0\). En este modo de ejecución, PowerShell se controla de forma remota localmente en la máquina utilizando el shell preinstalado. La comunicación remota introduce la necesidad de serializar y deserializar la información entre diferentes tiempos de ejecución .NET, ya que los objetos que no se pueden reconstruir se envuelven dentro de un PSObject o PSCustomObject. PSObject y PSCustomObjects contienen información sobre la estructura general del objeto original y pueden utilizarse para reconstruir los objetos manualmente.
• 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.
  Nota:

  Los nombres de variables no distinguen entre mayúsculas y minúsculas.

• Tipo actual : establece el tipo de los objetos devueltos en Salida.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Salida

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