Tindakan skrip

Penting

Untuk mengelakkan akses yang tidak dibenarkan, Windows memerlukan hak pentadbir untuk mengakses sumber yang dilindungi. Untuk mengakses sumber yang dilindungi (seperti fail) menggunakan tindakan skrip, jalankan Power Automate dengan hak pentadbir. Untuk mendapatkan maklumat lanjut tentang bertanding Power Automate sebagai pentadbir, pergi ke Jalankan Power Automate dengan hak yang ditinggikan.

Tindakan skrip membolehkan anda menjalankan blok kod dan melaksanakan tingkah laku tersuai dalam aliran desktop anda.

Penting

Seperti yang diumumkan pada Oktober 2023, VBScript ditamatkan daripada Windows. Dalam keluaran Windows akan datang, VBScript akan tersedia sebagai ciri atas permintaan sebelum penyingkirannya daripada sistem pengendalian. Untuk maklumat lanjut, lihat Sumber untuk ciri yang ditamatkan.

Semua tindakan skrip mengikut struktur asas bahasa pengaturcaraan atau skrip masing-masing: PowerShell, Python, VBScript, JavaScript dan C#/VB.NET.

Nota

Versi yang disokong untuk C#: v 5.0. Untuk VB.NET: v 11.0

Bahasa semula jadi kepada skrip yang dikuasakan oleh copilot (pratonton)

[Topik ini ialah dokumentasi prakeluaran dan tertakluk kepada perubahan.]

Bahasa semula jadi kepada kod ialah keupayaan copilot baharu yang ditambah untuk Power Automate desktop. Ia membolehkan anda menjana kod yang digunakan dalam tindakan skrip dengan cepat dengan menerangkannya. Ciri ini tersedia dalam tindakan skrip berikut:

• Jalankan PowerShell
• Jalankan VBScript
• Jalankan arahan DOS
• Jalankan Python
• Jalankan JavaScript

Penting

• Ini adalah ciri pratonton.
• Ciri pratonton bukan untuk kegunaan pengeluaran dan kefungsian mungkin terbatas. Ciri ini tersedia sebelum keluaran rasmi agar pelanggan boleh mendapat akses awal dan memberikan maklum balas.

Ketersediaan mengikut rantau

Pada masa ini, copilot in Power Automate untuk desktop hanya tersedia dalam persekitaran yang terletak di Amerika Syarikat.

Ketersediaan mengikut jenis akaun

Pada masa ini, copilot masuk Power Automate untuk desktop hanya tersedia untuk pengguna yang mempunyai akaun kerja atau sekolah.

Nota

Jika persekitaran anda berada di salah satu rantau yang disenaraikan sebelum ini dan anda masih perlu melihat copilot dalam Power Automate pengalaman desktop, hubungi pentadbir penyewa anda. Mereka mungkin telah mematikan fungsi copilot.

Cara menjana skrip menggunakan copilot dan bahasa semula jadi

Untuk menjana skrip dalam salah satu tindakan skrip yang disokong, seret dan lepaskan tindakan dalam pereka bentuk dan pilih Jana skrip dengan Copilot.

Skrin gesaan cipta terbuka di mana anda boleh menaip gesaan bahasa semula jadi anda.

Untuk mencipta skrip, tulis gesaan anda dan pilih Jana. Jika anda perlu menciptanya semula, anda boleh menukar gesaan dan memilih Jana semula. Jika tidak, pilih Gunakan skrip ini untuk kembali ke tetingkap tindakan utama, di mana anda boleh mengubah suainya dan menambah sebarang pembolehubah yang diperlukan.

Penting

Pastikan anda sentiasa menyemak kandungan yang dijana oleh model AI.

Bantu kami menambah baik ciri ini

Hantar maklum balas dengan memilih ikon ibu jari ke atas atau ibu jari ke bawah di bawah kandungan yang dijana AI. Sebaik sahaja anda melakukannya, dialog maklum balas muncul, yang boleh anda gunakan untuk menyerahkan maklum balas kepada Microsoft.

Nota

Jika anda tidak dapat melihat dialog, pentadbir penyewa anda mungkin telah mematikannya. Maklumat lanjut: Melumpuhkan fungsi maklum balas pengguna

Melumpuhkan fungsi maklum balas pengguna

Sebagai Power Platform pentadbir, halang pengguna daripada menghantar maklum balas Copilot kepada Microsoft dengan menggunakan tetapan penyewa "Maklum balas Copilot".

Permintaan hak subjek data mengenai maklum balas pengguna

Pentadbir penyewa boleh melihat, mengeksport dan memadamkan maklum balas daripada pengguna mereka dengan log masuk ke Microsoft 365 pusat pentadbiran dan kemudian memilih maklum balas> Produk Kesihatan.

AI dengan Power Automate sumber

• Soalan Lazim untuk Menjana skrip dengan bahasa semula jadi
• Soalan Lazim AI yang Bertanggungjawab untuk Power Automate
• Soalan Lazim untuk keselamatan dan privasi data Copilot dalam Microsoft Power Platform

Bekerja dengan pembolehubah dalam tindakan skrip

Untuk mengisytiharkan pembolehubah dalam tindakan skrip dan mengembalikan hasil Power Automate, gunakan arahan berikut:

• Untuk mengisytiharkan pemboleh ubah baharu dalam skrip PowerShell, gunakan $ notasi. Untuk mengembalikan nilai daripada Jalankan tindakan skrip PowerShell kepada Power Automate, gunakan perintah Tulis-Output .

  $variableName = "variableValue"
  Write-Output $variableName
  

• Skrip Python tidak memerlukan sebarang notasi khas untuk mengisytiharkan pembolehubah baharu. Untuk mengembalikan nilai daripada tindakan skrip Jalankan Python, gunakan fungsi cetak .

  variableName = "variableValue"
  print variableName
  

• VBScript tidak memerlukan sebarang notasi khas untuk mengisytiharkan pembolehubah baharu. Gunakan fungsi WScript.Echo untuk mengembalikan nilai daripada Jalankan tindakan VBScript kepada Power Automate.

  variableName = "variableValue"
  WScript.Echo variableName
  

• Dalam skrip JavaScript, gunakan notasi var untuk mengisytiharkan pembolehubah baharu dan fungsi WScript.Echo untuk mengembalikan nilai daripada tindakan Jalankan JavaScript .

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

• Untuk skrip .NET, gunakan tetingkap Parameter Skrip , diakses melalui kad konfigurasi tindakan skrip Jalankan .NET. Anda boleh menetapkan jenis pembolehubah masing-masing:

Di samping itu, anda boleh menetapkan sama ada ia input kepada skrip .NET (Pilihan Dalam dalam juntai bawah arah), output skrip (Pilihan Keluar dalam juntai bawah Arah) atau kedua-duanya (pilihan Masuk-Keluar dalam juntai lungsur Arah).

Untuk menggunakan Power Automate pembolehubah dalam tindakan skrip, gunakan notasi peratusan (%) dan kendalikan pembolehubah dengan cara yang sama seperti nilai berkod keras.

Jalankan perintah DOS

Melaksanakan arahan DOS atau aplikasi konsol dalam mod yang tidak kelihatan dan mendapatkan semula outputnya setelah selesai.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Perintah DOS atau aplikasi	No	Fail		Nama perintah DOS atau aplikasi konsol, dengan argumen jika berkenaan
Folder kerja	Ya	Folder		Laluan penuh folder untuk dikerjakan, jika berkenaan
Gagal selepas tamat masa	Ya	Nilai Boolean		Tentukan sama ada perintah DOS atau aplikasi akan berjalan dalam tempoh masa yang tidak terbatas atau gagal selepas tempoh masa yang ditetapkan
Tamat masa	No	Nilai berangka	10	Bilangan maksimum saat untuk menunggu skrip selesai (-1 untuk tempoh masa yang tidak terbatas)
Ubah halaman kod	T/B	Nilai Boolean	Salah	Menentukan sama ada untuk mengubah halaman kod semasa sesi
Pengekodan	No	ASMO-708: Arab (ASMO 708), big5: Tradisional Cina (Big5), cp1025: IBM EBCDIC (Sirilik Serbia-Bulgaria), cp866: Cyrillic (DOS), cp875: IBM EBCDIC (Greek Modern), csISO2022JP: Jepun (JIS-Allow 1 bait Kana), DOS-720: Arab (DOS), DOS-862: Ibrani (DOS), EUC-CN: Cina Ringkas (EUC), EUC-JP: Jepun (JIS 0208-1990 dan 0212-1990), euc-jp: Jepun (EUC), euc-kr: Korea (EUC), GB18030: Cina Ringkas (GB18030), gb2312: Bahasa Cina Dipermudahkan (GB2312), hz-gb-2312: Cina Ringkas (HZ), IBM-Thai: IBM EBCDIC (Thai), IBM00858: OEM Berbilang Bahasa Latin I, IBM00924: IBM Latin-1, IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (AS-Kanada-Euro), IBM01141: IBM EBCDIC (Jerman-Euro), IBM01142: IBM EBCDIC (Denmark-Norway-Euro), IBM01143: IBM EBCDIC (Finland-Sweden-Euro), IBM01144: IBM EBCDIC (Itali Euro), IBM01145: IBM EBCDIC (Sepanyol-Euro), IBM01146: IBM EBCDIC (UK-Euro), IBM01147: IBM EBCDIC (Perancis-Euro), IBM01148: IBM EBCDIC (Antarabangsa-Euro), IBM01149: IBM EBCDIC (Iceland-Euro), IBM037: IBM EBCDIC (AS-Kanada), IBM1026: IBM EBCDIC (Turki Latin-5), IBM273: IBM EBCDIC (Jerman), IBM277: IBM EBCDIC (Denmark-Norway), IBM278: IBM EBCDIC (Finland-Sweden), IBM280: IBM EBCDIC (Itali), IBM284: IBM EBCDIC (Sepanyol), IBM285: IBM EBCDIC (UK), IBM290: IBM EBCDIC (katakana Jepun), IBM297: IBM EBCDIC (Perancis), IBM420: IBM EBCDIC (Arab), IBM423: IBM EBCDIC (Yunani), IBM424: IBM EBCDIC (Ibrani), IBM437: OEM Amerika Syarikat, IBM500: IBM EBCDIC (Antarabangsa), ibm737: Yunani (DOS), ibm775: Baltik (DOS), ibm850: Eropah Barat (DOS), ibm852: Eropah Tengah (DOS), IBM855: OEM Cyrillic, ibm857: Turki (DOS), IBM860: Portugis (DOS), ibm861: Iceland (DOS), IBM863: Kanada Perancis (DOS), IBM864: Arab (864), IBM865: Nordic (DOS), ibm869: Yunani, Moden (DOS), IBM870: IBM EBCDIC (Latin Berbilang Bahasa-2), IBM871: IBM EBCDIC (Iceland), IBM880: IBM EBCDIC (Cyrillic Russian), IBM905: IBM EBCDIC (Turki), iso-2022-jp: Jepun (JIS), iso-2022-jp: Jepun (JIS-Allow 1 bait Kana - SO/SI), iso-2022-kr: Korea (ISO), iso-8859-1: Eropah Barat (ISO), iso-8859-13: Estonia (ISO), iso-8859-15: Latin 9 (ISO), iso-8859-2: Eropah Tengah (ISO), iso-8859-3: Latin 3 (ISO), iso-8859-4: Baltik (ISO), iso-8859-5: Cyrillic (ISO), iso-8859-6: Arab (ISO), iso-8859-7: Yunani (ISO), iso-8859-8: Ibrani (ISO-Visual), iso-8859-8-i: Ibrani (ISO-Logik), iso-8859-9: Turki (ISO), Johab: Korea (Johab), koi8-r: Cyrillic (KOI8-R), koi8-u: Cyrillic (KOI8-U), ks_c_5601-1987: Korea, macintosh: Eropah Barat (Mac), shift_jis: Jepun (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: Eropah Tengah (Windows), windows-1251: Cyrillic (Windows), Windows-1252: Eropah Barat (Windows), windows-1253: Yunani (Windows), windows-1254: Turki (Windows), windows-1255: Ibrani (Windows), windows-1256: Arab (Windows), windows-1257: Baltik (Windows), windows-1258: Vietnam (Windows), windows-874: Thai (Windows), x-Chinese-CNS: Chinese Traditional (CNS), 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-cp20269: ISO-6937, x-cp20936: Cina Dipermudahkan (GB2312-80), x-cp20949: Korean Wansung, x-cp50227: Cina Dipermudahkan (ISO-2022), x-EBCDIC-KoreanExtended: IBM EBCDIC (Korean Extended), x-Europa: Europa, x-IA5: Eropah Barat (IA5), x-IA5-Jerman: Jerman (IA5), x-IA5-Norway: Norway (IA5), x-IA5-Sweden: Sweden (IA5), x-iscii-as: ISCII Assam, 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-atau: ISCII Oriya, x-iscii-pa: ISCII Punjabi, x-iscii-ta: ISCII Tamil, x-iscii-te: ISCII Telugu, x-mac-arab: Arab (Mac), x-mac-ce: Eropah Tengah (Mac), x-mac-chinesesimp: Cina Ringkas (Mac), x-mac-chinesetrad: Cina Tradisional (Mac), x-mac-croatian: Croatia (Mac), x-mac-cyrillic: Cyrillic (Mac), x-mac-greek: Yunani (Mac), x-mac-hebrew: Ibrani (Mac), x-mac-icelandic: Iceland (Mac), x-mac-jepun: Jepun (Mac), x-mac-korea: Korea (Mac), x-mac-romanian: Romania (Mac), x-mac-thai: Thai (Mac), x-mac-turkish: Turki (Mac), x-mac-ukraine: Ukraine (Mac)'	utf-8 : Unicode (UTF-8)	Pengekodan untuk digunakan apabila membaca output

Pemboleh ubah yang dihasilkan

Argumen	Jenis	Description
Output Perintah	Nilai teks	Output teks daripada perintah DOS atau aplikasi
CommandErrorOutput	Nilai teks	Teks yang menerangkan ralat telah berlaku (jika ada) semasa pelaksanaan perintah DOS atau aplikasi
Kod Keluar Perintahkan	Nilai berangka	Kod keluar arahan atau aplikasi. Nilai ini berangka

Pengecualian

Pengecualian	Description
Tidak dapat melaksanakan perintah atau aplikasi konsol	Menunjukkan masalah semasa melaksanakan perintah atau aplikasi konsol yang ditentukan
Gagal menjalankan skrip dalam masa yang diuntukkan	Menunjukkan masalah ketika menjalankan skrip yang diberikan dalam masa yang diuntukkan

Jalankan VBScript

Melaksanakan beberapa kod VBScript tersuai dan mengambil outputnya ke dalam pemboleh ubah.

Anda boleh menggunakan tindakan ini untuk memasukkan kod VBScript tersuai anda sendiri dalam aliran desktop, sambil juga mempunyai keupayaan untuk menggunakan pembolehubah di dalamnya, untuk menjana kandungan VBScript dinamik jika perlu.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
VBScript untuk dijalankan	Ya	Nilai teks		Kod VBScript untuk dilaksanakan. Pembolehubah mungkin disertakan dalam skrip kerana ia menilai sebelum pelaksanaan VBScript
Gagal selepas tamat masa	Ya	Nilai Boolean	T/B	Tentukan sama ada skrip VBScript akan berjalan dalam tempoh masa yang tidak terbatas atau gagal selepas tempoh masa yang ditetapkan
Tamat masa	No	Nilai berangka	10	Bilangan maksimum saat untuk menunggu skrip selesai (-1 untuk tempoh masa yang tidak terbatas)

Pemboleh ubah yang dihasilkan

Argumen	Taip	Description
VBScriptOutput	Nilai teks	Output skrip
SkripRalat	Nilai teks	Ralat yang mungkin berlaku semasa pelaksanaan kod VBScript

Pengecualian

Pengecualian	Description
Gagal menjalankan skrip dalam masa yang diuntukkan	Menunjukkan masalah ketika menjalankan skrip yang diberikan dalam masa yang diuntukkan

Jalankan JavaScript

Melaksanakan beberapa kod JavaScript tersuai dan mengambil outputnya ke dalam pemboleh ubah.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
JavaScript untuk dijalankan	Ya	Nilai teks		Kod JavaScript untuk dilaksanakan. Pembolehubah mungkin disertakan dalam skrip kerana ia menilai sebelum pelaksanaan kod JavaScript
Gagal selepas tamat masa	Ya	Nilai Boolean		Tentukan sama ada skrip JavaScript akan berjalan dalam tempoh masa yang tidak terbatas atau gagal selepas tempoh masa yang ditetapkan
Tamat masa	No	Nilai berangka	10	Bilangan maksimum saat untuk menunggu skrip selesai (-1 untuk tempoh masa yang tidak terbatas)

Pemboleh ubah yang dihasilkan

Argumen	Jenis	Description
Keluaran Javascript	Nilai teks	Output skrip
SkripRalat	Nilai teks	Ralat yang mungkin berlaku semasa pelaksanaan kod JavaScript

Pengecualian

Pengecualian	Description
Gagal menjalankan skrip dalam masa yang diuntukkan	Menunjukkan masalah ketika menjalankan skrip yang diberikan dalam masa yang diuntukkan

Jalankan skrip PowerShell

Melaksanakan beberapa skrip PowerShell tersuai dan mengambil outputnya ke dalam pemboleh ubah.

Anda boleh menggunakan tindakan ini untuk memasukkan kod PowerShell tersuai anda sendiri dalam aliran desktop, sambil juga mempunyai keupayaan untuk menggunakan pembolehubah di dalamnya, untuk menjana kandungan PowerShell dinamik jika perlu.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Kod PowerShell untuk dijalankan	Ya	Nilai teks		Kod PowerShell untuk dilaksanakan. Pembolehubah boleh disertakan dalam skrip kerana ia menilai sebelum pelaksanaan kod PowerShell
Gagal selepas tamat masa	Ya	Nilai Boolean		Tentukan sama ada skrip PowerShell akan berjalan selama-lamanya atau gagal selepas tempoh masa yang ditetapkan
Tamat masa	No	Nilai berangka	10	Bilangan maksimum saat untuk menunggu skrip selesai (-1 untuk tempoh masa yang tidak terbatas)

Pemboleh ubah yang dihasilkan

Argumen	Taip	Description
Output Powershell	Nilai teks	Output skrip
SkripRalat	Nilai teks	Ralat yang mungkin berlaku semasa pelaksanaan kod PowerShell

Pengecualian

Pengecualian	Description
Gagal menjalankan skrip PowerShell	Menunjukkan masalah semasa menjalankan skrip PowerShell yang disediakan
Gagal menjalankan skrip dalam masa yang diuntukkan	Menunjukkan masalah ketika menjalankan skrip yang diberikan dalam masa yang diuntukkan

Jalankan skrip Python

Melaksanakan kod skrip Python dan mendapatkan semula outputnya.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Skrip Python untuk dijalankan	No	Nilai teks		Kod skrip Python untuk dilaksanakan
Versi Python	No	Python 2.7, Python 3.4	Python 2.7	Tentukan versi Python untuk digunakan semasa melaksanakan skrip
Laluan folder modul	Ya	SenaraiFolder		Laluan folder di mana modul Python luaran terletak

Pemboleh ubah yang dihasilkan

Argumen	Jenis	Description
PythonScriptOutput	Nilai teks	Output skrip
SkripRalat	Nilai teks	Ralat yang mungkin berlaku semasa pelaksanaan kod skrip Python

Pengecualian

Pengecualian	Description
Gagal menjalankan skrip Python	Menunjukkan masalah semasa menjalankan skrip Python yang disediakan
Direktori tidak ditemui	Menunjukkan bahawa direktori tidak ditemui

Jalankan skrip .NET

Melaksanakan kod skrip .NET (C#/VB.NET) dan mendapatkan semula outputnya.

Parameter input

Argumen	Pilihan	Menerima	Nilai Lalai	Description
Bahasa	T/B	C#/ VB.NET	C#	Bahasa skrip
Import skrip .NET	Ya	Nilai teks		Import skrip .NET untuk disertakan dalam skrip
Rujukan untuk dimuatkan	Ya	Folder		Laluan akar yang terletaknya rujukan pustaka pautan dinamik .NET (.dll fail)
Parameter skrip	Ya	Parameter Skrip seperti yang ditakrifkan oleh pengguna		Menetapkan nilai parameter yang ditakrifkan dalam skrip
Kod .NET untuk dijalankan	No	Nilai teks		Kod .NET untuk dijalankan

Pemboleh ubah yang dihasilkan

Tindakan ini mungkin menghasilkan pembolehubah, bergantung pada konfigurasi yang dibuat oleh pengguna apabila menggunakan tetingkap Parameter Skrip .

Nota

Dalam kes tindakan dikonfigurasikan untuk menghasilkan parameter output (menggunakan arah Keluar semasa mengkonfigurasinya), anda harus sentiasa memastikan bahawa parameter dalam skrip ditetapkan kepada nilai selain daripada null. Jika tidak, pelaksanaan skrip mengakibatkan ralat kerana parameter output belum ditetapkan.

Pengecualian

Pengecualian	Description
Gagal menjalankan skrip .NET	Menunjukkan masalah semasa menjalankan skrip .NET yang disediakan