Invoke Power Shell

UiPath.Core.Activities.InvokePowerShell

Description

A atividade Invoke Power Shell executa um comando ou script do PowerShell com parâmetros de entrada especificados.

Observação:

Políticas de antivírus que restringem o acesso do PowerShell podem impedir o uso de atividades relacionadas ao PowerShell. Por exemplo, você não pode usar as atividades Invoke Workflow File e Invoke Power Shell quando a regra com ID 6151 está habilitada no McAfee Endpoint Security.

Compatibilidade do Projeto

Windows - Legacy | Windows

Configuração

• Texto do comando — 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

• 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.
  Observação:

  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.

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

• Entrada: — uma coleção de PSObjects passados para o gravador do pipeline usado para executar o comando. Pode ser a saída de outra atividade Invoke Power Shell. Você pode fazer referência à entrada tabulada em um script usando $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.

Diversos

• 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 (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.
• 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.
• VariáveisDoPowerShell — um dicionário de objetos nomeados que representam variáveis usadas na sessão atual da atividade Invoke Power Shell. Um comando ou script do PowerShell pode recuperar informações de variáveis In e In/Out e pode definir variáveis Out . Para fazer referência a variáveis em seu script, use o caractere identificador de variáveis $ para denotar que o texto após é um nome de variável. Exemplo: $firstVariable.
  Observação:

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

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

Saída

• Saída — uma coleção de objetos ArgumentoDeTipo retornados pela execução do comando. Pode ser usada para canalizar várias atividades Invoke Power Shell.