Accións de script

Importante

Para evitar o acceso non autorizado, Windows require dereitos de administrador para acceder aos recursos protexidos. Para acceder a recursos protexidos (como ficheiros) mediante as accións de script, executa Power Automate con dereitos de administrador. Para obter máis información sobre a execución Power Automate como administrador, vai a Executar Power Automate con dereitos elevados.

As accións de script permítenche executar bloques de código e implementar un comportamento personalizado nos fluxos do teu escritorio.

Importante

Como se anunciou en outubro de 2023, VBScript está obsoleto de Windows. Nas próximas versións de Windows, VBScript estará dispoñible como función baixo demanda antes da súa eliminación do sistema operativo. Para obter máis información, consulte Recursos para funcións obsoletas.

Todas as accións de script seguen a estrutura básica da respectiva linguaxe de programación ou script: PowerShell, Python, VBScript, JavaScript e C#/VB.NET.

Nota

Versión compatible para C#: v 5.0. Para VB.NET: v 11.0

Linguaxe natural ao guión impulsado polo copiloto (vista previa)

[Este tema é documentación de prelanzamento e está suxeito a cambios.]

A linguaxe natural para codificar é unha nova capacidade de copiloto engadida en Power Automate para escritorio. Permíteche xerar rapidamente o código usado nas accións de script describindoo. Esta función está dispoñible nas seguintes accións de script:

• Executa PowerShell
• Executar VBScript
• Executar o comando DOS
• Executar Python
• Executar JavaScript

Importante

• Esta é unha funcionalidade de vista previa.
• As funcionalidades de vista previa non se deseñaron para uso de produción e poden ter funcionalidade restrinxida. Estas funcionalidades están dispoñibles antes da versión oficial para que os clientes poidan obter acceso a elas rápido e fornecer comentarios.

Dispoñibilidade por rexión

Actualmente, o copiloto en Power Automate para escritorio só está dispoñible en ambientes situados nos Estados Unidos.

Dispoñibilidade por tipo de conta

Actualmente, o copiloto en Power Automate para escritorio só está dispoñible para os usuarios cunha conta laboral ou escolar.

Nota

Se o teu ambiente está nunha das rexións listadas anteriormente e aínda necesitas ver o copiloto en Power Automate para a experiencia do escritorio, ponte en contacto co administrador do inquilino. É posible que desactivaran a función de copiloto.

Como xerar scripts usando copiloto e linguaxe natural

Para xerar scripts nunha das accións de script compatibles, arrastre e solte a acción no deseñador e seleccione Xerar script con Copilot.

Ábrese a pantalla de creación de solicitudes na que podes escribir a túa solicitude de linguaxe natural.

Para crear un script, escribe a túa solicitude e selecciona Xerar. Se precisas crealo de novo, podes cambiar a solicitude e seleccionar Rexenerar. En caso contrario, selecciona Usar este script para volver á xanela de accións principal, onde podes modificala e engadir as variables necesarias.

Importante

Asegúrate de revisar sempre o contido xerado polo modelo de IA.

Axúdanos a mellorar esta función

Envía comentarios seleccionando a icona do polgar cara arriba ou abaixo do contido xerado pola IA. Unha vez que o fagas, aparece un diálogo de comentarios, que podes usar para enviar comentarios a Microsoft.

Nota

Se non podes ver o diálogo, é posible que o teu administrador do inquilino o teña desactivado. Máis información: Desactivación da función de comentarios dos usuarios

Desactivando a funcionalidade de comentarios dos usuarios

Como Power Platform administrador, evita que os usuarios envíen comentarios de Copilot a Microsoft mediante a configuración do inquilino.

Solicitudes de dereitos do suxeito de datos sobre comentarios dos usuarios

Os administradores de inquilinos poden ver, exportar e eliminar os comentarios dos seus usuarios iniciando sesión no Microsoft 365 centro de administración e, a continuación, seleccionando Saúde>Comentarios sobre o produto.

IA con recursos Power Automate

• Preguntas frecuentes para xerar scripts con linguaxe natural
• Preguntas frecuentes sobre IA responsable Power Automate
• Preguntas frecuentes sobre a seguridade e privacidade dos datos de Copilot Microsoft Power Platform

Traballar con variables en accións de script

Para declarar variables nas accións de script e devolver resultados en Power Automate, use os seguintes comandos:

• Para declarar novas variables nos scripts de PowerShell, use a notación $ . Para devolver os valores de accións de executar o script de PowerShell a Power Automate, use o comando Write-Output .

  $variableName = "variableValue"
  Write-Output $variableName
  

• Os scripts de Python non requiren ningunha notación especial para declarar novas variables. Para devolver valores das accións Executar script Python , utiliza a función print .

  variableName = "variableValue"
  print variableName
  

• VBScript non require ningunha notación especial para declarar novas variables. Use a función WScript.Echo para devolver valores de Executa VBScript accións a Power Automate.

  variableName = "variableValue"
  WScript.Echo variableName
  

• Nos scripts JavaScript, use a notación var para declarar novas variables e a función WScript.Echo para devolver valores de Executar JavaScript accións.

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

• Para os scripts .NET, utiliza a xanela Parámetros de script , á que se accede a través da tarxeta de configuración da acción Executar script .NET . Pode establecer o tipo da variable respectiva:

Ademais, pode definir se é unha entrada para o script .NET (opción In no menú despregable Dirección), unha saída do script (opción Out no menú despregable Dirección) ou ambos (opción In-Out30>opción en dirección despregable3).

Para usar Power Automate variables nas accións de script, use a notación porcentual (%) e manexa as variables do mesmo xeito que os valores codificados.

Executar comando DOS

Executa un comando DOS ou unha aplicación de consola en modo invisible e recupera a súa saída ao finalizar.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Aplicación ou comando DOS	No	Arquivo		Nome do comando DOS ou dunha aplicación de consola, con argumentos, se procede
Cartafol de traballo	Si	Cartafol		Camiño completo do cartafol desde o que se vai traballar, se procede
Erro ao esgotar o tempo de espera	Si	Valor booleano		Especifique se a aplicación ou o comando de DOS se vai executar indefinidamente ou dará erro despois dun período de tempo determinado
Tempo de espera	No	Valor numérico	1,0	Número máximo de segundos que se vai agardar a que se complete o script (-1 para indefinidamente)
Modificar páxina de códigos	N/D	Valor booleano	Falso	Especifica se se debe modificar a páxina de códigos actual da sesión
Codificación	No	ASMO-708: árabe (ASMO 708), big5: chinés tradicional (Big5), cp1025: IBM EBCDIC (cirílico serbio-búlgaro), cp866: cirílico (DOS), cp875: IBM EBCDIC (grego moderno), csISO2022JP: xaponés (JIS-Al02), xaponés (JISte2: DOS1) DOS-862: hebreo (DOS), EUC-CN: chinés simplificado (EUC), EUC-JP: xaponés (JIS 0208-1990 e 0212-1990), euc-jp: xaponés (EUC), euc-kr: coreano (EUC), GB18030: chinés simplificado (GB18030), chinés simplificado (GB182312), GB180312 hz-gb-2312: Chinés simplificado (HZ), IBM-Tailandés: IBM EBCDIC (Tailandés), IBM00858: OEM Multilingual Latin I, IBM00924: IBM Latin-1, IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (EE. EBCDIC (Dinamarca-Noruega-Euro), IBM01143: IBM EBCDIC (Finlandia-Suecia-Euro), IBM01144: IBM EBCDIC (Italia Euro), IBM01145: IBM EBCDIC (España-Euro), IBM01146: IBM EBCDIC (Reino Unido-Euro), IBM01147: IBM EBCDIC (Francia-Euro), IBM01147:1 EBCDIC (Francia-Euro) EBCDIC (International-Euro), IBM01149: IBM EBCDIC (islandés-euro), IBM037: IBM EBCDIC (EE. IBM280: IBM EBCDIC (Italia), IBM284: IBM EBCDIC (España), IBM285: IBM EBCDIC (Reino Unido), IBM290: IBM EBCDIC (katakana xaponés), IBM297: IBM EBCDIC (Francia), IBM420: IBM EBCDIC (árabe), IBM423: IBM EBCDIC (Árabe), IBM423: IBM EBCDIC42 (Gre EBCD), IBM42 IBM437: OEM Estados Unidos, IBM500: IBM EBCDIC (Internacional), ibm737: Grego (DOS), ibm775: Baltic (DOS), ibm850: Europa Occidental (DOS), ibm852: Centroeuropeo (DOS), IBM855: OEM Cyrillic, ibm857: Turco (DOS), Ibm857: Turco (DOS), Ibm860celandia (DOS), Ibm860: portugués (DOS1), IBM863: canadense francés (DOS), IBM864: árabe (864), IBM865: nórdico (DOS), ibm869: grego, moderno (DOS), IBM870: IBM EBCDIC (Latín-2 multilingüe), IBM871: IBM EBCDIC (islandés), IBM880: IBM EBCDIC (cirílico), IBM90CD: ruso (cirílico), IBM EBCDIC (cirílico) iso-2022-jp: xaponés (JIS), iso-2022-jp: xaponés (JIS-Permitir 1 byte Kana - SO/SI), iso-2022-kr: coreano (ISO), iso-8859-1: Europa occidental (ISO), iso-8859-13: estonio (ISO), iso-8859-15: ISO-2022-15: ISO-2022-19: ISO-2022-19: ISO-2022 iso-8859-3: latín 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: hebreo (ISO-Visual), iso-8859-8: hebreo (ISO-Visual), iso-8859-8 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: europeo occidental (Mac), shift_jift_jift: xaponés: USASC 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: 1250), windows-1250 (Windows), Windows-1252: Europa Occidental (Windows), windows-1253: grego (Windows), windows-1254: turco (Windows), windows-1255: hebreo (Windows), windows-1256: árabe (Windows), windows-1257: báltico (Windows), windows-1258: vietnamita (Windows), windows-1258: vietnamita (Windows), windows-1258: chinés (CNS), chino (CNS), chino tradicional (Windows) x-Chinese-Eten: Chinese Traditional (Eten), x-cp20001: TCA Taiwan, x-cp20003: IBM5550 Taiwan, x-cp20004: TeleText Taiwan, x-cp20005: Wang Taiwan, x-cp20261: T.61, x-cp20261: T.61, x-cp20004: Chinese, x-cp20004: Chinese Simplificado (GB2312-80), x-cp20949: coreano Wansung, x-cp50227: chinés simplificado (ISO-2022), x-EBCDIC-KoreanExtended: IBM EBCDIC (coreano extendido), x-Europa: Europa, x-IA5: europeo occidental (IA5), x-IA5-Noruego: alemán: xIA5-Noruego, x-IA5-Noruego: alemán: IA5 x-IA5-sueco: sueco (IA5), x-iscii-as: ISCII assamés, x-iscii-be: ISCII bengalí, x-iscii-de: ISCII Devanagari, x-iscii-gu: ISCII gujarati, x-iscii-ka: ISCII Kannada, x-iscii-ma: ISCII Malayalam, x-iscii-pa: ISCII Malayalam, x-iscii-papa ISCII punjabi, x-iscii-ta: ISCII tamil, x-iscii-te: ISCII telugu, x-mac-arabic: árabe (Mac), x-mac-ce: centroeuropeo (Mac), x-mac-chinesesimp: chinés simplificado (Mac), x-mac-chinesetrad: chinés tradicional (Mac), x-mac-chinesesimp: chinés tradicional (Mac), x-mac-chinesesimp: chinés tradicional (Mac), x-mac-croacia: x-mac-croatic: cylindrique: croata. (Mac), x-mac-greek: grego (Mac), x-mac-hebrew: hebreo (Mac), x-mac-islandic: islandés (Mac), x-mac-japonés: xaponés (Mac), x-mac-coreano: coreano (Mac), x-mac-romanian: rumano (Mac), x-mac-thai: tailandés (Mac), x-mac-thai: tailandés (Macturk), x-mac-ucraíno: ucraíno (Mac)`	utf-8 : Unicode (UTF-8)	Codificación que se vai usar ao ler a saída

Variables producidas

Argumento	Tipo	Descripción
CommandOutput	Valor do texto	Saída de texto da aplicación ou do comando DOS
CommandErrorOutput	Valor do texto	Texto que describe os erros (se os houbo) que se produciron durante a execución da aplicación ou do comando DOS
CommandExitCode	Valor numérico	O comando ou código de saída da aplicación. Este valor é numérico

Excepcións

Excepción	Descripción
Non se pode executar o comando nin a aplicación da consola	Indica un problema ao executar o comando ou a aplicación de consola especificada
Non se puido executar o script no tempo asignado	Indica un problema ao executar o script proporcionado no tempo asignado

Executar VBScript

Executa algún código VBScript personalizado e recupera a súa saída nunha variable.

Podes usar esta acción para incluír o teu propio código VBScript personalizado no fluxo do escritorio, ao tempo que tes a posibilidade de usar variables nel, para xerar contido VBScript dinámico se é necesario.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
VBScript que se vai executar	Si	Valor do texto		O código VBScript a executar. As variables poden incluírse dentro do script xa que se avalían antes da execución do VBScript
Erro ao esgotar o tempo de espera	Si	Valor booleano	N/D	Especifique se o script de VBScript se vai executar indefinidamente ou dará erro despois dun período de tempo determinado
Tempo de espera	No	Valor numérico	1,0	Número máximo de segundos que se vai agardar a que se complete o script (-1 para indefinidamente)

Variables producidas

Argumento	Tipo	Descripción
VBScriptOutput	Valor do texto	A saída do script
ScriptError	Valor do texto	Os erros que poden ocorrer durante a execución do código VBScript

Excepcións

Excepción	Descripción
Non se puido executar o script no tempo asignado	Indica un problema ao executar o script proporcionado no tempo asignado

Executar JavaScript

Executa algún código JavaScript personalizado e recupera a súa saída nunha variable.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
JavaScript que se vai executar	Si	Valor do texto		O código JavaScript a executar. As variables poden incluírse dentro do script xa que se avalían antes da execución do código JavaScript
Erro ao esgotar o tempo de espera	Si	Valor booleano		Especifique se o script de JavaScript se vai executar indefinidamente ou dará erro despois dun período de tempo determinado
Tempo de espera	No	Valor numérico	1,0	Número máximo de segundos que se vai agardar a que se complete o script (-1 para indefinidamente)

Variables producidas

Argumento	Tipo	Descripción
JavascriptOutput	Valor do texto	A saída do script
ScriptError	Valor do texto	Os erros que se poden producir durante a execución do código JavaScript

Excepcións

Excepción	Descripción
Non se puido executar o script no tempo asignado	Indica un problema ao executar o script proporcionado no tempo asignado

Executar o script de PowerShell

Executa algún script de PowerShell personalizado e recupera a súa saída nunha variable.

Podes usar esta acción para incluír o teu propio código de PowerShell personalizado no fluxo do escritorio, ao tempo que tes a posibilidade de usar variables nel, para xerar contido dinámico de PowerShell se é necesario.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Código PowerShell que se vai executar	Si	Valor do texto		O código de PowerShell a executar. Pódense incluír variables dentro do script xa que se avalían antes da execución do código de PowerShell
Erro ao esgotar o tempo de espera	Si	Valor booleano		Especifique se o script de PowerShell se executará indefinidamente ou fallará despois dun período de tempo establecido
Tempo de espera	No	Valor numérico	1,0	Número máximo de segundos que se vai agardar a que se complete o script (-1 para indefinidamente)

Variables producidas

Argumento	Tipo	Descripción
PowershellOutput	Valor do texto	A saída do script
ScriptError	Valor do texto	Os erros que poden ocorrer durante a execución do código de PowerShell

Excepcións

Excepción	Descripción
Erro ao executar o script de PowerShell	Indica un problema ao executar o script de PowerShell proporcionado
Non se puido executar o script no tempo asignado	Indica un problema ao executar o script proporcionado no tempo asignado

Executar script de Python

Executa código de script Python e recupera a súa saída.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Script de Python que se vai executar	No	Valor do texto		O código de script Python para executar
Versión de Python	No	Python 2.7, Python 3.4	Python 2.7	Especifique que versión de Python usar ao executar o script
Camiños de cartafoles de módulos	Si	Lista de Cartafoles		As rutas dos cartafoles onde se atopan os módulos externos de Python

Variables producidas

Argumento	Tipo	Descripción
PythonScriptOutput	Valor do texto	A saída do script
ScriptError	Valor do texto	Os erros que poden ocorrer durante a execución do código do script Python

Excepcións

Excepción	Descripción
Erro ao executar o script de Python	Indica un problema ao executar o script de Python proporcionado
Non se atopou o directorio	Indica que non se atopou o directorio

Executar script de .NET

Executa código de script .NET (C#/VB.NET) e recupera a súa saída.

Parámetros de entrada

Argumento	Opcional	Acepta	Valor predefinido	Descripción
Linguaxe	N/D	C#/ VB.NET	C#	Idioma do script
Importacións de scripts de .NET	Si	Valor do texto		Importacións do script de .NET que se van incluír no script
Referencias que se van cargar	Si	Cartafol		Camiño raíz onde se atopan as referencias ás bibliotecas de ligazóns dinámicas de .NET (ficheiros .dll)
Parámetros do script	Si	Parámetros de script definidos polo usuario		Establecer os valores dos parámetros que se definen no script
Código de .NET que se vai executar	No	Valor do texto		Código .NET que se vai executar

Variables producidas

Esta acción pode producir variables, dependendo da configuración feita polo usuario ao usar o Parámetros de script fiestra.

Nota

No caso de que a acción estea configurada para producir parámetros de saída (usando o Fóra dirección ao configuralos), sempre debe asegurarse de que o parámetro dentro do script estea configurado nun valor distinto de nulo. En caso contrario, a execución do script produce un erro xa que o parámetro de saída non se estableceu.

Excepcións

Excepción	Descripción
Produciuse un erro ao executar o script .NET	Indica un problema ao executar o script de .NET proporcionado