Invocar Power Shell

UiPath.Core.Activities.InvokePowerShell

Descripción

La actividad Invocar Power Shell ejecuta un comando o script PowerShell con parámetros de entrada especificados.

Nota:

Las políticas de antivirus que restringen el acceso a PowerShell pueden impedir el uso de actividades relacionadas con PowerShell. Por ejemplo, no se puede usar Invocar archivo de flujo de trabajo e Invocar Power Shell cuando la regla con ID 6151 está habilitada en McAfee Endpoint Security.

Compatibilidad de Proyectos

Windows - Legacy | Windows

Configuración

• Texto del comando : 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
  Nota:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

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

• Entrada: una colección de PSObjects que se pasan al escritor del proceso utilizado para ejecutar el comando. Puede ser la salida de otra actividad InvokePowerShell. Puedes hacer referencia a la entrada canalizada en un script utilizando $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.

Otros

• 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 (64 bits) : utiliza el shell PowerShell Core basado en .NET6. En esta versión, PowerShell se aloja 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.
• 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.
• VariablesDePowerShell : un diccionario de objetos nombrados que representan variables utilizadas en la sesión actual de la actividad InvocarPowerShell. Un comando o script de PowerShell puede recuperar información de variables In y In/Out y puede establecer variables Out . Para hacer referencia a variables en tu script, utiliza el carácter identificador de variable $ para indicar que el texto que sigue es un nombre de variable. Ejemplo: $firstVariable.
  Nota:

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

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.
• TipoDeArgumento: establece el tipo de la variable de salida.

Salida

• Salida: una colección de objetos TipoDeArgumento devueltos por la ejecución del comando. Se puede usar para enlazar varias actividades de InvokePowerShell.