Tindakan penskripan
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 penskripan, jalankan Power Automate dengan hak pentadbir. Untuk mendapatkan maklumat lanjut tentang berjalan Power Automate sebagai pentadbir, pergi ke Jalankan Power Automate dengan hak yang tinggi.
Tindakan penskripan membolehkan anda menjalankan blok kod dan melaksanakan kelakuan tersuai dalam aliran desktop anda.
Penting
Seperti yang diumumkan pada Oktober 2023, VBScript ditamatkan daripada Windows. Dalam keluaran Windows pada masa hadapan, VBScript akan tersedia sebagai ciri atas permintaan sebelum dialih keluar daripada sistem pengendalian. Untuk maklumat lanjut, lihat Sumber untuk ciri yang ditamatkan.
Semua tindakan penskripan mengikut struktur asas pengaturcaraan atau bahasa 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 semulajadi untuk skrip yang dikuasakan oleh copilot (pratonton)
[Topik ini adalah dokumentasi prerelease dan tertakluk kepada perubahan.]
Bahasa semulajadi kepada kod ialah keupayaan copilot baharu yang ditambahkan untuk Power Automate desktop. Ia membolehkan anda menjana kod yang digunakan dengan cepat dalam tindakan penskripan dengan menerangkannya. Ciri ini tersedia dalam tindakan penskripan 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 in Power Automate untuk desktop hanya tersedia untuk pengguna yang mempunyai akaun kerja atau sekolah.
Nota
Jika persekitaran anda berada di rantau yang disenaraikan di atas dan anda masih perlu melihat copilot untuk Power Automate pengalaman desktop, hubungi pentadbir penyewa anda. Mereka mungkin telah mematikan fungsi copilot.
Bagaimana untuk menjana skrip menggunakan copilot dan bahasa semula jadi
Untuk menjana skrip dalam salah satu tindakan penskripan yang disokong seret dan lepaskan tindakan dalam pereka bentuk dan pilih Hasilkan 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 pilih Jana semula. Jika tidak, pilih Gunakan skrip ini untuk kembali ke tetingkap tindakan utama, di mana anda boleh mengubahnya dan menambah sebarang pemboleh ubah yang diperlukan.
Penting
Pastikan anda sentiasa menyemak kandungan yang dihasilkan 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 melihat dialog, pentadbir penyewa anda mungkin telah mematikannya. Maklumat lanjut: Menyahdayakan kefungsian maklum balas pengguna
Menyahdayakan kefungsian maklum balas pengguna
Sebagai pentadbir penyewa, anda boleh menghalang pengguna anda daripada menghantar maklum balas kepada Microsoft dengan menyahdayakan disableSurveyFeedback seting penyewa. Dapatkan maklumat lanjut tentang melihat dan mengesetkan seting penyewa:
Permintaan hak subjek data mengenai maklum balas pengguna
Pentadbir penyewa boleh melihat, mengeksport dan memadamkan maklum balas daripada pengguna mereka dengan mengelog masuk ke Microsoft 365 pusat pentadbiran kemudian memilihmaklum 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 pemboleh ubah dalam tindakan penskripan
Untuk mengisytiharkan pemboleh ubah dalam tindakan penskripan dan mengembalikan Power Automate hasil, gunakan perintah berikut:
Untuk mengisytiharkan pemboleh ubah baru dalam skrip PowerShell, gunakan $ notasi. Untuk mengembalikan nilai daripada menjalankan tindakan skrip PowerShell kepada Power Automate, gunakan perintah Output-Tulis .
$variableName = "variableValue" Write-Output $variableNameSkrip Python tidak memerlukan sebarang notasi khas untuk mengisytiharkan pembolehubah baru. Untuk mengembalikan nilai daripada menjalankan tindakan skrip Python, gunakan fungsi cetak .
variableName = "variableValue" print variableNameVBScript tidak memerlukan sebarang notasi khas untuk mengisytiharkan pembolehubah baru. Gunakan fungsi WScript.Echo untuk mengembalikan nilai daripada tindakan Run VBScript kepada Power Automate.
variableName = "variableValue" WScript.Echo variableNameDalam skrip JavaScript, gunakan notasi var untuk mengisytiharkan pemboleh ubah baru dan fungsi WScript.Echo untuk mengembalikan nilai daripada tindakan Run JavaScript .
var variableName = "variableValue"; WScript.Echo(variableName);Untuk skrip .NET, gunakan tetingkap Parameter Skrip , dicapai melalui kad konfigurasi tindakan skrip Run .NET. Anda boleh menetapkan jenis pembolehubah masing-masing:
Selain itu, anda boleh menetapkan sama ada ia merupakan input kepada skrip .NET ( Dalam pilihan dalam juntai bawah Arah), output skrip (Pilihan keluar dalam juntai bawah Arah) atau kedua-duanya (Pilihan Dalam arah juntai bawah).
Untuk menggunakan Power Automate pemboleh ubah dalam tindakan penskripan, gunakan notasi peratusan (%) dan kendalikan pemboleh ubah dengan cara yang sama seperti nilai berkod keras.
Jalankan perintah DOS
Melaksanakan arahan DOS atau aplikasi konsol dalam mod yang tidak kelihatan dan mengambil 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 angka | 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: Bahasa Arab (ASMO 708), big5: Tradisional Cina (Big5), cp1025: IBM EBCDIC (Cyrillic Serbia-Bulgarian), cp866: Cyrillic (DOS), cp875: IBM EBCDIC (Greek Modern), csISO2022JP: Jepun (JIS-Allow 1 byte Kana), DOS-720: Bahasa 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: Cina Ringkas (GB2312), hz-gb-2312: Cina Ringkas (HZ), IBM-Thai: IBM EBCDIC (Thai), IBM00858: OEM Latin Berbilang Bahasa I, IBM00924: IBM Latin-1, IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (US-Canada-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 (France-Euro), IBM01148: IBM EBCDIC (International-Euro), IBM01149: IBM EBCDIC (Iceland-Euro), IBM037: IBM EBCDIC (US-Canada), IBM1026: IBM EBCDIC (Turkish 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 (Bahasa Arab), IBM423: IBM EBCDIC (Greek), IBM424: IBM EBCDIC (Ibrani), IBM437: OEM Amerika Syarikat, IBM500: IBM EBCDIC (Antarabangsa), ibm737: Greek (DOS), ibm775: Baltic (DOS), ibm850: Eropah Barat (DOS), ibm852: Eropah Tengah (DOS), IBM855: OEM Cyrillic, ibm857: Turki (DOS), IBM860: Portugis (DOS), ibm861: Iceland (DOS), IBM863: Perancis Kanada (DOS), IBM864: Arab (864), IBM865: Nordic (DOS), ibm869: Greek, Modern (DOS), IBM870: IBM EBCDIC (Latin Berbilang Bahasa-2), IBM871: IBM EBCDIC (Icelandic), IBM880: IBM EBCDIC (Cyrillic Russian), IBM905: IBM EBCDIC (Turki), iso-2022-jp: Jepun (JIS), iso-2022-jp: Jepun (JIS-Benarkan 1 bait Kana - SO/SI), iso-2022-kr: Korea (ISO), iso-8859-1: Eropah Barat (ISO), iso-8859-13: Estonian (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: Greek (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: Greek (Windows), windows-1254: Turki (Windows), windows-1255: Hebrew (Windows), windows-1256: Arabic (Windows), windows-1257: Baltic (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 Ringkas (GB2312-80), x-cp20949: Korean Wansung, x-cp50227: Chinese Simplified (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 Assamese, 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-or: ISCII Oriya, x-iscii-pa: ISCII Punjabi, x-iscii-ta: ISCII Tamil, x-iscii-te: ISCII Telugu, x-mac-arabic: Arabic (Mac), x-mac-ce: Eropah Tengah (Mac), x-mac-chinesesimp: Cina Ringkas (Mac), x-mac-chinesetrad: Cina Tradisional (Mac), x-mac-croatian: Croatian (Mac), x-mac-cyrillic: Cyrillic (Mac), x-mac-greek: Greek (Mac), x-mac-hebrew: Hebrew (Mac), x-mac-icelandic: Icelandic (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 | Taip | Description |
|---|---|---|
| CommandOutput | 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 |
| CommandExitCode | Nilai angka | Kod keluar arahan atau aplikasi. Nilai ini ialah angka |
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, sementara juga mempunyai keupayaan untuk menggunakan pembolehubah di dalamnya, untuk menjana kandungan VBScript dinamik jika diperlukan.
Parameter input
| Argumen | Pilihan | Menerima | Nilai Lalai | Description |
|---|---|---|---|---|
| VBScript untuk dijalankan | Ya | Nilai teks | Kod VBScript untuk dilaksanakan. Pemboleh ubah boleh dimasukkan dalam skrip kerana mereka 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 angka | 10 | Bilangan maksimum saat untuk menunggu skrip selesai (-1 untuk tempoh masa yang tidak terbatas) |
Pemboleh ubah yang dihasilkan
| Argumen | Jenis | Description |
|---|---|---|
| VBScriptOutput | Nilai teks | Output skrip |
| ScriptError | 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. Pemboleh ubah boleh dimasukkan 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 angka | 10 | Bilangan maksimum saat untuk menunggu skrip selesai (-1 untuk tempoh masa yang tidak terbatas) |
Pemboleh ubah yang dihasilkan
| Argumen | Jenis | Description |
|---|---|---|
| JavascriptOutput | Nilai teks | Output skrip |
| ScriptError | 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, di samping mempunyai keupayaan untuk menggunakan pemboleh ubah di dalamnya, untuk menjana kandungan PowerShell dinamik jika diperlukan.
Parameter input
| Argumen | Pilihan | Menerima | Nilai Lalai | Description |
|---|---|---|---|---|
| Kod PowerShell untuk dijalankan | Ya | Nilai teks | Kod PowerShell untuk dilaksanakan. Pemboleh ubah boleh dimasukkan 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 angka | 10 | Bilangan maksimum saat untuk menunggu skrip selesai (-1 untuk tempoh masa yang tidak terbatas) |
Pemboleh ubah yang dihasilkan
| Argumen | Jenis | Description |
|---|---|---|
| PowershellOutput | Nilai teks | Output skrip |
| ScriptError | 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 mengambil 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 yang terletaknya modul Python luaran |
Pemboleh ubah yang dihasilkan
| Argumen | Taip | Description |
|---|---|---|
| PythonScriptOutput | Nilai teks | Output skrip |
| ScriptError | 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 ditemukan | Menunjukkan bahawa direktori tidak ditemui |
Jalankan skrip .NET
Melaksanakan kod skrip .NET (C#/VB.NET) dan mengambil 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 | Mengesetkan 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 pemboleh ubah, bergantung pada konfigurasi yang dibuat oleh pengguna apabila menggunakan tetingkap Parameter Skrip .
Nota
Sekiranya tindakan dikonfigurasikan untuk menghasilkan parameter output (menggunakan arah Keluar apabila mengkonfigurasinya), anda harus sentiasa memastikan parameter di dalam skrip disetkan kepada nilai selain nol. Jika tidak, pelaksanaan skrip akan mengakibatkan ralat kerana parameter output belum ditetapkan.
Pengecualian
| Pengecualian | Description |
|---|---|
| Gagal menjalankan skrip .NET | Menunjukkan masalah semasa menjalankan skrip .NET yang disediakan |
Maklum balas
Akan datang: Sepanjang 2024, kami akan menghentikan secara berperingkat Isu GitHub sebagai kaedah maklum balas untuk kandungan dan menggantikannya dengan sistem maklum balas baharu. Untuk mendapatkan maklumat lanjut lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat maklum balas untuk