Accions de scripting

Important

Per evitar l'accés no autoritzat, el Windows requereix drets d'administrador per accedir als recursos protegits. Per accedir a recursos protegits (com ara fitxers) mitjançant les accions de scripting, executeu-lo Power Automate amb drets d'administrador. Per obtenir més informació sobre l'execució Power Automate com a administrador, aneu a Executar Power Automate amb drets elevats.

Les accions de scripting us permeten executar blocs de codi i implementar un comportament personalitzat als fluxos de l'escriptori.

Important

Tal com es va anunciar l'octubre de 2023, VBScript està obsolet de Windows. En futures versions de Windows, VBScript estarà disponible com a característica sota demanda abans de la seva eliminació del sistema operatiu. Per obtenir més informació, vegeu Recursos per a característiques obsoletes.

Totes les accions de scripting segueixen l'estructura bàsica del llenguatge de programació o scripting respectiu: PowerShell, Python, VBScript, JavaScript i C#/VB.NET.

Nota

Versió compatible amb C#: v 5.0. Per VB.NET: v 11.0

Llenguatge natural a script impulsat per copilot (vista prèvia)

[Aquest tema és documentació preliminar i està subjecte a canvis.]

El llenguatge natural al codi és una nova capacitat de copilot afegida per a l'escriptori Power Automate . Us permet generar ràpidament el codi utilitzat en les accions de scripting descrivint-lo. Aquesta característica està disponible en les accions de scripting següents:

• Executar PowerShell
• Executa VBScript
• Executa l'ordre DOS
• Executa Python
• Executar JavaScript

Important

• Aquesta és una característica de visualització prèvia.
• Les característiques de visualització prèvia no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris.

Disponibilitat per regió

Actualment, copilot in per Power Automate a escriptori només està disponible en entorns ubicats als Estats Units.

Disponibilitat per tipus de compte

Actualment, copilot in per Power Automate a escriptori només està disponible per als usuaris amb un compte de la feina o d'un centre educatiu.

Nota

Si el vostre entorn es troba en una de les regions enumerades anteriorment i encara necessiteu veure el copilot per Power Automate a l'experiència d'escriptori, poseu-vos en contacte amb l'administrador de l'inquilí. És possible que hagin desactivat la funcionalitat del copilot.

Com generar scripts utilitzant copilot i llenguatge natural

Per generar scripts en una de les accions de scripting admeses, arrossegueu i deixeu anar l'acció al dissenyador i seleccioneu Genera script amb Copilot.

S'obre la pantalla de creació d'una sol·licitud on podeu escriure la vostra sol·licitud en llenguatge natural.

Per crear un script, escriviu la vostra sol·licitud i seleccioneu Genera. Si necessiteu tornar-lo a crear, podeu canviar la sol·licitud i seleccionar Regenera. En cas contrari, seleccioneu Utilitza aquest script per tornar a la finestra d'acció principal, on podeu modificar-lo i afegir les variables necessàries.

Important

Assegureu-vos de revisar sempre el contingut generat pel model d'IA.

Ajudeu-nos a millorar aquesta funció

Envieu suggeriments seleccionant la icona de polze cap amunt o cap avall que hi ha a sota del contingut generat per IA. Un cop ho feu, apareixerà un diàleg de comentaris, que podeu utilitzar per enviar comentaris a Microsoft.

Nota

Si no veieu el quadre de diàleg, és possible que l'administrador de l'inquilí l'hagi desactivat. Més informació: Desactivació de la funcionalitat de comentaris dels usuaris

Desactivació de la funcionalitat de comentaris dels usuaris

Com a Power Platform administrador, eviteu que els usuaris enviïn comentaris del Copilot a Microsoft mitjançant la configuració de l'inquilí "Comentaris del Copilot".

Sol·licituds de drets de l'interessat sobre els comentaris dels usuaris

Els administradors d'inquilins poden visualitzar, exportar i suprimir els comentaris dels seus usuaris iniciant sessió al centre d'administració Microsoft 365 i, a continuació, seleccionantcomentaris sobre el producte de salut>.

IA amb Power Automate recursos

• Preguntes freqüents sobre la generació de scripts amb llenguatge natural
• Preguntes freqüents sobre IA responsable per a Power Automate
• Preguntes freqüents sobre la seguretat i la privacitat de les dades de Copilot a Microsoft Power Platform

Treballar amb variables en accions de scripting

Per declarar variables en accions de scripting i retornar resultats Power Automate, utilitzeu les ordres següents:

• Per declarar variables noves als scripts del PowerShell, utilitzeu la $ notació. Per retornar valors de les accions de script Executa el PowerShell a , utilitzeu l'ordre Power AutomateWrite-Output .

  $variableName = "variableValue"
  Write-Output $variableName
  

• Els scripts Python no requereixen cap notació especial per declarar noves variables. Per retornar valors de les accions de script Executa Python, utilitzeu la funció print .

  variableName = "variableValue"
  print variableName
  

• VBScript no requereix cap notació especial per declarar noves variables. Utilitzeu la funció WScript.Echo per retornar valors de les accions Executa VBScript a Power Automate.

  variableName = "variableValue"
  WScript.Echo variableName
  

• En scripts JavaScript, utilitzeu la notació var per declarar variables noves i la funció WScript.Echo per retornar valors de les accions Executa JavaScript .

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

• Per als scripts .NET, utilitzeu la finestra Paràmetres de script, a la qual s'accedeix mitjançant la targeta de configuració de l'acció Executa script .NET. Podeu establir el tipus de la variable respectiva:

A més, podeu definir si es tracta d'una entrada a l'script .NET (opció En al menú desplegable Direcció), una sortida de l'script (opció Fora al menú desplegable Direcció) o tots dos (opció Entrada-Sortida al menú desplegable Direcció).

Per utilitzar Power Automate variables en accions de scripting, utilitzeu la notació de percentatge (%) i gestioneu les variables de la mateixa manera que els valors codificats.

Executa una ordre del DOS

Executa una ordre DOS o una aplicació de consola en mode invisible i recupera la seva sortida en finalitzar.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Ordre o aplicació del DOS	No	Fitxer		Nom de l'ordre o de l'aplicació de consola del DOS, amb arguments si escau
Carpeta de treball	Sí	Carpeta		Camí complet de la carpeta on s'ha de treballar, si escau
S'ha produït un error després del temps d'espera	Sí	Valor booleà		Especifiqueu si l'ordre o l'aplicació del DOS s'executarà indefinidament o si es produirà un error després d'un període de temps definit
Temps d'espera	No	Valor numèric	10	Nombre màxim de segons que s'ha d'esperar perquè es completi l'script (-1 per indefinidament)
Canvia la pàgina de codis	N/A	Valor booleà	Fals	Especifica si s'ha de canviar la pàgina de codis actual de la sessió
Codificació	No	ASMO-708: Àrab (ASMO 708), big5: xinès tradicional (Big5), cp1025: IBM EBCDIC (ciríl·lic serbi-búlgar), cp866: ciríl·lic (DOS), cp875: IBM EBCDIC (grec modern), csISO2022JP: japonès (JIS-Allow 1 byte kana), DOS-720: àrab (DOS), DOS-862: hebreu (DOS), EUC-CN: Xinès simplificat (EUC), EUC-JP: Japonès (JIS 0208-1990 i 0212-1990), euc-jp: japonès (EUC), euc-kr: coreà (EUC), GB18030: xinès simplificat (GB18030), gb2312: Xinès simplificat (GB2312), hz-gb-2312: xinès simplificat (HZ), IBM-tailandès: IBM EBCDIC (tailandès), IBM00858: OEM multilingüe llatí I, IBM00924: IBM Latin-1, IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (EUA-Canadà-Euro), IBM01141: IBM EBCDIC (Alemanya-Euro), IBM01142: IBM EBCDIC (Dinamarca-Noruega-Euro), IBM01143: IBM EBCDIC (Finlàndia-Suècia-Euro), IBM01144: IBM EBCDIC (Itàlia Euro), IBM01145: IBM EBCDIC (Espanya-Euro), IBM01146: IBM EBCDIC (Regne Unit-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 (turc llatí-5), IBM273: IBM EBCDIC (Alemanya), IBM277: IBM EBCDIC (Dinamarca-Noruega), IBM278: IBM EBCDIC (Finlàndia-Suècia), IBM280: IBM EBCDIC (Itàlia), IBM284: IBM EBCDIC (Espanya), IBM285: IBM EBCDIC (REGNE UNIT), IBM290: IBM EBCDIC (katakana japonès), IBM297: IBM EBCDIC (França), IBM420: IBM EBCDIC (àrab), IBM423: IBM EBCDIC (grec), IBM424: IBM EBCDIC (hebreu), IBM437: OEM Estats Units, IBM500: IBM EBCDIC (internacional), ibm737: grec (DOS), ibm775: bàltic (DOS), ibm850: Europa occidental (DOS), ibm852: centreeuropeu (DOS), IBM855: ciríl·lic OEM, ibm857: turc (DOS), IBM860: portuguès (DOS), ibm861: islandès (DOS), IBM863: francocanadenc (DOS), IBM864: àrab (864), IBM865: nòrdic (DOS), ibm869: grec, modern (DOS), IBM870: IBM EBCDIC (llatí multilingüe-2), IBM871: IBM EBCDIC (islandès), IBM880: IBM EBCDIC (rus ciríl·lic), IBM905: IBM EBCDIC (turc), iso-2022-jp: japonès (JIS), iso-2022-jp: japonès (JIS-Allow 1 byte Kana - SO/SI), iso-2022-kr: coreà (ISO), iso-8859-1: Europa occidental (ISO), iso-8859-13: estonià (ISO), iso-8859-15: llatí 9 (ISO), iso-8859-2: Europa central (ISO), iso-8859-3: llatí 3 (ISO), iso-8859-4: Bàltic (ISO), iso-8859-5: ciríl·lic (ISO), iso-8859-6: àrab (ISO), iso-8859-7: Grec (ISO), iso-8859-8: Hebreu (ISO-Visual), iso-8859-8-i: Hebreu (ISO-Lògic), iso-8859-9: Turc (ISO), Johab: coreà (Johab), koi8-r: ciríl·lic (KOI8-R), koi8-u: ciríl·lic (KOI8-U), ks_c_5601-1987: coreà, macintosh: Europa occidental (Mac), shift_jis#: coreà, macintosh: Europa occidental (Mac), #: coreà, macintosh: Europa occidental (Mac), #: coreà, macintosh: Europa occidental (Mac), : 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: centreeuropeu (Windows), Windows-1251: ciríl·lic (Windows), Windows-1252: Europa occidental (Windows), Windows-1253: Grec (Windows), Windows-1254: Turc (Windows), Windows-1255: Hebreu (Windows), Windows-1256: Àrab (Windows), Windows-1257: Bàltic (Windows), Windows-1258: Vietnamita (Windows), Windows-874: Tailandès (Windows), x-xinès-CNS: xinès tradicional (CNS), x-xinès-eten: xinè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: xinès simplificat (GB2312-80), x-cp20949: coreà Wansung, x-cp50227: xinès simplificat (ISO-2022), x-EBCDIC-coreàEstès: IBM EBCDIC (coreà estès), x-Europa: Europa, x-IA5: Europa occidental (IA5), x-IAia 5-Alemany: Alemany (IA5), x-IA5-Noruec: Noruec (IA5), x-IA5-Suec: Suec (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 Malaiàlam, x-iscii-o: ISCII Oriya, x-iscii-pa: ISCII Panjabi, x-iscii-ta: tàmil ISCII, x-iscii-te: ISCII telugu, x-mac-àrab: àrab (Mac), x-mac-ce: centreeuropeu (Mac), x-mac-xinès: xinès simplificat (Mac), x-mac-chinesetrad: xinès tradicional (Mac), x-mac-croat: croat (Mac), x-mac-ciríl·lic: ciríl·lic (Mac), x-mac-grec: grec (Mac), x-mac-hebreu: hebreu (Mac), x-mac-islandès: islandès (Mac), x-mac-japonès: japonès (Mac), x-mac-coreà: coreà (Mac), xinès (Mac), x-mac-romanès: romanès (Mac), x-mac-thai: tailandès (Mac), x-mac-turc: turc (Mac), x-mac-ucraïnès: ucraïnès (Mac)'	utf-8 : Unicode (UTF-8)	Codificació que s'utilitza durant la lectura de la sortida

Variables generades

Argument	Type	Descripció
CommandOutput	Valor de text	Sortida de text de l'ordre o de l'aplicació del DOS
MissióErrorSortida	Valor de text	Text que descriu els errors que s'han produït (si n'hi ha) durant l'execució de l'ordre o de l'aplicació del DOS
Codi de sortida d'ordres	Valor numèric	El codi de sortida de l'ordre o de l'aplicació. Aquest valor és numèric

Excepcions

Excepció	Descripció
No es pot executar l'ordre o l'aplicació de consola	Indica un problema en executar l'ordre o l'aplicació de consola especificada
No s'ha pogut executar l'script en el temps assignat	Indica un problema en executar l'script proporcionat en el temps assignat

Executa VBScript

Executa codi del VBScript personalitzat i en recupera la sortida en una variable.

Podeu utilitzar aquesta acció per incloure el vostre propi codi VBScript personalitzat al flux d'escriptori, alhora que teniu la possibilitat d'utilitzar-hi variables, per generar contingut VBScript dinàmic si cal.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
VBScript que s'ha d'executar	Sí	Valor de text		El codi VBScript que s'ha d'executar. Les variables es poden incloure dins de l'script ja que s'avaluen abans de l'execució del VBScript
S'ha produït un error després del temps d'espera	Sí	Valor booleà	N/A	Especifiqueu si l'script del VBScript s'executarà indefinidament o si es produirà un error després d'un període de temps definit
Temps d'espera	No	Valor numèric	10	Nombre màxim de segons que s'ha d'esperar perquè es completi l'script (-1 per indefinidament)

Variables generades

Argument	Type	Descripció
VBScriptOutput	Valor de text	Sortida de l'script
Error de script	Valor de text	Els errors que es poden produir durant l'execució del codi VBScript

Excepcions

Excepció	Descripció
No s'ha pogut executar l'script en el temps assignat	Indica un problema en executar l'script proporcionat en el temps assignat

Executa JavaScript

Executa codi del JavaScript personalitzat i en recupera la sortida en una variable.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
JavaScript que s'ha d'executar	Sí	Valor de text		El codi JavaScript a executar. Les variables es poden incloure dins de l'script ja que s'avaluen abans de l'execució del codi JavaScript
S'ha produït un error després del temps d'espera	Sí	Valor booleà		Especifiqueu si l'script del JavaScript s'executarà indefinidament o si es produirà un error després d'un període de temps definit
Temps d'espera	No	Valor numèric	10	Nombre màxim de segons que s'ha d'esperar perquè es completi l'script (-1 per indefinidament)

Variables generades

Argument	Type	Descripció
Sortida de Javascript	Valor de text	Sortida de l'script
Error de script	Valor de text	Els errors que es poden produir durant l'execució del codi JavaScript

Excepcions

Excepció	Descripció
No s'ha pogut executar l'script en el temps assignat	Indica un problema en executar l'script proporcionat en el temps assignat

Executa un script del PowerShell

Executa un script del PowerShell personalitzat i en recupera la sortida en una variable.

Podeu utilitzar aquesta acció per incloure el vostre propi codi personalitzat del PowerShell al flux de l'escriptori, alhora que teniu la capacitat d'utilitzar-hi variables, per generar contingut dinàmic del PowerShell si cal.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Codi del PowerShell que s'ha d'executar	Sí	Valor de text		El codi del PowerShell que s'ha d'executar. Les variables es poden incloure dins de l'script ja que s'avaluen abans de l'execució del codi del PowerShell
S'ha produït un error després del temps d'espera	Sí	Valor booleà		Especifiqueu si l'script del PowerShell s'executarà indefinidament o fallarà després d'un període de temps determinat
Temps d'espera	No	Valor numèric	10	Nombre màxim de segons que s'ha d'esperar perquè es completi l'script (-1 per indefinidament)

Variables generades

Argument	Type	Descripció
PowershellOutput	Valor de text	Sortida de l'script
Error de script	Valor de text	Els errors que es poden produir durant l'execució del codi del PowerShell

Excepcions

Excepció	Descripció
No s'ha pogut executar l'script del PowerShell	Indica un problema en executar l'script del PowerShell proporcionat
No s'ha pogut executar l'script en el temps assignat	Indica un problema en executar l'script proporcionat en el temps assignat

Executa un script del Python

Executa el codi d'script Python i recupera la seva sortida.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Script del Python que s'ha d'executar	No	Valor de text		El codi de script Python a executar
Versió de Python	No	Python 2.7, Python 3.4	Python 2.7	Especifiqueu quina versió de Python s'utilitzarà en executar l'script
Camins de les carpetes de mòduls	Sí	Llista de carpetes		Els camins de les carpetes on es troben els mòduls externs de Python

Variables generades

Argument	Type	Descripció
PythonScriptOutput	Valor de text	Sortida de l'script
Error de script	Valor de text	Els errors que es poden produir durant l'execució del codi de script Python

Excepcions

Excepció	Descripció
No s'ha pogut executar l'script del Python	Indica un problema en executar l'script del Python proporcionat
El directori no s'ha trobat	Indica que el directori no s'ha trobat

Executa un script del .NET

Executa el codi de script .NET (C#/VB.NET) i recupera la seva sortida.

Paràmetres d’entrada

Argument	Opcional	Accepta	Valor per defecte	Descripció
Llengua	N/A	C#/ VB.NET	C#	Llengua de l'script
Importacions d'scripts del .NET	Sí	Valor de text		Importacions d'script de .NET que s'han d'incloure a l'script
Referències que s'han de carregar	Sí	Carpeta		Camí arrel on es troben les referències de biblioteques d'enllaços dinàmics (fitxers .dll) del .NET
Paràmetres de script	Sí	Paràmetres de script definits per l'usuari		Definició dels valors dels paràmetres definits a l'script
Codi del .NET que s'ha d'executar	No	Valor de text		Codi .NET que s'executarà

Variables generades

Aquesta acció pot produir variables, depenent de la configuració feta per l'usuari quan utilitza la finestra Paràmetres de script.

Nota

En el cas que l'acció estigui configurada per produir paràmetres de sortida (utilitzant la direcció Out quan els configureu), sempre heu d'assegurar-vos que el paràmetre dins de l'script estigui establert en un valor diferent de nul. En cas contrari, l'execució de l'script produeix un error, ja que el paràmetre de sortida no s'ha establert.

Excepcions

Excepció	Descripció
No s'ha pogut executar l'script .NET	Indica un problema en executar l'script del .NET proporcionat