Akcje skryptu

Ważne

Aby zapobiec nieautoryzowanemu dostępowi, system Windows wymaga uprawnień administratora do dostępu do chronionych zasobów. Aby uzyskać dostęp do chronionych zasobów (takich jak pliki) za pomocą akcji skryptowych, uruchom Power Automate z prawami administratora. Więcej informacji na temat uruchamiania Power Automate jako administrator znajdziesz w Uruchom Power Automate z podwyższonymi uprawnieniami.

Te akcje tworzenia skryptów umożliwiają uruchamianie bloków kodu i implementowanie niestandardowych zachowań w przepływach pulpitu.

Ważne

Zgodnie z ogłoszeniem z października 2023 r. kod VBScript zostanie uznany za przestarzały w systemie Windows. W przyszłych wersjach systemu Windows skrypt VBScript będzie dostępny jako funkcja na żądanie przed usunięciem z systemu operacyjnego. Aby uzyskać więcej informacji, zobacz Zasoby dla usuniętych i przestarzałych funkcji.

Wszystkie akcje obsługi skryptów postępują zgodnie z podstawową strukturą odpowiedniego języka programowania lub obsługi skryptów: PowerShell, Python, VBScript, JavaScript i C#/VB.NET.

Uwaga

Obsługiwana wersja dla C#: wersja 5.0. Dla VB.NET: wersja 11.0

Język naturalny do skryptu obsługiwanego przez pomocnika (wersja zapoznawcza)

[Ten temat stanowi wstępną wersję dokumentacji i może ulec zmianie].

Język naturalny do kodu to nowa funkcja copilota dodana w Power Automate for Desktop. Pozwala szybko wygenerować kod używany w akcjach skryptowych poprzez opisanie go. Ta funkcja jest dostępna w następujących akcjach skryptowych:

• Uruchom PowerShell
• Uruchom VBScript
• Uruchom komendę DOS
• Uruchom skrypt w języku Python
• Uruchom kod w języku JavaScript

Ważne

• Jest to funkcja w wersji zapoznawczej.
• Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

Dostępność według regionów

Obecnie Copilot w Power Automate for Desktop stacjonarnych jest dostępny tylko w środowiskach zlokalizowanych w Stanach Zjednoczonych.

Dostępność według typu konta

Obecnie Copilot w Power Automate for Desktop jest dostępny tylko dla użytkowników z kontem służbowym.

Uwaga

Jeśli twoje środowisko znajduje się w regionie wymienionym powyżej i nadal potrzebujesz zobaczyć Copilot w Power Automate for Desktop, skontaktuj się z administratorem dzierżawy. Mogli wyłączyć funkcję Copilot.

Jak generować skrypty przy użyciu pomocnika i języka naturalnego

Aby wygenerować skrypty w jednej z obsługiwanych akcji skryptowych, przeciągnij i upuść akcję w kreatorze i wybierz Generowanie skryptu za pomocą rozwiązania Copilot.

Zostanie otwarty ekran tworzenia monitu, na którym można wpisać prompt w języku naturalnym.

Aby utworzyć skrypt, napisz prompt i wybierz Generuj. Jeśli zajdzie potrzeba jego ponownego utworzenia, można zmienić prompt i wybrać Generuj ponownie. W przeciwnym razie wybierz Użyj tego skryptu, aby powrócić do głównego okna akcji, gdzie możesz go zmodyfikować i dodać wszelkie niezbędne zmienne.

Ważne

Upewnij się, że zawsze sprawdzasz treść wygenerowaną przez model AI.

Pomóż nam ulepszać tę funkcję

Wyślij opinię, wybierając ikonę kciuka w górę lub kciuka w dół pod treścią wygenerowaną przez sztuczną inteligencję. Gdy to zrobisz, pojawi się okno dialogowe opinii, którego możesz użyć do przesłania opinii do Microsoft.

Uwaga

Jeśli nie widzisz okna dialogowego, administrator dzierżawy mógł je wyłączyć. Więcej informacji: Wyłączenie funkcji opinii użytkownika

Wyłączenie funkcji opinii użytkownika

Jako administrator dzierżawy możesz uniemożliwić użytkownikom wysyłanie opinii do Microsoft, wyłączając ustawienie dzierżawy disableSurveyFeedback. Więcej informacji na temat wyświetlania i ustawiania ustawień dzierżawcy można znaleźć tutaj:

• Tworzenie listy ustawień dzierżawy (wersja zapoznawcza)
• Ustaw TenantSettings

Wnioski o prawa osób, których dane dotyczą, dotyczące opinii użytkowników

Administratorzy dzierżawcy mogą wyświetlać, eksportować i usuwać opinie swoich użytkowników, logując się w centrum administracyjnym Microsoft 365, a następnie wybierając Kondycja>Opinia na temat produktu.

AI z zasobami Power Automate

• Często zadawane pytania dotyczące generowania skryptów w języku naturalnym
• Często zadawane pytania dotyczące odpowiedzialnego AI dla Power Automate
• Często zadawane pytania dotyczące bezpieczeństwa i prywatności danych wykorzystywanych w związku z narzędziem Copilot w Microsoft Power Platform

Praca ze zmiennymi w akcjach skryptowych

Aby zadeklarować zmienne w akcjach obsługi skryptów i zwrócić wyniki w Power Automate, należy stosować następujące polecenia:

• Aby zadeklarować nowe zmienne w skryptach programu PowerShell, należy użyć $ notacji. Aby zwrócić wartości z akcji skryptu Uruchom program PowerShell do Power Automate, użyj polecenia Write-Output.

  $variableName = "variableValue"
  Write-Output $variableName
  

• Skrypty nie wymagają specjalnych notacji w celu zadeklarowania nowych zmiennych. Aby zwrócić wartości z akcji skryptu Run Script, należy użyć funkcji drukowania.

  variableName = "variableValue"
  print variableName
  

• VBScript nie wymaga żadnej specjalnej notacji do deklarowania nowych zmiennych. Użycie funkcji WScript.Echo do zwracania wartości z akcji Uruchom VBScript do Power Automate.

  variableName = "variableValue"
  WScript.Echo variableName
  

• W skryptach Języka JavaScript należy użyć funkcji var w celu zadeklarowania nowych zmiennych i funkcji WScript.Echoaby zwrócić wartości z akcji Uruchom skrypt JavaScript.

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

• W przypadku skryptów .NET należy użyć okna Parametry skryptu, do którego dostęp uzyskuje się za pośrednictwem karty konfiguracyjnej akcji Uruchom skrypt .NET. Można ustawić typ odpowiedniej zmiennej:

Dodatkowo można ustawić, czy są to dane wejściowe do skryptu .NET (opcja Do na liście rozwijanej Kierunek), dane wyjściowe skryptu (opcja Z na liście rozwijanej Kierunek) czy oba typy (opcja Do-Z na liście rozwijanej Kierunek).

Aby używać zmiennych Power Automate w akcjach skryptowych, należy użyć procentu (%) i obsługiwać zmienne tak samo, jak wartości hardcoded.

Uruchom polecenie systemu DOS

Wykonuje polecenie systemu DOS lub aplikację konsoli w trybie niewidocznym i pobiera jej dane wyjściowe po zakończeniu.

Parametry wejściowe

Argument	Opcjonalnie	Akceptuje	Wartość domyślna	opis
DOS command or application	Nie	Plik		Nazwa polecenia systemu DOS lub aplikacji konsoli z argumentami, jeśli mają zastosowanie
Working folder	Tak	Folder		Pełna ścieżka folderu, w którym mają zostać wykonane zadania, jeśli jest używany
Zakończ niepowodzeniem po przekroczeniu limitu czasu	Tak	Wartość logiczna		Określ, czy polecenie lub aplikacja systemu DOS ma działać bez końca, czy działanie ma zostać zakończone niepowodzeniem po upływie ustawionego okresu
Przekroczenie limitu czasu	Nie	Wartość liczbowa	10	Maksymalna liczba sekund oczekiwania na zakończenie wykonywania skryptu (-1, jeśli skrypt może działać bez końca)
Zmień stronę kodową	Brak	Wartość logiczna	Fałsz	Określa, czy bieżąca strona kodowa sesji ma zostać zmieniona
Encoding	Nie	ASMO-708 : arabski (ASMO 708), big5 : chiński tradycyjny (Big5), cp1025 : IBM EBCDIC (cyrylica serbsko-bułgarska), cp866 : cyrylica (DOS), cp875 : IBM EBCDIC (grecki nowoczesny), csISO2022JP : japoński (JIS -Zezwalaj na 1 bajt Kana), DOS-720 : arabski (DOS), DOS-862 : hebrajski (DOS), EUC-CN : chiński uproszczony (EUC), EUC-JP : japoński (JIS 0208-1990 i 0212-1990) , euc-jp : japoński (EUC), euc-kr : koreański (EUC), GB18030 : chiński uproszczony (GB18030), gb2312 : chiński uproszczony (GB2312), hz-gb-2312 : chiński uproszczony (HZ), IBM-Thai : IBM EBCDIC (tajski), IBM00858 : OEM Multilingual Latin I, IBM00924 : IBM Latin-1, IBM01047 : IBM Latin-1, IBM01140 : IBM EBCDIC (USA-Kanada-Euro), IBM01141 : IBM EBCDIC (Niemcy-Euro), IBM01142 : IBM EBCDIC (Dania-Norwegia-Euro), IBM01143 : IBM EBCDIC (Finlandia-Szwecja-Euro), IBM01144 : IBM EBCDIC (Włochy-Euro), IBM01145 : IBM EBCDIC (Hiszpania-Euro), IBM01146 : IBM EBCDIC (Wielka Brytania-Euro), IBM01147 : IBM EBCDIC (Francja-Euro), IBM01148 : IBM EBCDIC (Międzynarodowe-Euro), IBM01149 :IB M EBCDIC (islandzki-Euro), IBM037 : IBM EBCDIC (USA-Kanada), IBM1026 : IBM EBCDIC (turecki Latin-5), IBM273 : IBM EBCDIC (Niemcy), IBM277 : IBM EBCDIC (Dania-Norwegia), IBM278 : IBM EBCDIC (Finlandia-Szwecja), IBM280 : IBM EBCDIC (Włochy), IBM284 : IBM EBCDIC (Hiszpania), IBM285 : IBM EBCDIC (Wielka Brytania), IBM290 : IBM EBCDIC (japońska katakana), IBM297 : IBM EBCDIC (Francja), IBM420 : IBM EBCDIC (arabski), IBM423 : IBM EBCDIC (grecki), IBM424 : IBM EBCDIC (hebrajski), IBM437 : OEM Stany Zjednoczone, IBM500 : IBM EBCDIC (międzynarodowy), ibm737 : grecki (DOS), ibm775 : bałtycki (DOS), ibm850 : zachodnioeuropejski (DOS), ibm852 : środkowoeuropejski (DOS), IBM855 : OEM cyrylica, ibm857 : turecki (DOS), IBM860 : portugalski (DOS), ibm861 : islandzki (DOS), IBM863 : francuski kanadyjski (DOS), IBM864 : arabski (864), IBM865 : nordycki (DOS), ibm869 : grecki, nowoczesny (DOS), IBM870 : IBM EBCDIC (wielojęzyczny Latin-2), IBM871 : IBM EBCDIC (islandzki), IBM880 : IBM EBCDIC (cyrylica rosyjska) , IBM905 : IBM EBCDIC (turecki), iso-2022-jp : japoński anese (JIS), iso-2022-jp : japoński (JIS-Allow 1 byte Kana - SO/SI), iso-2022-kr : koreański (ISO), iso-8859-1 : zachodnioeuropejski (ISO), iso- 8859-13 : estoński (ISO), iso-8859-15 : Latin 9 (ISO), iso-8859-2 : Środkowoeuropejski (ISO), iso-8859-3 : Latin 3 (ISO), iso-8859-4 : Bałtycki (ISO), iso-8859-5 : Cyrylica (ISO), iso-8859-6 : Arabski (ISO), iso-8859-7 : Grecki (ISO), iso-8859-8 : Hebrajski (ISO-Visual ), iso-8859-8-i : hebrajski (ISO-Logical), iso-8859-9 : turecki (ISO), Johab : koreański (Johab), koi8-r : cyrylica (KOI8-R), koi8-u : Cyrylica (KOI8-U), ks_c_5601-1987 : koreański, macintosh : zachodnioeuropejski (Mac), shift_jis : japoński (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 : środkowoeuropejski (Windows), windows-1251 : cyrylica (Windows), Windows-1252 : zachodnioeuropejski (Windows), windows-1253 : grecki (Windows), windows-1254 : Tu rkish (Windows), windows-1255 : hebrajski (Windows), windows-1256 : arabski (Windows), windows-1257 : bałtycki (Windows), windows-1258 : wietnamski (Windows), windows-874 : tajski (Windows), x-Chinese-CNS : chiński tradycyjny (CNS), x-Chinese-Eten : chiński tradycyjny (Eten), x-cp20001 : TCA Tajwan, x-cp20003 : IBM5550 Tajwan, x-cp20004 : Teletekst Tajwan, x-cp20005 : Wang Tajwan, x-cp20261 : T.61, x-cp20269 : ISO-6937, x-cp20936 : chiński uproszczony (GB2312-80), x-cp20949 : koreański Wansung, x-cp50227 : chiński uproszczony (ISO-2022), x -EBCDIC-KoreanExtended: IBM EBCDIC (Korean Extended), x-Europa: Europa, x-IA5: Zachodnioeuropejski (IA5), x-IA5-Niemiecki: Niemiecki (IA5), x-IA5-Norweski: Norweski (IA5), x-IA5-szwedzki : szwedzki (IA5), x-iscii-as : ISCII asamski, x-iscii-be : ISCII bengalski, x-iscii-de : ISCII Devanagari, x-iscii-gu : ISCII Gujarati, x-iscii -ka : ISCII Kannada, x-iscii-ma : ISCII Malayalam, x-iscii-lub : ISCII Oriya, x-iscii-pa : ISCII Punjabi, x-iscii-ta : ISCII Tamil, x-iscii-te : ISCII telugu, x-mac-arabic : arabski (Mac), x-mac-ce : Środkowoeuropejski (Mac), x-mac-chinesesimp : chiński uproszczony (Mac), x-mac-chinesetrad : chiński tradycyjny (Mac) , x-mac-croatian : chorwacki (Mac), x-mac-cyrillic : cyrylica (Mac), x-mac-greek : grecki (Mac), x-mac-hebrew : hebrajski (Mac), x-mac-icelandic : islandzki (Mac), x-mac-japanese : japoński (Mac), x-mac-korean : koreański (Mac), x-mac-romanian : rumuński (Mac), x-mac-thai : tajski (Mac), x-mac-turkish : turecki (Mac), x-mac-ukrainian : ukraiński (Mac)`	utf-8: Unicode (UTF-8)	Kodowanie do użycia podczas odczytywania danych wyjściowych

Utworzone zmienne

Argument	Type	opis
CommandOutput	Wartość tekstowa	Tekst wyjściowy polecenia systemu DOS lub aplikacji
CommandErrorOutput	Wartość tekstowa	Tekst opisujący błędy, które wystąpiły (jeśli wystąpiły) podczas wykonywania polecenia systemu DOS lub aplikacji
CommandExitCode	Wartość liczbowa	Polecenie lub kod zakończenia aplikacji. Ta wartość jest numeryczna

Wyjątki

Wyjątek	opis
Nie można wykonać polecenia lub aplikacji konsoli	Wskazuje problem podczas wykonywania określonego polecenia lub aplikacji konsoli
Nie można uruchomić skryptu w wyznaczonym czasie	Wskazuje problem z uruchomieniem dostarczonego skryptu w wyznaczonym czasie

Uruchom skrypt w języku VBScript

Wykonuje niestandardowy kod w języku VBScript i pobiera jego dane wyjściowe do zmiennej.

Tej akcji można użyć w celu dołączenia do przepływu pulpitu własnego niestandardowego kodu VBScript, używając również zmiennych w tym przepływie, aby w razie potrzeby generować dynamiczną zawartość języka VBScript.

Parametry wejściowe

Argument	Opcjonalnie	Akceptuje	Wartość domyślna	opis
VBScript to run	Tak	Wartość tekstowa		Kod w języku VBScript, który ma zostać wykonany. W skrypcie można umieszczać zmienne, ponieważ będą one obliczane przed wykonaniem kodu w języku VBScript
Zakończ niepowodzeniem po przekroczeniu limitu czasu	Tak	Wartość logiczna	Brak	Określ, czy skrypt języka VBScript ma działać bez końca, czy ma zostać zakończony niepowodzeniem po upływie ustawionego okresu
Przekroczenie limitu czasu	Nie	Wartość liczbowa	10	Maksymalna liczba sekund oczekiwania na zakończenie wykonywania skryptu (-1, jeśli skrypt może działać bez końca)

Utworzone zmienne

Argument	Typ	Podpis
VBScriptOutput	Wartość tekstowa	Dane wyjściowe skryptu
ScriptError	Wartość tekstowa	Błędy, które mogą wystąpić podczas wykonywania kodu w języku VBScript

Wyjątki

Wyjątek	Podpis
Nie można uruchomić skryptu w wyznaczonym czasie	Wskazuje problem z uruchomieniem dostarczonego skryptu w wyznaczonym czasie

Uruchom kod w języku JavaScript

Wykonuje niestandardowy kod w języku JavaScript i pobiera jego dane wyjściowe do zmiennej.

Parametry wejściowe

Argument	Opcjonalnie	Akceptuje	Wartość domyślna	opis
JavaScript to run	Tak	Wartość tekstowa		Kod w języku JavaScript, który ma zostać wykonany. W skrypcie można umieszczać zmienne, ponieważ będą one obliczane przed wykonaniem kodu w języku JavaScript
Zakończ niepowodzeniem po przekroczeniu limitu czasu	Tak	Wartość logiczna		Określ, czy skrypt języka JavaScript ma działać bez końca, czy ma zostać zakończony niepowodzeniem po upływie ustawionego okresu
Przekroczenie limitu czasu	Nie	Wartość liczbowa	10	Maksymalna liczba sekund oczekiwania na zakończenie wykonywania skryptu (-1, jeśli skrypt może działać bez końca)

Utworzone zmienne

Argument	Typ	Podpis
JavascriptOutput	Wartość tekstowa	Dane wyjściowe skryptu
ScriptError	Wartość tekstowa	Błędy, które mogą wystąpić podczas wykonywania kodu w języku JavaScript

Wyjątki

Wyjątek	Podpis
Nie można uruchomić skryptu w wyznaczonym czasie	Wskazuje problem z uruchomieniem dostarczonego skryptu w wyznaczonym czasie

Uruchom skrypt programu PowerShell

Wykonuje niestandardowy skrypt programu PowerShell i pobiera jego dane wyjściowe do zmiennej.

Tej akcji można użyć w celu dołączenia do przepływu pulpitu własnego niestandardowego kodu PowerShell, używając również zmiennych w tym przepływie, aby w razie potrzeby generować dynamiczną zawartość języka PowerShell.

Parametry wejściowe

Argument	Opcjonalnie	Akceptuje	Wartość domyślna	opis
PowerShell code to run	Tak	Wartość tekstowa		Kod PowerShell, który ma zostać wykonany. W skrypcie można umieszczać zmienne, ponieważ będą one obliczane przed wykonaniem kodu w języku PowerShell
Zakończ niepowodzeniem po przekroczeniu limitu czasu	Tak	Wartość logiczna		Określ, czy skrypt programu PowerShell ma działać bez końca, czy ma zostać zakończony niepowodzeniem po upływie ustawionego okresu
Przekroczenie limitu czasu	Nie	Wartość liczbowa	10	Maksymalna liczba sekund oczekiwania na zakończenie wykonywania skryptu (-1, jeśli skrypt może działać bez końca)

Utworzone zmienne

Argument	Typ	Podpis
PowershellOutput	Wartość tekstowa	Dane wyjściowe skryptu
ScriptError	Wartość tekstowa	Błędy, które mogą wystąpić podczas wykonywania kodu programu PowerShell

Wyjątki

Wyjątek	Opis
Nie można uruchomić skryptu programu PowerShell	Wskazuje problem podczas uruchamiania dostarczonego skryptu programu PowerShell
Nie można uruchomić skryptu w wyznaczonym czasie	Wskazuje problem z uruchomieniem dostarczonego skryptu w wyznaczonym czasie

Uruchom skrypt w języku Python

Wykonuje kod skryptu w języku Python i pobiera jego dane wyjściowe.

Parametry wejściowe

Argument	Opcjonalnie	Akceptuje	Wartość domyślna	opis
Python script to run	Nie	Wartość tekstowa		Kod skryptu w języku Python do wykonania
Wersja języka Python	Nie	Python 2.7, Python 3.4	Python 2.7	Określ, która wersja języka Python ma być używana podczas wykonywania skryptu
Module folder paths	Tak	Lista folderów		Ścieżki folderów, w których znajdują się zewnętrzne moduły języka Python

Utworzone zmienne

Argument	Type	opis
PythonScriptOutput	Wartość tekstowa	Dane wyjściowe skryptu
ScriptError	Wartość tekstowa	Błędy, które mogą wystąpić podczas wykonywania kodu skryptu w języku Python

Wyjątki

Wyjątek	Opis
Nie można uruchomić skryptu w języku Python	Wskazuje problem podczas uruchamiania dostarczonego skryptu w języku Python
Nie znaleziono katalogu	Wskazuje, że nie znaleziono katalogu

Uruchom skrypt platformy .NET

Wykonuje kod skryptu w języku .NET (C#/VB.NET) i pobiera jego dane wyjściowe.

Parametry wejściowe

Argument	Opcjonalnie	Akceptuje	Wartość domyślna	opis
Język	Brak	C#/ VB.NET	C#	Język skryptu
Importy skryptu platformy .NET	Tak	Wartość tekstowa		Importy skryptu platformy .NET, które mają zostać uwzględnione w skrypcie
Odwołania do załadowania	Tak	Folder		Ścieżka główna, w której znajdują się odwołania do bibliotek dołączanych dynamicznie (pliki DLL) platformy .NET
Parametry skryptu	Tak	Parametry skryptu definiowane przez użytkownika		Ustawianie wartości parametrów zdefiniowanych w skrypcie
Kod platformy .NET do uruchomienia	Nie	Wartość tekstowa		Kod platformy .NET do uruchomienia

Utworzone zmienne

Ta akcja może tworzyć zmienne, w zależności od konfiguracji wykonanej przez użytkownika w oknie Parametry skryptu.

Uwaga

W przypadku, gdy akcja jest skonfigurowana do tworzenia parametrów wyjściowych (kierunek Z podczas konfigurowania) należy zawsze zagwarantować, że parametr w skrypcie ma wartość inną niż null. W przeciwnym razie wykonanie skryptu spowoduje błąd, ponieważ parametr wyjściowy nie został ustawiony.

Wyjątki

Wyjątek	opis
Nie można uruchomić skryptu platformy .NET	Wskazuje problem podczas uruchamiania dostarczonego skryptu platformy .NET