Ações de Processamento de Scripts

Importante

Para evitar o acesso não autorizado, o Windows exige direitos de administrador para aceder aos recursos protegidos. Para aceder aos recursos protegidos (como ficheiros) utilizando as ações de scripting, execute o Power Automate com direitos de administrador. Para encontrar mais informações sobre como executar o Power Automate como um administrador, aceda a Executar o Power Automate com direitos elevados.

As ações de scripting permitem-lhe executar blocos de código e implementar comportamento personalizado nos fluxos de ambiente 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 uma caraterística on-demand antes de sua remoção do sistema operativo. Para mais informações, consulte Recursos para caraterísticas preteridas.

Todas as ações de scripting seguem a estrutura básica da respetiva linguagem de programação ou script: PowerShell, Python, VBScript, JavaScript e C#/VB.NET.

Nota

Versão suportada para C#: v 5.0. Para VB.NET: v 11.0

Linguagem natural para script com tecnologia Copilot (pré-visualização)

[Este tópico é documentação de pré-lançamento e está sujeito a alterações.]

Linguagem natural para codificar é uma nova capacidade do Copilot adicionada ao Power Automate para ambiente de trabalho. Permite que gere rapidamente o código usado nas ações de processamento de scripts, descrevendo-o. Esta característica está disponível nas seguintes ações de script:

• Executar PowerShell
• Executar VBScript
• Executar comando do DOS
• Executar Python
• Executar JavaScript

Importante

• Esta é uma funcionalidade de pré-visualização.
• As caraterísticas de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipadamente e enviar comentários.

Disponibilidade por região

Atualmente, o Copilot no Power Automate para ambiente de trabalho só está disponível em ambientes localizados nos Estados Unidos.

Disponibilidade por tipo de conta

Atualmente, o Copilot no Power Automate para ambiente de trabalho só está disponível para utilizadores com uma conta escolar ou profissional.

Nota

Se o seu ambiente estiver na região listada acima e ainda precisar de ver o Copilot no Power Automate para a experiência de ambiente de trabalho, entre em contacto com o administrador do inquilino. Podem ter desativado a funcionalidade do Copilot.

Como gerar scripts usando o Copilot e linguagem natural

Para gerar scripts numa das ações de processamento de script suportadas, arraste e largue a ação no estruturador e selecione Gerar script com o Copilot.

O ecrã do pedido de criação é aberto, onde pode escrever o seu pedido de linguagem natural.

Para criar um script, escreva o seu pedido e selecione Gerar. Se tiver de recriá-lo, altere o pedido e selecione Regenerar. Caso contrário, selecione Utilizar este script para voltar à janela de ação principal, onde pode modificá-lo e adicionar as variáveis necessárias.

Importante

Certifique-se de que revê sempre o conteúdo gerado pelo modelo de IA.

Ajudar-nos a melhorar esta funcionalidade

Envie comentários selecionando o ícone de polegar para cima ou polegar para baixo abaixo do conteúdo gerado por IA. Depois disso, será apresentada uma caixa de diálogo de comentários, que pode usar para enviar comentários à Microsoft.

Nota

Se não conseguir ver a caixa de diálogo, o administrador do inquilino poderá tê-la desativado. Para obter mais informações: Desativar a funcionalidade de comentários do utilizador

Desativar a funcionalidade de comentários do utilizador

Como administrador de inquilino, pode impedir que os seus utilizadores enviem comentários à Microsoft desativando a definição de inquilino disableSurveyFeedback. Encontre mais informações sobre como visualizar e definir definições de inquilino:

• Listar definições do inquilino (pré-visualização)
• Definir TenantSettings

Pedidos de direitos do titular dos dados sobre os comentários dos utilizadores

Os administradores de inquilino podem ver, exportar e eliminar os comentários dos seus utilizadores iniciando sessão no centro de administração do Microsoft 365 e, em seguida, selecionando Estado de Funcionamento>Comentários sobre produtos.

IA com recursos do Power Automate

• FAQ para gerar scripts com linguagem natural
• FAQs sobre IA Responsável para o Power Automate
• FAQ sobre a segurança de dados e a privacidade do Copilot no Microsoft Power Platform

Trabalhar com variáveis em ações de processamento de scripts

Para declarar variáveis em ações de scripting e devolver resultados no Power Automate, use os seguintes comandos:

• Para declarar novas variáveis nos scripts PowerShell, utilize a notação $. Para devolver valores das ações Executar script do PowerShell para o Power Automate, utilize o comando Write-Output.

  $variableName = "variableValue"
  Write-Output $variableName
  

• Os scripts python não requerem nenhuma notação especial para declarar novas variáveis. Para retornar os valores das ações de script Run Python, utilize a função imprimir.

  variableName = "variableValue"
  print variableName
  

• Os VBScript não requerem nenhuma notação especial para declarar novas variáveis. Utilize a função WScript.Echo para devolver os valores das ações de Executar VBScript para o Power Automate.

  variableName = "variableValue"
  WScript.Echo variableName
  

• Nos scripts JavaScript, utilize a notação var para declarar novas variáveis e a função WScript.Echo para devolver valores das ações Run JavaScript.

  var variableName = "variableValue";
  WScript.Echo(variableName);
  

• Para os scripts .NET, utilize a janela Parâmetros de Script, acedidos através do cartão de configuração da ação Executar o script .NET. Pode definir o tipo da respetiva variável:

Além disso, pode definir se se trata de uma entrada para o script .NET (opção Entrada no menu pendente Direção), uma saída do script (opção Saída no menu pendente Direção) ou ambas (opção Entrada/Saída no menu pendente Direção).

Para utilizar variáveis do Power Automate em ações de scripting, use a notação de percentagem (%) e processe as variáveis da mesma forma que valores codificados.

Executar comando do DOS

Executa um comando ou uma aplicação de consola do DOS em modo invisível e obtém a respetiva saída após a conclusão.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
DOS command or application	Não	Ficheiro		O nome do comando ou da aplicação de consola do DOS, com argumentos, se aplicável
Working folder	Sim	Pasta		O caminho completo da pasta para trabalhar, se aplicável
Falhar após tempo limite	Sim	Valor booleano		Especificar se o comando ou aplicação do DOS será executado indefinidamente ou falhará após um período de tempo definido
Limite de tempo excedido	Não	Valor numérico	10	O número máximo de segundos a esperar que o script esteja concluído (-1 para indefinidamente)
Página alterar código	N/A	Valor booleano	Falso	Especifica se pretende alterar a página de códigos atual da sessão
Encoding	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), csISISO2022JP: 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 (Thai), IBM00858: OEM Latin I multilingue, IBM00924: IBM Latin-1, IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (US-Canada-Euro), IBM01141: IBM EBCDIC (Alemanha-Euro), IBM01142: IBM EBCDIC (Denmark-Norway-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 (Icelandic-Euro), IBM037: IBM EBCDIC (EUA-Canadá), IBM1026: IBM EBCDIC (Turkish Latin-5), IBM273: IBM EBCDIC (Alemanha), IBM277: IBM EBCDIC (Denmark-Norway), 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 japonesa), 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: Europa Ocidental (DOS), ibm852: Europa Central (DOS), IBM855: OEM Cyrillic, ibm857: Turco (DOS), IBM860: Português (DOS), ibm861: Islandês (DOS), IBM863: Francês Canadiano (DOS), IBM864: Árabe (864), IBM865: Nórdico (DOS), ibm869: Grego, Moderno (DOS), IBM870: IBM EBCDIC (Multilingue Latino-2), IBM871: IBM EBCDIC (Islandês), IBM880: IBM EBCDIC (Cirílico Russo), 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: Estónio (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: Europa Central (Windows), windows-1251: Cirílico (Windows), Windows-1252: Europa 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), janelas-874: Thai (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 (Korean Extended), x-Europa: Europa, x-IA5: Europa Ocidental (IA5), x-IA5-Alemão: Alemão (IA5), x-IA5-Norueguês: Norueguês (IA5), x-IA5-Sueco: Sueco (IA5), x-iscii-as: ISCII Assamês, x-iscii-be: ISCII Bengali, x-iscii-de: ISCII Devanagari, x-iscii-gu: ISCII Gujarati, x-iscii-ka: ISCII Kannada, x-iscii-ma: ISCII Malayalam, x-iscii-ou: ISCII Odia, x-iscii-pa: ISCII Punjabi, x-iscii-ta: ISCII Tamil, x-iscii-te: ISCII Telugu, x-mac-arabic: Arabic (Mac), x-mac-ce: Central European (Mac), x-mac-chinesesimp: Chinês Simplificado (Mac), x-mac-chinesetrad: Chinês Tradicional (Mac), x-mac-croata: Croata (Mac), x-mac-cyrillic: Cirílico (Mac), x-mac-grego: Grego (Mac), x-mac-hebrew: Hebraico (Mac), x-mac-icelandic: Islandês (Mac), x-mac-japonês: japonês (Mac), x-mac-korean: coreano (Mac), x-mac-romanian: romeno (Mac), x-mac-thai: tailandês (Mac), x-mac-turco: turco (Mac), x-mac-ukrainian: ucraniano (Mac) `	utf-8: Unicode (UTF-8)	A codificação a utilizar ao ler a saída

Variáveis produzidas

Argumento	Tipo	Descrição
CommandOutput	Valor de texto	A saída de texto do comando ou da aplicação do DOS
CommandErrorOutput	Valor de texto	O texto que descreve os erros ocorridos (se existentes) durante a execução do comando ou da aplicação do DOS
CommandExitCode	Valor numérico	O comando ou o código de saída da aplicação. Este valor é numérico

Exceções

Exceção	Descrição
Não é possível executar o comando ou a aplicação de consola	Indica um problema ao executar o comando ou a aplicação de consola especificada
Falha ao executar script no tempo alocado	Indica um problema ao executar o script fornecido no tempo alocado

Executar VBScript

Executa código VBScript personalizado e obtém a respetiva saída numa variável.

Pode utilizar esta ação para incluir o seu próprio código VBScript personalizado no fluxo de ambiente de trabalho, ao mesmo tempo que tem a capacidade de usar variáveis no mesmo, para gerar conteúdo VBScript dinâmico, se necessário.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
VBScript to run	Sim	Valor de texto		O código VBScript a executar. É possível incluir variáveis no script, visto que serão avaliadas antes da execução do VBScript
Falhar após tempo limite	Sim	Valor booleano	N/A	Especificar se o script do VBScript será executado indefinidamente ou falhará após um período de tempo definido
Limite de tempo excedido	Não	Valor numérico	10	O número máximo de segundos a esperar que o script esteja concluído (-1 para indefinidamente)

Variáveis produzidas

Argumento	Tipo	Descrição
VBScriptOutput	Valor de texto	A saída do script
ScriptError	Valor de texto	Os erros que poderão ocorrer durante a execução do código VBScript

Exceções

Exceção	Descrição
Falha ao executar script no tempo alocado	Indica um problema ao executar o script fornecido no tempo alocado

Executar JavaScript

Executa código JavaScript personalizado e obtém a respetiva saída numa variável.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
JavaScript to run	Sim	Valor de texto		O código JavaScript a executar. É possível incluir variáveis no script, visto que serão avaliadas antes da execução do código JavaScript
Falhar após tempo limite	Sim	Valor booleano		Especificar se o script do JavaScript será executado indefinidamente ou irá falhar após um período de tempo definido
Limite de tempo excedido	Não	Valor numérico	10	O número máximo de segundos a esperar que o script esteja concluído (-1 para indefinidamente)

Variáveis produzidas

Argumento	Tipo	Descrição
JavascriptOutput	Valor de texto	A saída do script
ScriptError	Valor de texto	Os erros que poderão ocorrer durante a execução do código JavaScript

Exceções

Exceção	Descrição
Falha ao executar script no tempo alocado	Indica um problema ao executar o script fornecido no tempo alocado

Executar script do PowerShell

Executa um script personalizado do PowerShell personalizado e obtém a respetiva saída numa variável.

Pode utilizar esta ação para incluir o seu próprio código PowerShell personalizado no fluxo de ambiente de trabalho, ao mesmo tempo que tem a capacidade de usar variáveis no mesmo, para gerar conteúdo PowerShell dinâmico, se necessário.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
PowerShell code to run	Sim	Valor de texto		O código PowerShell a executar. É possível incluir variáveis no script, visto que serão avaliadas antes da execução do código PowerShell
Falhar após tempo limite	Sim	Valor booleano		Especificar se o script do PowerShell será executado indefinidamente ou falhará após um período de tempo definido
Limite de tempo excedido	Não	Valor numérico	10	O número máximo de segundos a esperar que o script esteja concluído (-1 para indefinidamente)

Variáveis produzidas

Argumento	Tipo	Descrição
PowershellOutput	Valor de texto	A saída do script
ScriptError	Valor de texto	Os erros que poderão ocorrer durante a execução do código do PowerShell

Exceções

Exceção	Descrição
Falha ao executar script do PowerShell	Indica um problema ao executar o script do PowerShell fornecido
Falha ao executar script no tempo alocado	Indica um problema ao executar o script fornecido no tempo alocado

Executar script do Python

Executa código de script do Python e obtém a respetiva saída.

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Python script to run	No	Valor de texto		O código do script do Python a executar
Versão do Python	No	Python 2.7, Python 3.4	Python 2.7	Especificar a versão do Python que deve ser utilizada ao executar o script
Module folder paths	Sim	Lista de Pastas		Os caminhos das pastas onde residem os módulos externos do Python

Variáveis produzidas

Argumento	Tipo	Descrição
PythonScriptOutput	Valor de texto	A saída do script
ScriptError	Valor de texto	Os erros que poderão ocorrer durante a execução do código do script do Python

Exceções

Exceção	Descrição
Falha ao executar 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 do .NET

Executa código do script .NET (C#/VB.NET) e obtém a respetiva saída,

Parâmetros de entrada

Argumento	Opcional	Aceita	Valor Predefinido	Descrição
Linguagem	N/A	C#/ VB.NET	C#	A linguagem do script
Importações de scripts do .NET	Sim	Valor de texto		As importações de scripts do .NET a incluir no script
Referências a carregar	Sim	Pasta		O caminho raiz onde as referências de bibliotecas de ligação dinâmica (ficheiros .dll) do .NET estão localizadas
Parâmetros do script	Sim	Parâmetros do Script conforme definidos pelo utilizador		Definir os valores dos parâmetros que estão definidos no script
Código do .NET a executar	Não	Valor de texto		O código do .NET a executar

Variáveis produzidas

Esta ação poderá produzir variáveis, dependendo da configuração efetuada pelo utilizador ao utilizar a janela Parâmetros do Script.

Nota

No caso de a ação ser configurada para produzir parâmetros de saída (utilizando a direção Saída ao configurá-los), deverá sempre certificar-se de que o parâmetro dentro do script está definido como um valor diferente de nulo. Caso contrário, a execução do script irá resultar num erro, uma vez que o parâmetro de saída não foi definido.

Exceções

Exceção	Descrição
Falha ao executar o script do .NET	Indica um problema ao executar o script do .NET fornecido