Invoke Power Shell

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

UiPath.Core.Activities.InvokePowerShell

Description

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

Observação:

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.

Compatibilidade do Projeto

Windows - Legado | Windows

Configuração

• TextoDoComando — o comando PowerShell a ser executado. Esse valor pode ser o nome de um cmdlet ou o texto de um Script do PowerShell.

Painel de Propriedades

Comum

• Continuar com erro - Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.
  Observação:

  Se esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, nenhum erro será capturado quando o projeto for executado.

• DisplayName - O nome de exibição da atividade.

Entrada

• Parâmetros — um dicionário de parâmetros de comando do PowerShell. Um comando específico (cmdlet) ou script pode ser usado.
  • Comando específico: ao invocar um comando específico, o nome do parâmetro deve corresponder ao nome do parâmetro do comando.

Por exemplo, se você usar Get-Command -Module CimCmdlets como uma entrada, o valor de entrada deve ser Get-Command e o parâmetro deve ser nomeado Module com o valor definido como "CimCmdlets".

• Script: no início do script, você precisa especificar o tipo do parâmetro. Opcionalmente, você também pode tornar um parâmetro obrigatório para fazer com que um script sempre seja chamado com o parâmetro definido pelo chamador.

Por exemplo, o seguinte script tem dois parâmetros, um do tipo string e outro do tipo int:

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

Esses parâmetros podem então ser referenciados no script adicionando $ na frente do nome do 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.
  Observação:

  Essa variável é criada implicitamente pelo PowerShell. A definição de variáveis ou parâmetros nomeados input pode gerar erros ou resultar em conflitos. É recomendável que o termo input seja reservado para a tubulação.

Opções

• IsScript - Especifica se o texto do comando é um script ou um comando direto. Piping, Variáveis e Parâmetros podem ser usados com um único comando ou script.
• Modo de execução — Selecionar uma versão do PowerShell na qual executar o comando ou script fornecido. Isso está disponível apenas para projetos do Windows, projetos Windows-Legacy usam a versão Windows PowerShell 5.1 (32 bits). As seguintes opções estão disponíveis:
  • PowerShell 7.2.15 (64 bits) — Usa o shell do PowerShell Core baseado em .NET6. Nesta versão, o PowerShell é hospedado dentro do runtime.NET 6. Quaisquer dados usados são diretamente acessíveis pela atividade e podem ser importados no fluxo de trabalho.
  • PowerShell 5.1 (64 bits) - Usa o executável do Windows PowerShell de 64 bits. Nesta versão, o PowerShell é empacotado com o Windows e está localizado por padrão em C:\Windows\System32\WindowsPowerShell\v1.0\. Neste modo de execução, o PowerShell é removido localmente da máquina usando o shell pré-instalado. A retificação introduz a necessidade de serializar e deserializar informações entre diferentes runtimes .NET, e como tais objetos que não podem ser reconstruídos são envoltos dentro de um PSObject ou PSCustomObject.
  • PowerShell 5.1 (32 bits) - Usa o executável do Windows PowerShell de 32 bits. Nesta versão, o PowerShell é empacotado com o Windows e está localizado por padrão em C:\Windows\SysWOW64\WindowsPowerShell\v1.0\). Neste modo de execução, o PowerShell é removido localmente da máquina usando o shell pré-instalado. A retificação introduz a necessidade de serializar e deserializar informações entre diferentes runtimes .NET, e como tais objetos que não podem ser reconstruídos são envoltos dentro de um PSObject ou PSCustomObject. PSObject e PSCustomObjects mantêm informações sobre a estrutura geral do objeto original e podem ser usados para reconstruir os 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.
  Observação:

  Os nomes de variáveis não diferenciam maiúsculas de minúsculas.

• Tipo atual — Define o tipo dos objetos retornados em Saída.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Saída

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