Akce skriptování

Důležité

Aby se zabránilo neoprávněnému přístupu, vyžaduje systém Windows práva správce pro přístup k chráněným zdrojům. Chcete-li získat přístup k chráněným zdrojům (jako jsou soubory) pomocí akcí skriptování, spusťte Power Automate s právy správce. Více informací o spuštění Power Automate jako správce naleznete v části Spuštění Power Automate se zvýšenými právy.

Akce skriptování umožňují uživatelům spouštět bloky kódu a implementovat vlastní chování v desktopových tocích.

Důležité

Jak bylo oznámeno v říjnu 2023, VBScript je ve Windows ukončen. V budoucích verzích Windows bude VBScript k dispozici jako funkce na vyžádání před jeho odstraněním z operačního systému. Další informace naleznete v části Zdroje pro zastaralé funkce.

Všechny skriptovací akce se řídí základní strukturou příslušného programovacího nebo skriptovacího jazyka: PowerShell, Python, VBScript, JavaScript a C#/VB.NET.

Poznámka:

Podporovaná verze pro C#: verze 5.0. Pro VB.NET: verze 11.0

Převod přirozeného jazyka na skript pomocí kopilota (Preview)

[Toto téma představuje předběžnou dokumentaci, která může být změněna.]

Přirozený jazyk na kód je nová funkce kopilota přidaná v Power Automate pro desktopy. Umožňuje rychle generovat kód používaný při akcích skriptování jeho popisem. Tato funkce je k dispozici v následujících akcích skriptování:

• Spustit PowerShell
• Spustit VBScript
• Spustit příkaz DOS
• Spustit Python
• Spustit JavaScript

Důležité

• Toto je funkce Preview.
• Funkce Preview nejsou určené pro normální používání a mohou mít omezené fungování. Jsou to funkce, které jsou poskytnuté před svým oficiálním vydáním, aby si je zákazníci mohli co nejdříve vyzkoušet a mohli nám napsat své názory.

Dostupnost podle oblasti

Kopilot je aktuálně dostupný pouze v prostředích Power Automate pro desktop umístěných ve Spojených státech.

Dostupnost podle typu účtu

V současné době je kopilot v Power Automate pro desktop dostupný pouze pro uživatele s pracovním nebo školním účtem.

Poznámka:

Pokud se vaše prostředí nachází ve výše uvedené oblasti a stále potřebujete vidět prostředí kopilota v Power Automate pro desktop, kontaktujte svého správce tenanta. Možná vypnul funkci kopilota.

Jak generovat skripty pomocí kopilota a přirozeného jazyka

Chcete-li generovat skripty v jedné z podporovaných akcí skriptování, přetáhněte akci v návrháři a vyberte Generovat skript pomocí Copilot.

Otevře se obrazovka s dotazem k vytvoření, kde můžete zadat dotaz v přirozeném jazyce.

Chcete-li vytvořit skript, napište dotaz a vyberte Generovat. Pokud ho potřebujete znovu vytvořit, můžete změnit dotaz a vybrat Znovu vygenerovat. V opačném případě vyberte Použít tento skript pro návrat do hlavního okna akce, kde ho můžete upravit a přidat potřebné proměnné.

Důležité

Ujistěte se, že vždy kontrolujete obsah generovaný modelem AI.

Pomozte nám tuto funkci vylepšit

Odešlete zpětnou vazbu výběrem ikony palce nahoru nebo dolů pod obsahem generovaným umělou inteligencí. Jakmile tak učiníte, zobrazí se dialogové okno zpětné vazby, které můžete použít k odeslání zpětné vazby společnosti Microsoft.

Poznámka:

Pokud dialogové okno nevidíte, váš správce tenanta ho možná vypnul. Další informace: Deaktivace funkce zpětné vazby od uživatelů

Deaktivace funkce zpětné vazby od uživatelů

Jako správce tenanta můžete zabránit svým uživatelům v odesílání zpětné vazby společnosti Microsoft tím, že vypnete nastavení tenanta disableSurveyFeedback. Další informace o zobrazení a nastavení tenanta:

• Výpis nastavení klienta (Preview)
• Nastavení TenantSettings

Žádosti o práva subjektu údajů na zpětnou vazbu od uživatelů

Správci tenanta mohou zobrazit, exportovat a smazat zpětnou vazbu od svých uživatelů po přihlášení do centra pro správu Microsoft 365 a poté vyberou Stav>Zpětná vazba k produktu.

AI s prostředky Power Automate

• Nejčastější dotazy ke generování skriptů pomocí přirozeného jazyka
• Časté otázky týkající se odpovědné AI pro Power Automate
• Časté otázky k zabezpečení dat a ochraně osobních údajů ve funkci Copilot v Microsoft Power Platform

Práce s proměnnými ve skriptovacích akcích

Chcete-li deklarovat proměnné v akcích skriptování a vrátit výsledky v Power Automate, použijte následující příkazy:

• K deklaraci nových proměnných ve skriptech PowerShellu použijte notaci $. Chcete-li vrátit hodnoty z akcí Spustit skript PowerShell do Power Automate, použijte příkaz Write-Output.

  $variableName = "variableValue"
  Write-Output $variableName
  

• Skripty Pythonu nevyžadují pro deklaraci nových proměnných žádnou speciální notaci. Chcete-li vrátit hodnoty z akcí Spustit skript Pythonu, použijte funkci print.

  variableName = "variableValue"
  print variableName
  

• VBScript nevyžaduje pro deklaraci nových proměnných žádnou speciální notaci. Použijte funkci WScript.Echo, chcete-li vrátit hodnoty z akcí Spustit VBScript do Power Automate.

  variableName = "variableValue"
  WScript.Echo variableName
  

• Ve skriptech JavaScript použijte zápis var pro deklaraci nové proměnné a funkci WScript.Echo pro vrácení hodnot z akcí Spustit JavaScript.

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

• Pro skripty .NET použijte okno Parametry skriptu, ke kterému se dostanete přes konfigurační kartu akce Spustit skript .NET. Můžete nastavit typ příslušné proměnné:

Kromě toho můžete nastavit, zda se jedná o vstup skriptu .NET (možnost Vstup v rozevíracím seznamu Směr), výstup skriptu (možnost Výstup v rozbalovací nabídce Směr) nebo obojí (možnost Vstup-výstup v rozevírací nabídce Směr).

Chcete-li použít proměnné Power Automate ve skriptovacích akcích, použijte zápis v procentech (%) a zacházejte s proměnnými stejně jako s pevně zakódovanými hodnotami.

Spustit příkaz DOS

Spustí příkaz nebo konzolovou aplikaci DOS v neviditelném režimu a po dokončení načte jeho výstup.

Vstupní parametry

Argument	Volitelné	Přijímá	Výchozí hodnota	Popis
DOS command or application	Ne	Soubor		Název příkazu nebo konzolové aplikace DOS s argumenty, jsou-li k dispozici
Working folder	Ano	Složka		Úplná cesta ke složce, z níž se má pracovat, je-li k dispozici
Selhání po vypršení časového limitu	Ano	Logická hodnota		Určete, zda budou příkaz DOS nebo aplikace spuštěny po neomezenou dobu nebo selžou po uplynutí nastavené doby
Timeout	Ne	Číselná hodnota	10	Maximální počet sekund čekání na dokončení skriptu (-1 po dobu neurčitou)
Změna znakové stránky	–	Logická hodnota	False	Určuje, zda má být změněna aktuální znaková stránka relace
Encoding	Ne	ASMO-708: arabština (ASMO 708), big5: tradiční čínština (Big5), cp1025: IBM EBCDIC (azbuka srbsko-bulharská), cp866: azbuka (DOS), cp875: IBM EBCDIC (moderní řečtina), csISO2022JP: japonština (JIS-Allow 1 byte Kana), DOS-720: arabština (DOS), DOS-862: hebrejština (DOS), EUC-CN: zjednodušená čínština (EUC), EUC-JP: japonština (JIS 0208-1990 a 0212-1990), euc -jp: japonština (EUC), euc-kr: korejština (EUC), GB18030: zjednodušená čínština (GB18030), gb2312: zjednodušená čínština (GB2312), hz-gb-2312: zjednodušená čínština (HZ), IBM-thajština: IBM EBCDIC (Thai), IBM00858: OEM Multilingual Latin I, IBM00924: IBM Latin-1, IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (US-Canada-Euro), IBM01141: IBM EBCDIC (Germany-Euro), IBM01142: IBM EBCDIC (Dánsko-Norsko-Euro), IBM01143: IBM EBCDIC (Finsko-Švédsko-Euro), IBM01144: IBM EBCDIC (Itálie-Euro), IBM01145: IBM EBCDIC (Španělsko-Euro), IBM01146: IBM EBCDIC (UK-Euro), IBM01147: IBM EBCDIC (Francie-Euro), IBM01148: IBM EBCDIC (International-Euro), IBM01149: IBM EBCDIC (Islandština -Euro), IBM037: IBM EBCDIC (USA-Kanada), IBM1026: IBM EBCDIC (turecká latinka-5), IBM273: IBM EBCDIC (Německo), IBM277: IBM EBCDIC (Dánsko-Norsko), IBM278: IBM EBCDIC (Finsko- Švédsko), IBM280: IBM EBCDIC (Itálie), IBM284: IBM EBCDIC (Španělsko), IBM285: IBM EBCDIC (Spojené království), IBM290: IBM EBCDIC (japonská katakana), IBM297: IBM EBCDIC (Francie), IBM420: IBM EBCDIC (arabština), IBM423: IBM EBCDIC (řecký), IBM424: IBM EBCDIC (hebrejský), IBM437: OEM USA, IBM500: IBM EBCDIC (mezinárodní), ibm737: řecký (DOS), ibm775: baltský (DOS), ibm850: západoevropský (DOS), ibm852: Central European (DOS), IBM855: OEM Cyrillic, ibm857: Turkish (DOS), IBM860: Portuguese (DOS), ibm861: Icelandic (DOS), IBM863: French Canadian (DOS), IBM864: Arabic ( 864), IBM865: Nordic (DOS), ibm869: Greek, Modern (DOS), IBM870: IBM EBCDIC (Multilingual Latin-2), IBM871: IBM EBCDIC (Icelandic), IBM880: IBM EBCDIC (Cyrillic Russian), IBM905: IBM EBCDIC (turečtina), iso-2022-jp: japonština (JIS), iso-2022-jp: japonština (JIS-povolit 1 byt e Kana - SO / SI), iso-2022-kr: korejština (ISO), iso-8859-1: západní Evropa (ISO), iso-8859-13: estonština (ISO), iso-8859-15: latinka 9 (ISO), iso-8859-2: Central European (ISO), iso-8859-3: Latin 3 (ISO), iso-8859-4: Baltic (ISO), iso-8859-5: Cyrillic (ISO), iso-8859-6: arabština (ISO), iso-8859-7: řečtina (ISO), iso-8859-8: hebrejština (ISO-Visual), iso-8859-8-i: hebrejština (ISO-logická), iso-8859-9: turečtina (ISO), Johab: korejština (Johab), koi8-r: azbuka (KOI8-R), koi8-u: azbuka (KOI8-U), ks_c_5601-1987: korejština, macintosh: západní Evropa (Mac), shift_jis: japonština (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: Central European (Windows), windows-1251: Cyrillic (Windows), Windows-1252: Western European (Windows), windows-1253: Greek (Windows), windows-1254: Turkish (Windows), windows-1255: Hebrew (Windows), windows-1256: Arabic (Windows), Windows-1257: Baltic (Windows), Windows-1258: vietnamština (Windows), Windows-874: thajština (Windows), x-Chinese-CNS: tradiční čínština (CNS), x-Chinese-Eten: tradiční čínština (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: zjednodušená čínština (GB2312-80), x-cp20949: Korean Wansung, x-cp50227: zjednodušená čínština (ISO-2022), x-EBCDIC-KoreanExtended: IBM EBCDIC (Korean Extended), x-Europa: Europa, x-IA5: Západoevropská (IA5), x-IA5-Německá: Německá (IA5), x-IA5-Norská: Norská (IA5), x-IA5-Švédská: Švédská (IA5), x-iscii-as: ISCII Assamese, x- iscii-be: ISCII bengálština, x-iscii-de: ISCII Devanagari, x-iscii-gu: ISCII Gujarati, x-iscii-ka: ISCII Kannada, x-iscii-ma: ISCII Malayalam, x-iscii-nebo: 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: Central European (Mac ), x-mac-chinesesimp: zjednodušená čínština (Mac), x-mac-chinesetrad: tradiční čínština (Mac), x-mac-chorvatština: chorvatština (Mac), x-mac-cyrilice: azbuka (Mac), x-mac-řečtina: řečtina (Mac), x-mac-hebrejština: hebrejština (Mac), x-mac-islandština: islandština (Mac), x-mac-japonština: japonština (Mac), x-mac-korejština: korejština (Mac), x-mac-rumunština: Rumunština (Mac), x-mac-thai: Thajština (Mac), x-mac-turečtina: Turečtina (Mac), x-mac-ukrajinština: Ukrajinština (Mac) `	utf-8 : Unicode (UTF-8)	Kódování, které se má použít při čtení výstupu

Vytvořené proměnné

Argument	Typ	Popis
CommandOutput	Textová hodnota	Textový výstup z příkazu nebo aplikace DOS
CommandErrorOutput	Textová hodnota	Text popisující chyby, ke kterým došlo (pokud existují) během provádění příkazu nebo aplikace DOS
CommandExitCode	Číselná hodnota	Ukončovací kód příkazu nebo aplikace. Tato hodnota je číselná

Výjimky

Výjimka	Popis
Nelze spustit příkaz nebo konzolovou aplikaci	Označuje problém při provádění zadaného příkazu nebo konzolové aplikace
Spuštění skriptu v přiděleném čase se nezdařilo	Označuje problém se spuštěním poskytnutého skriptu v přiděleném čase

Spustit VBScript

Spustí vlastní kód VBScript a načte jeho výstup do proměnné.

Tuto akci můžete použít k zahrnutí vlastního kódu VBScript do desktopového toku a zároveň mít možnost v něm používat proměnné ke generování dynamického obsahu VBScript v případě potřeby.

Vstupní parametry

Argument	Volitelné	Přijímá	Výchozí hodnota	Popis
VBScript to run	Ano	Textová hodnota		Kód VBScript, který se má spustit. Proměnné mohou být součástí skriptu, protože jsou vyhodnoceny před provedením VBScript
Selhání po vypršení časového limitu	Ano	Logická hodnota	–	Určit, jestli se skript VBScript spustí po neomezenou dobu nebo selže po nastavené době
Timeout	Ne	Číselná hodnota	10	Maximální počet sekund čekání na dokončení skriptu (-1 po dobu neurčitou)

Vytvořené proměnné

Argument	Typ	Popis
VBScriptOutput	Textová hodnota	Výstup skriptu
ScriptError	Textová hodnota	Chyby, které se mohou vyskytnout během provádění kódu VBScript

Výjimky

Výjimka	Popis
Spuštění skriptu v přiděleném čase se nezdařilo	Označuje problém se spuštěním poskytnutého skriptu v přiděleném čase

Spustit JavaScript

Spustí vlastní kód JavaScriptu a načte jeho výstup do proměnné.

Vstupní parametry

Argument	Volitelné	Přijímá	Výchozí hodnota	Popis
JavaScript to run	Ano	Textová hodnota		Kód JavaScript, který se má spustit. Proměnné mohou být součástí skriptu, protože jsou vyhodnoceny před provedením kódu JavaScript
Selhání po vypršení časového limitu	Ano	Logická hodnota		Určete, zda bude skript Javascript spuštěn po neomezenou dobu nebo selže po uplynutí nastavené doby
Timeout	Ne	Číselná hodnota	10	Maximální počet sekund čekání na dokončení skriptu (-1 po dobu neurčitou)

Vytvořené proměnné

Argument	Typ	Popis
JavascriptOutput	Textová hodnota	Výstup skriptu
ScriptError	Textová hodnota	Chyby, které se mohou vyskytnout během provádění kódu JavaScript

Výjimky

Výjimka	Popis
Spuštění skriptu v přiděleném čase se nezdařilo	Označuje problém se spuštěním poskytnutého skriptu v přiděleném čase

Spustit skript PowerShell

Spustí vlastní skript PowerShell a načte jeho výstup do proměnné.

Tuto akci můžete použít k zahrnutí vlastního kódu PowerShell do desktopového toku a zároveň mít možnost v něm používat proměnné ke generování dynamického obsahu PowerShell v případě potřeby.

Vstupní parametry

Argument	Volitelné	Přijímá	Výchozí hodnota	Popis
PowerShell code to run	Ano	Textová hodnota		Kód PowerShell, který se má spustit. Proměnné mohou být součástí skriptu, protože jsou vyhodnoceny před provedením kódu PowerShell
Selhání po vypršení časového limitu	Ano	Logická hodnota		Určit, jestli se skript PowerShell spustí po neomezenou dobu nebo selže po nastavené době
Timeout	Ne	Číselná hodnota	10	Maximální počet sekund čekání na dokončení skriptu (-1 po dobu neurčitou)

Vytvořené proměnné

Argument	Typ	Popis
PowershellOutput	Textová hodnota	Výstup skriptu
ScriptError	Textová hodnota	Chyby, které se mohou vyskytnout během provádění kódu PowerShell

Výjimky

Výjimka	Popis
Spuštění skriptu PowerShell se nezdařilo	Označuje problém se spuštěním zadaného skriptu PowerShell
Spuštění skriptu v přiděleném čase se nezdařilo	Označuje problém se spuštěním poskytnutého skriptu v přiděleném čase

Spustit skript Python

Spustí kód skriptu Python a načte jeho výstup.

Vstupní parametry

Argument	Volitelné	Přijímá	Výchozí hodnota	Popis
Python script to run	No	Textová hodnota		Kód skriptu Python, který se má spustit
Verze Pythonu	No	Python 2.7, Python 3.4	Python 2.7	Určete, která verze Pythonu se má použít při spouštění skriptu.
Module folder paths	Ano	Seznamsložek		Cesty složek, kde se nachází externí moduly Python

Vytvořené proměnné

Argument	Typ	Popis
PythonScriptOutput	Textová hodnota	Výstup skriptu
ScriptError	Textová hodnota	Chyby, které se mohou vyskytnout během provádění kódu skriptu Python

Výjimky

Výjimka	Popis
Spuštění skriptu Python se nezdařilo	Označuje problém se spuštěním zadaného skriptu Python
Adresář nenalezen	Označuje, že adresář nebyl nalezen

Spuštění skriptu .NET

Spustí kód skriptu .NET (C#/VB.NET) a načte jeho výstup.

Vstupní parametry

Argument	Volitelné	Přijímá	Výchozí hodnota	Popis
Jazyk	–	C#/ VB.NET	C#	Jazyk skriptu
Importy skriptů .NET	Ano	Textová hodnota		Skript .NET importuje, aby byl zahrnut do skriptu
Odkazy, které mají být načteny	Ano	Složka		Kořenová cesta, kde jsou umístěny odkazy dynamických knihoven .NET (soubory .dll)
Parametry skriptu	Ano	Parametry skriptu definované uživatelem		Nastavení hodnot parametrů, které jsou definovány ve skriptu
Kód .NET ke spuštění	Ne	Textová hodnota		Kód .NET, který se má spustit

Vytvořené proměnné

Tato akce může způsobit proměnné v závislosti na konfiguraci provedené uživatelem při použití okna Parametry skriptu.

Poznámka:

V případě, že je akce nakonfigurována tak, aby vytvářela výstupní parametry (pomocí směru Výstup při jejich konfiguraci), měli byste vždy zajistit, aby byl parametr uvnitř skriptu nastaven na hodnotu jinou než null. V opačném případě bude mít spuštění skriptu za následek chybu, protože výstupní parametr nebyl nastaven.

Výjimky

Výjimka	Popis
Spuštění skriptu .NET se nezdařilo	Označuje problém se spuštěním zadaného skriptu .NET