Ações de script
Importante
Para evitar o acesso não autorizado, o Windows exige direitos de administrador para acessar recursos protegidos. Para acessar recursos protegidos (como arquivos) usando as ações de script, execute o Power Automate com direitos de administrador. Para encontrar mais informações sobre a execução do Power Automate como administrador, acesse Executar o Power Automate com direitos elevados.
As ações de script permitem que você execute blocos de código e implementem comportamento personalizado em seus fluxos da área de trabalho.
Importante
Conforme anunciado em outubro de 2023, o VBScript foi preterido do Windows. Em versões futuras do Windows, o VBScript estará disponível como um recurso sob demanda antes de sua remoção do sistema operacional. Para obter mais informações, consulte Recursos para recursos preteridos.
Todas as ações de script seguem a estrutura básica da respectiva linguagem de programação ou script: PowerShell, Python, VBScript, JavaScript e C#/VB.NET.
Observação
Versão com suporte para C#: v 5.0. Para VB.NET: v 11.0
Linguagem natural para script da plataforma copiloto (versão preliminar)
[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]
A linguagem natural para código é um novo recurso de copiloto que adicionamos no Power Automate para desktop. Ele permite gerar rapidamente o código usado nas ações de script, descrevendo-o. Este recurso está disponível nas seguintes ações de script:
- Executar PowerShell
- Executar VBScript
- Executar comando DOS
- Executar Python
- Executar JavaScript
Importante
- Este é um recurso em versão preliminar.
- Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.
Disponibilidade por região
Atualmente o copilot no Power Automate para desktop está disponível somente em ambientes localizados nos Estados Unidos.
Disponibilidade por tipo de conta
Atualmente, o copiloto no Power Automate para desktop está disponível apenas para usuários com conta corporativa ou de estudante.
Observação
Se o seu ambiente estiver na região listada acima e você ainda precisar ver o copiloto no Power Automate para desktop, entre em contato com o administrador do locatário. Eles podem ter desativado a funcionalidade do copiloto.
Como gerar scripts usando o copiloto e a linguagem natural
Para gerar scripts em uma das ações de script suportadas, arraste e solte a ação no designer e selecione Gerar script com o Copilot.
A tela de criação de prompt é aberta, onde você pode digitar seu prompt em linguagem natural.
Para criar um script, escreva seu prompt e selecione Gerar. Se precisar recriá-lo, você pode alterar o prompt e selecionar Gerar novamente. Caso contrário, selecione Usar este script para voltar à janela de ação principal, onde você pode modificá-lo e adicionar quaisquer variáveis necessárias.
Importante
Certifique-se de sempre revisar o conteúdo gerado pelo modelo de IA.
Ajude-nos a melhorar este recurso
Envie comentários selecionando o ícone polegar para cima ou polegar para baixo abaixo do conteúdo gerado por IA. Depois de fazer isso, uma caixa de diálogo de comentários será exibida, que você poderá usar para enviar comentários à Microsoft.
Observação
Se você não conseguir ver a caixa de diálogo, seu administrador do locatário pode ter desativado ela. Mais informações: Desativar a funcionalidade de comentário do usuário
Desativando a funcionalidade de comentário do usuário
Como um administrador do locatário, você pode impedir que os usuários enviem comentários à Microsoft desativando a configuração do locatário disableSurveyFeedback. Encontre mais informações sobre como visualizar e definir configurações de locatário:
Solicitações de direitos do titular dos dados sobre comentários do usuário
Os administradores do locatário podem exibir, exportar e excluir os comentários dos usuários entrando no centro de administração do Microsoft 365 e, em seguida, selecionando Integridade>Comentários sobre o produto.
IA com recursos do Power Automate
- Perguntas frequentes sobre geração de scripts com linguagem natural
- Perguntas frequentes sobre IA responsável no Power Automate
- Perguntas frequentes sobre segurança e privacidade de dados do Copilot no Microsoft Power Platform
Trabalhando com variáveis em ações de script
Para declarar variáveis em ações de script e retornar resultados no Power Automate, use os seguintes comandos:
Para declarar novas variáveis em scripts do PowerShell, use a notação $. Para retornar valores de ações Executar o script do PowerShell para o Power Automate, use o comando Write-Output.
$variableName = "variableValue" Write-Output $variableNameOs scripts Python não requerem nenhuma notação especial para declarar novas variáveis. Para retornar valores de ações Run Python script, use a função de impressão.
variableName = "variableValue" print variableNameO VBScript não requer nenhuma notação especial para declarar novas variáveis. Use a função WScript.Echo para retornar valores de ações Executar VBScript para o Power Automate.
variableName = "variableValue" WScript.Echo variableNameEm scripts JavaScript, use a notação var para declarar novas variáveis e a função WScript.Echo para retornar valores de ações Executar JavaScript.
var variableName = "variableValue"; WScript.Echo(variableName);Para scripts .NET, use a janela Parâmetros de Script, acessada por meio do cartão de configuração da ação Executar script .NET. Você pode definir o tipo da respectiva variável:
Além disso, você pode definir se é uma entrada para o script .NET (Na opção no menu suspenso Direção), uma saída do script (Saída na lista suspensa Direção) ou ambas (opção Entrada-Saída na lista suspensa Direção).
Para usar as variáveis do Power Automate em ações de script, use a notação de porcentagem (%) e trate as variáveis da mesma maneira que os valores codificados.
Executar comando DOS
Executa um comando DOS ou aplicativo de console em modo invisível e recupera a saída após a conclusão.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| DOS command or application | Não | Arquivo | O nome do comando DOS ou um aplicativo de console, com argumentos, se aplicável | |
| Pasta de trabalho | Sim | Pasta | O caminho completo da pasta a partir da qual é possível trabalhar, se aplicável | |
| Falha após o tempo limite | Sim | Valor booliano | Especificar se o comando DOS ou o aplicativo será executado indefinidamente ou falhará após um período de tempo definido | |
| Timeout | Não | Valor numérico | 10 | O número máximo de segundos a aguardar pela conclusão do script (-1 para indefinidamente) |
| Alterar página de código | N/A | Valor booliano | False | Especifica se a página de código atual da sessão deve ser alterada |
| Codificação | Não | ASMO-708: árabe (ASMO 708), big5: chinês tradicional (Big5), cp1025: IBM EBCDIC (cirílico sérvio-búlgaro), cp866: cirílico (DOS), cp875: IBM EBCDIC (grego moderno), csISO2022JP: japonês (JIS-Allow 1 byte Kana), DOS-720 : árabe (DOS), DOS-862: hebraico (DOS), EUC-CN: chinês simplificado (EUC), EUC-JP: japonês (JIS 0208-1990 e 0212-1990), euc-jp: japonês (EUC), euc-kr: coreano (EUC), GB18030: chinês simplificado (GB18030), gb2312: chinês simplificado (GB2312), hz-gb-2312: chinês simplificado (HZ), IBM-Thai: IBM EBCDIC (tailandês), IBM00858: OEM latim multilíngue I, IBM00924: IBM Latim-1, IBM01047: IBM Latim-1, IBM01140: IBM EBCDIC (EUA-Canadá-Euro), IBM01141: IBM EBCDIC (Alemanha-Euro), IBM01142: IBM EBCDIC (Dinamarca-Noruega-Euro), IBM01143: IBM EBCDIC (Finlândia-Suécia-Euro), IBM01144: IBM EBCDIC (Itália-Euro), IBM01145: IBM EBCDIC (Espanha-Euro), IBM01146: IBM EBCDIC (Reino Unido-Euro), IBM01147: IBM EBCDIC (França-Euro), IBM01148: IBM EBCDIC (internacional-Euro), IBM01149: IBM EBCDIC (islandês-Euro), IBM037: IBM EBCDIC (EUA-Canadá), IBM1026: IBM EBCDIC (turco latim-5), IBM273: IBM EBCDIC (Alemanha), IBM277: IBM EBCDIC (Dinamarca-Noruega), IBM278: IBM EBCDIC (Finlândia-Suécia), IBM280: IBM EBCDIC (Itália), IBM284: IBM EBCDIC (Espanha), IBM285: IBM EBCDIC (Reino Unido), IBM290: IBM EBCDIC (katakana japonês), IBM297: IBM EBCDIC (França), IBM420: IBM EBCDIC (árabe), IBM423: IBM EBCDIC (grego), IBM424: IBM EBCDIC (hebraico), IBM437: OEM Estados Unidos, IBM500: IBM EBCDIC (internacional), ibm737: grego (DOS), ibm775: báltico (DOS), ibm850: europeu ocidental (DOS), ibm852: europeu central (DOS), IBM855: OEM cirílico, ibm857: turco (DOS), IBM860: português (DOS), ibm861: islandês (DOS), IBM863: francês canadense (DOS), IBM864: árabe (864), IBM865: nórdico (DOS), ibm869: grego, moderno (DOS), IBM870: IBM EBCDIC (latim multilíngue-2), IBM871: IBM EBCDIC (islandês), IBM880: IBM EBCDIC (russo cirílico), IBM905: IBM EBCDIC (turco), iso-2022-jp: japonês (JIS), iso-2022-jp: japonês (JIS-Allow 1 byte Kana - SO/SI), iso-2022-kr: coreano (ISO), iso-8859-1: europeu ocidental (ISO), iso-8859-13: estoniano (ISO), iso-8859-15: latim 9 (ISO), iso-8859-2: europeu central (ISO), iso-8859-3: latim 3 (ISO), iso-8859-4: báltico (ISO), iso-8859-5: cirílico (ISO), iso-8859-6: árabe (ISO), iso-8859-7: grego (ISO), iso-8859-8: hebraico (ISO-Visual), iso-8859-8-i: hebraico (ISO-Logical), iso-8859-9: turco (ISO), Johab: coreano (Johab), koi8-r: cirílico (KOI8-R), koi8-u: cirílico (KOI8-U), ks_c_5601-1987: coreano, macintosh: europeu ocidental (Mac), shift_jis: japonês (Shift-JIS), us-ascii: US-ASCII, utf-16: Unicode, utf-16BE: Unicode (Big-Endian), utf-32: Unicode (UTF-32), utf-32BE: Unicode (UTF-32 Big-Endian), utf-7: Unicode (UTF-7), utf-8: Unicode (UTF-8), windows-1250: europeu central (Windows), windows-1251: cirílico (Windows), Windows-1252: europeu ocidental (Windows), windows-1253: grego (Windows), windows-1254: turco (Windows), windows-1255: hebraico (Windows), windows-1256: árabe (Windows), windows-1257: báltico (Windows), windows-1258: vietnamita (Windows), windows-874: tailandês (Windows), x-Chinese-CNS: chinês tradicional (CNS), x-Chinese-Eten: chinês tradicional (Eten), x-cp20001: TCA Taiwan, x-cp20003: IBM5550 Taiwan, x-cp20004: TeleText Taiwan, x-cp20005: Wang Taiwan, x-cp20261: T.61, x-cp20269: ISO-6937, x-cp20936: chinês simplificado (GB2312-80), x-cp20949: coreano Wansung, x-cp50227: chinês simplificado (ISO-2022), x-EBCDIC-KoreanExtended: IBM EBCDIC (coreano estendido), x-Europa: Europa, x-IA5: europeu ocidental (IA5), x-IA5-German: alemão (IA5), x-IA5-Norwegian: norueguês (IA5), x-IA5-Swedish: sueco (IA5), x-iscii-as: ISCII assamês, x-iscii-be: ISCII bengalês, x-iscii-de: ISCII devanágari, x-iscii-gu: ISCII guzerate, x-iscii-ka: ISCII canarim, x-iscii-ma: ISCII malaiala, x-iscii-or: ISCII oriá, x-iscii-pa: ISCII panjabi, x-iscii-ta: ISCII tâmil, x-iscii-te: ISCII télugo, x-mac-arabic: árabe (Mac), x-mac-ce: europeu central (Mac), x-mac-chinesesimp: chinês simplificado (Mac), x-mac-chinesetrad: chinês tradicional (Mac), x-mac-croatian: croata (Mac), x-mac-cyrillic: cirílico (Mac), x-mac-greek: grego (Mac), x-mac-hebrew: hebraico (Mac), x-mac-icelandic: islandês (Mac), x-mac-japanese: japonês (Mac), x-mac-korean: coreano (Mac), x-mac-romanian: romeno (Mac), x-mac-thai: tailandês (Mac), x-mac-turkish: turco (Mac), x-mac-ukrainian: ucraniano (Mac)` | utf-8: Unicode (UTF-8) | A codificação a ser usada ao ler a saída |
Variáveis produzidas
| Argumento | Type | Description |
|---|---|---|
| CommandOutput | Valor do texto | A saída de texto do comando DOS ou aplicativo |
| CommandErrorOutput | Valor do texto | O texto que descreve os erros ocorridos (se houver) durante a execução do comando DOS ou aplicativo |
| CommandExitCode | Valor numérico | O código de saída do comando ou do aplicativo. Esse valor é numérico |
Exceções
| Exceção | Description |
|---|---|
| Can't execute command or console application | Indica um problema ao executar o comando especificado ou aplicativo de console |
| Falha ao executar script na hora alocada | Indica um problema na execução do script fornecido na hora alocada |
Executar VBScript
Executa código VBScript personalizado e recupera sua saída em uma variável.
Você pode usar essa ação para incluir seu próprio código VBScript personalizado no fluxo da área de trabalho, além de poder usar variáveis nele para gerar conteúdo VBScript dinâmico, se necessário.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| VBScript a ser executado | Sim | Valor do texto | O código VBScript a ser executado. As variáveis podem ser incluídas no script, pois são avaliadas antes da execução do VBScript | |
| Falha após o tempo limite | Sim | Valor booliano | N/A | Especificar se o script VBScript será executado indefinidamente ou se falhará após um período de tempo definido |
| Timeout | Não | Valor numérico | 10 | O número máximo de segundos a aguardar pela conclusão do script (-1 para indefinidamente) |
Variáveis produzidas
| Argumento | Type | Description |
|---|---|---|
| VBScriptOutput | Valor do texto | A saída do script |
| ScriptError | Valor do texto | Os erros que podem ocorrer durante a execução do código do VBScript |
Exceções
| Exceção | Description |
|---|---|
| Falha ao executar script na hora alocada | Indica um problema na execução do script fornecido na hora alocada |
Executar JavaScript
Executa código JavaScript personalizado e recupera sua saída em uma variável.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| JavaScript a ser executado | Sim | Valor do texto | O código JavaScript a ser executado. As variáveis podem ser incluídas no script, pois são avaliadas antes da execução do código JavaScript | |
| Falha após o tempo limite | Sim | Valor booliano | Especificar se o script JavaScript será executado indefinidamente ou falhará após um período de tempo definido | |
| Timeout | Não | Valor numérico | 10 | O número máximo de segundos a aguardar pela conclusão do script (-1 para indefinidamente) |
Variáveis produzidas
| Argumento | Type | Description |
|---|---|---|
| JavascriptOutput | Valor do texto | A saída do script |
| ScriptError | Valor do texto | Os erros que podem ocorrer durante a execução do código JavaScript |
Exceções
| Exceção | Description |
|---|---|
| Falha ao executar script na hora alocada | Indica um problema na execução do script fornecido na hora alocada |
Executar script do PowerShell
Executa script do PowerShell personalizado e recupera sua saída em uma variável.
Você pode usar essa ação para incluir seu próprio código PowerShell personalizado no fluxo da área de trabalho, além de poder usar variáveis nele para gerar conteúdo PowerShell dinâmico, se necessário.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Código PowerShell a ser executado | Sim | Valor do texto | O código PowerShell a ser executado. As variáveis podem ser incluídas no script, pois são avaliadas antes da execução do código PowerShell | |
| Falha após o tempo limite | Sim | Valor booliano | Especificar se o script do PowerShell será executado indefinidamente ou se falhará após um período definido | |
| Timeout | Não | Valor numérico | 10 | O número máximo de segundos a aguardar pela conclusão do script (-1 para indefinidamente) |
Variáveis produzidas
| Argumento | Type | Description |
|---|---|---|
| PowershellOutput | Valor do texto | A saída do script |
| ScriptError | Valor do texto | Os erros que podem ocorrer durante a execução do código do PowerShell |
Exceções
| Exceção | Descrição |
|---|---|
| Falha ao executar o script do PowerShell | Indica um problema ao executar o script do PowerShell fornecido |
| Falha ao executar script na hora alocada | Indica um problema na execução do script fornecido na hora alocada |
Executar script do Python
Executa o código de script do Python e recupera sua saída.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Script do Python a ser executado | No | Valor do texto | O código de script do Python a ser executado | |
| Versão do Python | No | Python 2.7, Python 3.4 | Python 2.7 | Especifique qual versão do Python usar ao executar o script |
| Caminhos de pasta de módulo | Sim | Lista de Pastas | Os caminhos das pastas onde os módulos externos do Python estão |
Variáveis produzidas
| Argumento | Type | Description |
|---|---|---|
| PythonScriptOutput | Valor do texto | A saída do script |
| ScriptError | Valor do texto | Os erros que podem ocorrer durante a execução do código de script do Python |
Exceções
| Exceção | Descrição |
|---|---|
| Falha ao executar o script do Python | Indica um problema ao executar o script do Python fornecido |
| Diretório não encontrado | Indica que o diretório não foi encontrado |
Executar script .NET
Executa o código de script .NET (C#/VB.NET) e recupera sua saída.
Parâmetros de entrada
| Argumento | Opcional | Aceita | Valor padrão | Description |
|---|---|---|---|---|
| Linguagem | N/A | C#/ VB.NET | C# | O idioma do script |
| Importações de script .NET | Sim | Valor do texto | As importações do script .NET a serem incluídas no script | |
| Referências a serem carregadas | Sim | Pasta | O caminho raiz onde as bibliotecas de links dinâmicos .NET (arquivos .dll) estão localizadas | |
| Parâmetros de script | Sim | Parâmetros de Script, conforme definido pelo usuário | Configurando os valores dos parâmetros que são definidos no script | |
| Código .NET a ser executado | Não | Valor do texto | O código .NET a ser executado |
Variáveis produzidas
Esta ação pode gerar variáveis, dependendo da configuração feita pelo usuário ao utilizar a janela Parâmetros de Script.
Observação
Caso a ação seja configurada para produzir parâmetros de saída (usando a direção Saída ao configurá-los), você deve sempre garantir que o parâmetro dentro do script seja definido com um valor diferente de nulo. Caso contrário, a execução do script resultará em erro, pois o parâmetro de saída não foi definido.
Exceções
| Exceção | Description |
|---|---|
| Falha ao executar o .NET script | Indica um problema ao executar o script .NET fornecido |