Accions de scripting
Important
Per evitar l'accés no autoritzat, Windows requereix drets d'administrador per accedir als recursos protegits. Per accedir a recursos protegits (com ara fitxers) mitjançant les accions de script, executeu-les Power Automate amb drets d'administrador. Per trobar més informació sobre com executar-se Power Automate com a administrador, aneu a Executa 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 una característica sota demanda abans de la seva eliminació del sistema operatiu. Per obtenir més informació, vegeu Recursos per a funcions obsoletes.
Totes les accions de scripting segueixen l'estructura bàsica del respectiu llenguatge de programació o scripting: PowerShell, Python, VBScript, JavaScript i C#/VB.NET.
Nota
Versió suportada per a C#: v 5.0. Per VB.NET: v 11.0
Llenguatge natural a script alimentat per copilot (vista prèvia)
[Aquest tema és documentació prèvia a la publicació i està subjecte a canvis.]
El llenguatge natural per codificar és una nova capacitat de copilot afegida a l'escriptori Power Automate . Permet generar ràpidament codi utilitzat en les accions de scripting descrivint-lo. Aquesta característica està disponible en les següents accions de scripting:
- Executeu el PowerShell
- Executeu VBScript
- Executeu l'ordre DOS
- Executeu Python
- Executa 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, el copilot en Power Automate per a escriptori només està disponible en entorns ubicats als Estats Units.
Disponibilitat per tipus de compte
Actualment, el copilot per a Power Automate l'escriptori només està disponible per als usuaris amb un compte laboral o acadèmic.
Nota
Si el vostre entorn es troba a la regió de la llista anterior i encara heu de veure el copilot per gaudir de l'experiència d'escriptori, poseu-vos en Power Automate contacte amb l'administrador d'inquilins. É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 un script amb Copilot.
S'obre la pantalla de creació de l'indicador on podeu escriure l'indicador d'idioma natural.
Per crear un script, escriviu l'indicador i seleccioneu Genera. Si necessiteu tornar a crear-lo, podeu canviar la sol·licitud i seleccionar Regenera. En cas contrari, seleccioneu Utilitza aquesta seqüència per tornar a la finestra d'acció principal, on podeu modificar-la i afegir les variables necessàries.
Important
Assegura't de revisar sempre el contingut generat pel model d'IA.
Ajuda'ns a millorar aquesta funció
Per enviar suggeriments, seleccioneu la icona polze cap amunt o polze cap avall 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 de l'usuari
Desactivació de la funcionalitat de comentaris dels usuaris
Com a administrador d'inquilins, podeu evitar que els usuaris enviïn comentaris a Microsoft inhabilitant la configuració de l'inquilí disableSurveyFeedback . Obteniu més informació sobre com podeu consultar i configurar la configuració de l'inquilí:
Sol·licituds de drets dels interessats sobre comentaris dels usuaris
Els administradors d'inquilins poden veure, exportar i suprimir els comentaris dels seus usuaris iniciant sessió al centre d'administració Microsoft 365 i, a continuació, seleccionantComentaris sobre productes sanitaris >.
IA amb Power Automate recursos
- Preguntes freqüents per generar scripts amb llenguatge natural
- Preguntes freqüents responsables d'IA per a Power Automate
- Preguntes freqüents per a la seguretat i privacitat de dades de Copilot en Microsoft Power Platform
Treballar amb variables en accions de scripting
Per declarar variables a les accions de script 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 del Run PowerShell a , utilitzeu l'ordre Power AutomateWrite-Output .
$variableName = "variableValue" Write-Output $variableNameEls scripts Python no requereixen cap notació especial per declarar noves variables. Per retornar valors de les accions de l'script Executa Python, utilitzeu la funció d'impressió .
variableName = "variableValue" print variableNameVBScript 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 variableNameEn 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 a través de la targeta de configuració de l'acció Executa l'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ó desplegable En direcció), una sortida de l'script (opció de sortida al menú desplegable Direcció ) o totes dues (opció In-Out al menú desplegable Direcció).
Per utilitzar Power Automate variables en les accions de scripting, utilitzeu la notació percentual (%) i manegeu 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 del text | Sortida de text de l'ordre o de l'aplicació del DOS |
| CommandErrorOutput | Valor del 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 |
| CommandExitCode | 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 capacitat d'utilitzar-hi variables, per generar contingut dinàmic VBScript si cal.
Paràmetres d’entrada
| Argument | Opcional | Accepta | Valor per defecte | Descripció |
|---|---|---|---|---|
| VBScript que s'ha d'executar | Sí | Valor del text | El codi VBScript a executar. Es poden incloure variables 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 del text | Sortida de l'script |
| ScriptError | Valor del text | 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 del text | El codi JavaScript a executar. Es poden incloure variables dins de l'script, ja que 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ó |
|---|---|---|
| JavascriptOutput | Valor del text | Sortida de l'script |
| ScriptError | Valor del text | Errors que es poden produir durant l'execució del codi de script de 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 del text | El codi del PowerShell a executar. Es poden incloure variables dins de l'script ja que avaluen abans de l'execució del codi de PowerShell | |
| S'ha produït un error després del temps d'espera | Sí | Valor booleà | Especifiqueu si la seqüència del PowerShell s'executarà indefinidament o fallarà 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ó |
|---|---|---|
| PowershellOutput | Valor del text | Sortida de l'script |
| ScriptError | Valor del text | 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 de l'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 del text | El codi de l'script Python per executar | |
| Versió de Python | No | Python 2.7, Python 04/03 | 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 | Camins de les carpetes on es troben els mòduls externs del Python |
Variables generades
| Argument | Type | Descripció |
|---|---|---|
| PythonScriptOutput | Valor del text | Sortida de l'script |
| ScriptError | Valor del text | Errors que es poden produir durant l'execució del codi de script del 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 del 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 l'script | Sí | Paràmetres de script definits per l'usuari | Configuració dels valors dels paràmetres que es defineixen a l'script | |
| Codi del .NET que s'ha d'executar | No | Valor del text | Codi .NET que s'executarà |
Variables generades
Aquesta acció pot produir variables, depenent de la configuració realitzada per l'usuari quan utilitzi la finestra Paràmetres de script.
Nota
En el cas que l'acció estigui configurada per produir paràmetres de sortida (utilitzant la direcció Sortida en configurar-los), sempre heu d'assegurar-vos que el paràmetre dins de l'script estigui establert en un valor diferent de null. En cas contrari, l'execució de l'script donarà lloc a un error, ja que el paràmetre de sortida no s'ha definit.
Excepcions
| Excepció | Descripció |
|---|---|
| No s'ha pogut executar l'script .NET | Indica un problema en executar l'script del .NET proporcionat |
Comentaris
Properament: al llarg del 2024 eliminarem gradualment GitHub Issues com a mecanisme de retroalimentació del contingut i el substituirem per un nou sistema de retroalimentació. Per obtenir més informació, consulteu: https://aka.ms/ContentUserFeedback.
Envieu i consulteu els comentaris de