activities
latest
false
Importante :
A tradução automática foi aplicada parcialmente neste conteúdo.
Atividades do fluxo de trabalho
Last updated 31 de out de 2024

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
      ) 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.
  • Description
  • Compatibilidade do Projeto
  • Configuração
  • Painel de Propriedades

Esta página foi útil?

Obtenha a ajuda que você precisa
Aprendendo RPA - Cursos de automação
Fórum da comunidade da Uipath
Uipath Logo White
Confiança e segurança
© 2005-2024 UiPath. Todos os direitos reservados.