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

Сценарні дії

  • Стаття

Важливо

Щоб запобігти несанкціонованому доступу, 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 for desktop доступний лише для користувачів із робочим або навчальним обліковим записом.

Нотатка

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

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

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

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

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

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

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

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

Важливо

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

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

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

Нотатка

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

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

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

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

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

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

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

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

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

    $variableName = "variableValue"
Write-Output $variableName

  • Скрипти Python не потребують спеціальної нотації для оголошення нових змінних. Щоб повернути значення з дій сценарію Run Python, використовуйте функцію print .

    variableName = "variableValue"
print variableName

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

    variableName = "variableValue"
WScript.Echo variableName

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

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

  • Для сценаріїв .NET використовуйте вікно Параметри сценарію, доступ до якого можна отримати за допомогою картки конфігурації дії Запустити сценарій .NET. Ви можете встановити тип відповідної змінної:

Скріншот вікна Параметри сценарію в дії Виконати сценарій .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) Кодування, що використовується під час читання вихідних даних

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

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

Винятки

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

Виконати VBScript

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

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

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

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

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

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

Винятки

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

Виконати JavaScript

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

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

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

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

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

Винятки

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

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

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

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

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

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

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

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

Винятки

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

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

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

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

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

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

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

Винятки

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

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

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

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

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

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

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

Нотатка

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

Винятки

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