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 - Legado | janelas

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

• ContinuarComErro — 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 essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.
• NomeDeExibição - 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 das variáveis não fazem diferenciação entre maiúsculas e 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.