Поділитися через


Сценарні дії

Важливо

Щоб запобігти несанкціонованому доступу, Windows вимагає прав адміністратора для доступу до захищених ресурсів. Щоб отримати доступ до захищених ресурсів (наприклад, файлів) за допомогою дій зі сценарієм, запустіть їх Power Automate із правами адміністратора. Щоб знайти додаткові відомості про роботу Power Automate з правами адміністратора, перейдіть до розділу Запуск Power Automate із підвищеними правами.

Дії зі сценаріями дозволяють запускати блоки коду та впроваджувати кастомну поведінку в потоках робочого столу.

Важливо

Як було оголошено в жовтні 2023 року, VBScript вважається застарілим у Windows. У майбутніх випусках Windows VBScript буде доступний як функція на вимогу перед її видаленням з операційної системи. Щоб дізнатися більше, перегляньте статтю Ресурси для застарілих функцій.

Усі дії зі сценарієм відповідають базовій структурі відповідної мови програмування або скриптів: PowerShell, Python, VBScript, JavaScript та C#/VB.NET.

Нотатка

Підтримується версія для C#: v 5.0. Для VB.NET: v 11.0

Природна мова до сценарію на основі copilot (попередній перегляд)

[Ця тема є передрелізною документацією та може бути змінена.]

Природна мова для кодування - це нова можливість другого пілота, додана для Power Automate настільних комп'ютерів. Він дозволяє швидко генерувати код, який використовується в діях сценаріїв, описуючи його. Ця функція доступна в наступних діях зі сценарієм:

  • Запустіть PowerShell
  • Запустіть VBScript
  • Запустіть команду DOS
  • Запустіть Python
  • Запустіть JavaScript

Важливо

  • Це функція попереднього перегляду.
  • Підготовчі функції призначені для невиробничого використання і можуть бути обмежені. Ці функції доступні до офіційного випуску, щоб клієнти могли ознайомитися з ними заздалегідь і залишити відгуки.

Доступність по регіонах

Наразі copilot in Power Automate for desktop доступний лише в середовищах, розташованих у Сполучених Штатах.

Доступність за типом рахунку

Наразі copilot in Power Automate для настільних комп'ютерів доступний лише для користувачів із робочим або навчальним обліковим записом.

Нотатка

Якщо ваше середовище розташоване в одному з раніше перелічених регіонів, і вам все ще потрібно бачити другого пілота для Power Automate роботи з настільними комп'ютерами, зверніться до адміністратора клієнта. Можливо, вони вимкнули функцію другого пілота.

Як генерувати сценарії за допомогою copilot і природної мови

Щоб згенерувати сценарії в одній із підтримуваних дій сценарію, перетягніть дію в конструкторі та виберіть Генерувати сценарій за допомогою Copilot.

Скріншот дії запуску PowerShell з виділеною кнопкою Generate with Copilot

Відкриється вікно запиту на створення, де ви можете ввести запит на природну мову.

Знімок екрана дії генерації PowerShell з відкритим діалоговим вікном запиту

Щоб створити сценарій, напишіть запит і виберіть Створити. Якщо вам потрібно створити його повторно, ви можете змінити запит і вибрати Регенерувати. В іншому випадку виберіть Використовувати цей сценарій , щоб повернутися до головного вікна дії, де ви можете змінити його та додати всі необхідні змінні.

Скріншот дії PowerShell з використанням цього скрипту з відкритим діалоговим вікном підказки

Важливо

Переконайтеся, що ви завжди переглядаєте контент, створений моделлю штучного інтелекту.

Допоможіть нам покращити цю функцію

Надішліть відгук, вибравши значок великого пальця вгору або великого пальця вниз під контентом, створеним штучним інтелектом. Після цього з’явиться діалогове вікно зворотного зв’язку, за допомогою якого можна надіслати відгук до корпорації Майкрософт. Анімована gif-анімація, на якій видно, як другий пілот відповідає на запитання користувача від дизайнера.

Нотатка

Якщо діалогове вікно не відображається, можливо, адміністратор клієнта вимкнув його. Додаткові відомості: Вимкнення функції зворотного зв’язку з користувачем

Відключення функції зворотного зв’язку з користувачем

Як адміністратор клієнта, ви можете заборонити користувачам надсилати відгуки до корпорації Майкрософт, вимкнувши disableSurveyFeedback параметр клієнта. Дізнайтеся більше про перегляд і налаштування параметрів клієнта.

Запити прав суб’єкта даних на основі відгуків користувачів

Адміністратори клієнтів можуть переглядати, експортувати та видаляти відгуки своїх користувачів, увійшовши в Центр Microsoft 365 адміністрування та вибравшиВідгук про продукт для здоров'я>.

Штучний інтелект з Power Automate ресурсами

Робота зі змінними в скриптових діях

Щоб оголосити змінні в скриптових діях і повернути результати в, Power Automate використовуйте наступні команди:

  • Щоб оголосити нові змінні в скриптах PowerShell, використовуйте $ позначення. Щоб повернути значення з дій сценарію Run PowerShell to Power Automate, використовуйте команду Write-Output .

    $variableName = "variableValue"
    Write-Output $variableName
    
  • Скрипти Python не вимагають жодних спеціальних позначень для оголошення нових змінних. Щоб повернути значення з дій сценарію Run Python, використовуйте функцію друку .

    variableName = "variableValue"
    print variableName
    
  • VBScript не вимагає жодних спеціальних позначень для оголошення нових змінних. Використовуйте функцію WScript.Echo , щоб повертати значення з дій Run VBScript to Power Automate.

    variableName = "variableValue"
    WScript.Echo variableName
    
  • У скриптах JavaScript використовуйте нотацію var для оголошення нових змінних і функцію WScript.Echo для повернення значень із дій Run JavaScript .

    var variableName = "variableValue";
    WScript.Echo(variableName);
    
  • Для сценаріїв .NET використовуйте вікно Параметри скрипта, доступ до якого можна отримати через картку конфігурації дії сценарію Run .NET. Ви можете встановити тип відповідної змінної:

Скріншот вікна Параметри скрипта в дії скрипта Run .NET, встановлення типу змінної

Крім того, ви можете встановити, чи буде це вхідними даними для сценарію .NET (опція In у випадаючому меню Direction), виводу скрипту (опція Out у випадаючому меню Direction) або обох (опція In-Out у випадаючому меню Direction).

Скріншот вікна Параметри скрипта в дії Run .NET script, що задає напрямок

Щоб використовувати Power Automate змінні в скриптових діях, використовуйте позначення у відсотках (%) і обробляйте змінні так само, як жорстко закодовані значення.

Знімок екрана скрипта на Python, який містить позначення у відсотках.

Виконати команду DOS

Виконує команду DOS або консольний додаток у невидимому режимі та отримує її результат після завершення.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Команда DOS або програма No Файл Ім’я команди DOS або консольної програми з аргументами (якщо застосовується)
Робоча папка Так Папку Повний шлях до робочої папки (якщо застосовується)
Завершувати з помилкою, коли минає час очікування Так Логічне значення Укажіть, чи виконувати команду DOS або програму протягом невизначеного часу або завершувати з помилкою після визначеного періоду
Час очікування No Числове значення 10 Максимальна кількість секунд, протягом яких очікується виконання сценарію ("–1" означає невизначений час)
Змінити сторінку коду Немає Логічне значення Ні Указує, чи слід змінити поточну сторінку коду сеансу
Кодування No ASMO-708: арабська (ASMO 708), big5: китайська (традиційне письмо) (Big5), cp1025: IBM EBCDIC (кирилиця сербсько-болгарська), cp866: кирилиця (DOS), cp875: IBM EBCDIC (грецька сучасна), csISO2022JP: японська (JIS-Allow 1 байт Kana), DOS-720: арабська (DOS), DOS-862: іврит (DOS), EUC-CN: КИТАЙСЬКА СПРОЩЕНА (EUC), EUC-JP: японська (JIS 0208-1990 та 0212-1990), EUC-JP: японська (EUC), EUC-kr: корейська (EUC), GB18030: китайська спрощена (GB18030), GB2312: китайська спрощена (GB2312), hz-gb-2312: китайська спрощена (HZ), IBM-тайська: IBM EBCDIC (тайська), IBM00858: OEM багатомовна латиниця I, IBM00924: IBM Latin-1, IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (США-Канада-Євро), IBM01141: IBM EBCDIC (Німеччина-Euro), IBM01142: IBM EBCDIC (Данія-Норвегія-Євро), IBM01143: IBM EBCDIC (Фінляндія-Швеція-Євро), IBM01144: IBM EBCDIC (Італія Євро), IBM01145: IBM EBCDIC (Іспанія-Євро), IBM01146: IBM EBCDIC (Сполучене Королівство-ЄВРО), IBM01147: IBM EBCDIC (Франція-Євро), IBM01148: IBM EBCDIC (International-Euro), IBM01149: IBM EBCDIC (Ісландія-Євро), IBM037: IBM EBCDIC (США-Канада), IBM1026: IBM EBCDIC (турецька латиниця-5), IBM273: IBM EBCDIC (Німеччина), IBM277: IBM EBCDIC (Данія-Норвегія), IBM278: IBM EBCDIC (Фінляндія-Sweden), IBM280: IBM EBCDIC (Італія), IBM284: IBM EBCDIC (Іспанія), IBM285: IBM EBCDIC (Сполучене Королівство), IBM290: IBM EBCDIC (японська катакана), IBM297: IBM EBCDIC (Франція), IBM420: IBM EBCDIC (арабська), IBM423: IBM EBCDIC (грецька), IBM424: IBM EBCDIC (іврит), IBM437: OEM США, IBM500: IBM EBCDIC (міжнародна), ibm737: грецька (DOS), ibm775: балтійська (DOS), ibm850: західноєвропейська (DOS), ibm852: центральноєвропейська (DOS), IBM855: OEM кирилиця, ibm857: турецька (DOS), IBM860: португальська (DOS), ibm861: ісландська (DOS), IBM863: франко-канадська (DOS), IBM864: арабська (864), IBM865: скандинавська (DOS), ibm869: грецька, сучасна (DOS), IBM870: IBM EBCDIC (багатомовна латиниця-2), IBM871: IBM EBCDIC (ісландська), IBM880: IBM EBCDIC (кирилична російська), IBM905: IBM EBCDIC (турецька), iso-2022-jp: японська (JIS), iso-2022-jp: японська (JIS-Allow 1 байт Kana - SO/SI), iso-2022-kr: корейська (ISO), iso-8859 -1: Західноєвропейська (ISO), iso-8859-13: естонська (ISO), iso-8859-15: латинська 9 (ISO), iso-8859-2: центральноєвропейська (ISO), iso-8859-3: латинська 3 (ISO), iso-8859-4: балтійська (ISO), iso-8859-5: кирилиця (ISO), iso-8859-6: арабська (ISO), iso-8859-7: Грецька (ISO), iso-8859-8: іврит (ISO-Visual), iso-8859-8-i: іврит (ISO-логічний), iso-8859-9: турецька (ISO), Johab: корейська (Johab), koi8-r: кирилиця (KOI8-R), koi8-u: кирилиця (KOI8-U), ks_c_5601-1987: корейська, macintosh: західноєвропейська (Mac), shift_jis : японська (Shift-JIS), us-ascii: US-ASCII, utf-16: Юнікод, utf-16BE: Юнікод (Big-Endian), utf-32: Юнікод (UTF-32), utf-32BE: Юнікод (UTF-32 Big-Endian), utf-7: Юнікод (UTF-7), utf-8: Юнікод (UTF-8), Windows-1250: Центральноєвропейський (Windows), windows-1251: кирилиця (Windows), Windows-1252: західноєвропейська (Windows), windows-1253: грецька (Windows), windows-1254: турецька (Windows), windows-1255: іврит (Windows), windows-1256: арабська (Windows), windows-1257: балтійська (Windows), windows-1258: в’єтнамська (Windows), windows-874: тайська (Windows), x-китайська-CNS: китайська (традиційне письмо) (CNS), x-китайська-eten: китайська (традиційне письмо) (Eten), x-cp20001: TCA Тайвань, x-cp20003: IBM5550 Тайвань, x-cp20004: телетекст Тайвань, x-cp20005: Ван Тайвань, x-cp20261: T.; 61, x-cp20269: ISO-6937, x-cp20936: китайська спрощена (GB2312-80), x-cp20949: корейська Wansung, x-cp50227: китайська спрощена (ISO-2022), x-EBCDIC-корейськаРозширено: IBM EBCDIC (корейська розширена), x-Europa: Europa, x-IA5: західноєвропейська (IA5), x-КОРЕЙСЬКА ia5-німецька: німецька (IA5), x-IA5-норвезька: норвезька (IA5), x-IA5-шведська: шведська (IA5), x-iscii-as: ISCII ассамська, x-iscii-be: ISCII бенгальська, x-iscii-de: ISCII деванагарі, x-iscii-gu: ISCII гуджараті, x-iscii-ka: ISCII каннада, x-iscii-ma: ISCII малаялам, x-iscii-або: ISCII Орія, x-iscii-pa: ISCII пенджабі, x-iscii-ta: ISCII тамільська, x-iscii-te: ISCII телугу, x-mac-арабська: арабська (Mac), x-mac-ce: центральноєвропейська (Mac), x-mac-китайська: китайська спрощена (Mac), x-mac-chinesetrad: китайська традиційна (Mac), x-mac-хорватська: хорватська (Mac), x-mac-кирилиця: кирилиця (Mac), x-mac-грецька: грецька (Mac), x-mac-іврит: іврит (Mac), x-mac-ісландська: ісландська (Mac), x-mac-японська: японська (Mac), x-mac-корейська: корейська (Mac), x-mac-румунська: румунська (Mac), x-mac-тайська: тайська (Mac), x-mac-турецька: турецька (Mac), x-mac-українська: українська (Mac)’ utf-8: Unicode (UTF-8) Кодування, що використовується під час читання вихідних даних

Змінні, які створюються

Аргумент Ввести Опис
Командний вивід Текстове значення Текстові вихідні дані з команди DOS або програми
CommandErrorOutput Текстове значення Текст, який описує помилки (якщо є), що виникли під час виконання команди DOS або програми
CommandExitCode Числове значення Команда або код виходу програми. Ця величина є числовою

Винятки

Виняток Опис
Не вдалося виконати команду або консольну програму Указує на проблему під час виконання зазначеної команди або консольної програми
Не вдалося виконати сценарій у визначений час Указує на проблему з виконанням наданого сценарію у визначений час

Виконати VBScript

Виконує частину настроюваного коду VBScript і зберігає вихідні дані в змінну.

Ви можете використовувати цю дію, щоб включити свій власний користувацький код VBScript у потік робочого столу, а також мати можливість використовувати змінні в ньому, щоб генерувати динамічний вміст VBScript, якщо це необхідно.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
VBScript для виконання Так Текстове значення Код VBScript для виконання. Змінні можуть бути включені в скрипт, оскільки вони обчислюються перед виконанням VBScript
Завершувати з помилкою, коли минає час очікування Так Логічне значення Немає Укажіть, чи виконувати сценарій VBScript протягом невизначеного часу або завершувати з помилкою після визначеного періоду
Час очікування No Числове значення 10 Максимальна кількість секунд, протягом яких очікується виконання сценарію ("–1" означає невизначений час)

Змінні, які створюються

Аргумент Ввести Опис
VBScriptOutput Текстове значення Вихідні дані сценарію
Помилка сценарію Текстове значення Помилки, які можуть виникнути під час виконання коду VBScript

Винятки

Виняток Опис
Не вдалося виконати сценарій у визначений час Указує на проблему з виконанням наданого сценарію у визначений час

Виконати JavaScript

Виконує частину настроюваного коду JavaScript і зберігає вихідні дані в змінну.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
JavaScript для виконання Так Текстове значення Код JavaScript для виконання. Змінні можуть бути включені в скрипт, оскільки вони обчислюються перед виконанням JavaScript-коду
Завершувати з помилкою, коли минає час очікування Так Логічне значення Укажіть, чи виконувати сценарій JavaScript протягом невизначеного часу або завершувати з помилкою після визначеного періоду часу
Час очікування No Числове значення 10 Максимальна кількість секунд, протягом яких очікується виконання сценарію ("–1" означає невизначений час)

Змінні, які створюються

Аргумент Ввести Опис
Вивід Javascript Текстове значення Вихідні дані сценарію
Помилка сценарію Текстове значення Помилки, які можуть виникнути під час виконання JavaScript-коду

Винятки

Виняток Опис
Не вдалося виконати сценарій у визначений час Указує на проблему з виконанням наданого сценарію у визначений час

Виконати сценарій PowerShell

Виконує частину настроюваного сценарію PowerShell і зберігає вихідні дані в змінну.

Ви можете використовувати цю дію, щоб включити власний власний код PowerShell у потік робочого столу, а також мати можливість використовувати змінні в ньому для створення динамічного вмісту PowerShell, якщо це необхідно.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Код PowerShell для виконання Так Текстове значення Код PowerShell для виконання. Змінні можуть бути включені в скрипт, оскільки вони обчислюються перед виконанням коду PowerShell
Завершувати з помилкою, коли минає час очікування Так Логічне значення Вкажіть, чи буде сценарій PowerShell працювати нескінченно або завершувати роботу через встановлений проміжок часу
Час очікування No Числове значення 10 Максимальна кількість секунд, протягом яких очікується виконання сценарію ("–1" означає невизначений час)

Змінні, які створюються

Аргумент Ввести Опис
Вихід Powershell Текстове значення Вихідні дані сценарію
Помилка сценарію Текстове значення Помилки, які можуть виникнути під час виконання коду PowerShell

Винятки

Виняток Опис
Не вдалося виконати сценарій PowerShell Указує на проблему під час виконання зазначеного сценарію PowerShell
Не вдалося виконати сценарій у визначений час Указує на проблему з виконанням наданого сценарію у визначений час

Виконати сценарій Python

Виконує код сценарію Python і отримує його вихідні дані.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Сценарій Python для виконання No Текстове значення Код скрипту Python для виконання
Версія Python No Python 2.7, Python 3.4 Python 2.7 Укажіть, яку версію Python слід використовувати під час виконання сценарію
Шляхи до папок модуля Так Списокпапок Шляхи до папок, де лежать зовнішні модулі Python

Змінні, які створюються

Аргумент Ввести Опис
Вихід PythonScript Текстове значення Вихідні дані сценарію
Помилка сценарію Текстове значення Помилки, які можуть виникнути під час виконання коду скрипта Python

Винятки

Виняток Опис
Не вдалося виконати сценарій Python Указує на проблему під час виконання зазначеного сценарію Python
Каталог не знайдено Указує, що каталог не знайдено

Виконати сценарій .NET

Виконує код скрипта .NET (C#/VB.NET) і отримує його вихідні дані.

Вхідні параметри

Аргумент Необов'язково Приймає Значення за замовчуванням Опис
Мова Немає C#/ VB.NET C# Мова сценарію
Операції імпорту сценарію .NET Так Текстове значення Операції імпорту сценарію .NET, які потрібно включити до сценарію
Пов’язані матеріали, які потрібно завантажити Так Папку Кореневий шлях, у якому розташовано посилання на бібліотеки динамічного компонування .NET (файли .dll)
Параметри скрипта Так Параметри скрипту, визначені користувачем Установка значень параметрів, які визначені в скрипті
Код .NET для виконання No Текстове значення Код .NET для виконання

Змінні, які створюються

Ця дія може створювати змінні, залежно від налаштувань, зроблених користувачем під час використання вікна «Параметри скрипту».

Нотатка

У випадку, якщо дію налаштовано на створення вихідних параметрів (використовуючи напрямок Out під час їх налаштування), ви завжди повинні переконатися, що параметр у скрипті встановлено на значення, відмінне від null. В іншому випадку виконання скрипту призводить до помилки, оскільки вихідний параметр не був встановлений.

Винятки

Виняток Опис
Не вдалося запустити скрипт .NET Указує на проблему під час виконання зазначеного сценарію .NET