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: heredado | Ventanas

Configuración

• Texto del comando: el comando 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 se incluye esta actividad en Intentar capturar y el valor de la propiedad ContinuarEnCasoDeError es Verdadero, no se detectará error cuando el proyecto se ejecute.
• NombreParaMostrar: el nombre de la actividad para ser mostrado.

Entrada

• Parámetros: un diccionario de los parámetros de los 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 objetosPS que se pasan al escritor del proceso utilizado para ejecutar el comando. Puede ser la salida de otra actividad de InvokePowerShell. Puedes hacer referencia a la entrada en proceso en un script utilizando $input.
  Nota: esta variable la crea implícitamente PowerShell. La definición de variables o parámetros con nombre input puede generar errores o puede dar lugar a conflictos. Se recomienda que el término input se reserve para las canalizaciones.

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 los proyectos de Windows, los proyectos de Windows-Legacy están pensados para la versión 5.1 de Windows PowerShell (32 bits).

  Las siguientes opciones están disponibles:

  • PowerShell 7.2 (64 bits): utiliza el shell PowerShell Core en función de .NET6. En esta versión, PowerShell está alojado dentro del tiempo de ejecución .NET 6. Cualquier dato utilizado es directamente accesible por la actividad y puede importarse en el flujo de trabajo.
  • PowerShell 5.1 (64 bits): utiliza el ejecutable 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 ejecuta localmente en la máquina utilizando el shell preinstalado. El control remoto introduce la necesidad de serializar y deserializar información entre diferentes tiempos de ejecución .NET, ya que tales objetos que no se pueden reconstruir se envuelven dentro de un PSObject o PSCustomObject .
  • PowerShell 5.1 (32 bits): utiliza el ejecutable 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 ejecuta localmente en la máquina utilizando el shell preinstalado. El control remoto introduce la necesidad de serializar y deserializar información entre diferentes tiempos de ejecución .NET, ya que tales objetos que no se pueden reconstruir se envuelven dentro de un PSObject o PSCustomObject. PSObject y PSCustomObjects contiene 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. Los canalizadores, variables y parámetros se pueden utilizar con un único comando o script.
• VariablesDePowerShell: un diccionario de objetos nombrados que representan variables usadas dentro de la sesión actual InvokePowerShell. Un comando o script PowerShell puede recuperar información de In y In/Out variables y puede establecer variables Out. Para hacer referencia a variables en tu script, utiliza el carácter identificador de variables $ para indicar que el texto siguiente 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.