Akcje skryptu

Ważne

Aby zapobiec nieautoryzowanemu dostępowi, Windows wymaga uprawnień administratora w celu uzyskania dostępu do chronionych zasobów. Aby uzyskać dostęp do chronionych zasobów (takich jak pliki) przy użyciu akcji skryptów, uruchom Power Automate z uprawnieniami administratora. Aby uzyskać więcej informacji na temat uruchamiania Power Automate jako administrator, zobacz Uruchamianie Power Automate z podwyższonym poziomem uprawnień.

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 w październiku 2023 r. Windows przestarzałe vbScript. 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.

Notatka

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

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

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

Język naturalny do skryptu to nowa funkcja Copilot dodana w Power Automate dla komputerów stacjonarnych. Dzięki temu można szybko wygenerować kod używany w akcjach skryptów, opisując go w języku naturalnym. Ta funkcja jest dostępna w następujących akcjach skryptowych:

  • Uruchom PowerShell
  • Uruchom skrypt w języku VBScript
  • Uruchom polecenie systemu 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.
  • Aby uzyskać więcej informacji, przejdź do naszej strony warunków wersji zapoznawczej.

Dostępność według regionów

Obecnie język naturalny do skryptu jest dostępny w środowiskach znajdujących się w następujących regionach:

  • Azja i Pacyfik
  • Australia
  • Brazylia
  • Canada
  • Europa
  • Francja
  • Niemcy
  • Indie
  • Japonia
  • Norwegia
  • Singapur
  • Republika Południowej Afryki
  • Korea Południowa
  • Szwecja
  • Switzerland
  • Zjednoczone Emiraty Arabskie
  • Zjednoczone Królestwo
  • Stany Zjednoczone

Dostępność według typu konta

Obecnie funkcja Copilot w usłudze Power Automate for desktop jest dostępna tylko dla użytkowników posiadających konto służbowe lub szkolne.

Notatka

Jeśli Twoje środowisko znajduje się w jednym z wcześniej wymienionych regionów i nadal musisz widzieć pomocnik w Power Automate środowisku pulpitu, skontaktuj się z administratorem dzierżawy.

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

Aby wygenerować skrypty, przeciągnij i upuść jedną z obsługiwanych akcji skryptów do projektanta, a następnie wybierz pozycję Generuj skrypt z Copilot.

Zrzut ekranu akcji Uruchom PowerShell z podświetlonym przyciskiem Generowanie skryptu za pomocą Copilot

Zostanie otwarty ekran Tworzenie monitu , w którym można wpisać monit języka naturalnego.

Zrzut ekranu generowania akcji PowerShell z otwartym oknem dialogowym promptu

Aby utworzyć skrypt, napisz prompt i wybierz Generuj. Jeśli chcesz go ponownie utworzyć, zmień monit i wybierz pozycję Wygeneruj ponownie. W przeciwnym razie wybierz pozycję Użyj tego skryptu , aby powrócić do okna akcji głównej, w którym można go zmodyfikować i dodać wszelkie niezbędne zmienne.

Zrzut ekranu akcji use this script PowerShell z otwartym oknem dialogowym promptu

Ważne

Zawsze przejrzyj zawartość wygenerowaną przez model sztucznej inteligencji.

Pomóż nam ulepszać tę funkcję

Wyślij opinię, wybierając ikonę kciuka w górę lub w dół pod zawartością wygenerowaną przez sztuczną inteligencję. Po wybraniu ikony zostanie wyświetlone okno dialogowe opinii, którego można użyć do przesłania opinii w celu Microsoft. Animowany gif przedstawiający drugiego pilota odpowiadającego na pytanie użytkownika zadane przez projektanta.

Notatka

Jeśli nie widzisz okna dialogowego, administrator dzierżawy mógł je wyłączyć. Aby uzyskać więcej informacji, zobacz Wyłączanie funkcji opinii użytkowników.

Wyłączenie funkcji opinii użytkownika

Jako administrator usługi Power Platform możesz uniemożliwić użytkownikom przesyłanie opinii o rozwiązaniu Copilot do firmy Microsoft za pomocą ustawienia dzierżawy „Copilot feedback”.

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

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:

Zrzut ekranu okna parametrów skryptu w akcji Uruchom skrypt .NET, ustawianie typu 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).

Zrzut ekranu okna parametrów skryptu w akcji Uruchom skrypt .NET, ustawianie kierunku

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

Zrzut ekranu przedstawiający skrypt języka Python z notacją używającą znaku procentu.

Uruchom polecenie systemu DOS

Uruchamia polecenie systemu DOS lub aplikację konsolową w trybie niewidocznym i zwraca dane wyjściowe po zakończeniu.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
Polecenie lub aplikacja systemu DOS Nie Plik Nazwa polecenia systemu DOS lub aplikacji konsolowej. W razie potrzeby dołącz argumenty.
Folder roboczy Tak Folder Pełna ścieżka folderu do pracy, jeśli ma to zastosowanie.
Zakończ niepowodzeniem po przekroczeniu limitu czasu Tak Wartość logiczna Określ, czy polecenie systemu DOS lub aplikacja jest uruchamiane w nieskończoność, czy kończy się niepowodzeniem po upływie określonego czasu.
Przekroczenie limitu czasu Nie Wartość liczbowa 10 Maksymalna liczba sekund oczekiwania na ukończenie skryptu (-1 przez czas nieokreślony).
Zmień stronę kodową Brak Wartość logiczna Fałsz Określa, czy zmienić bieżącą stronę kodów sesji.
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 Typ opis
CommandOutput Wartość tekstowa Dane wyjściowe tekstu z polecenia lub aplikacji DOS.
CommandErrorOutput Wartość tekstowa Tekst opisujący wszelkie błędy, które wystąpiły podczas wykonywania polecenia lub aplikacji DOS.
CommandExitCode Wartość liczbowa Polecenie lub kod zakończenia aplikacji. Ta wartość jest liczbowa.

Wyjątki

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

Uruchom skrypt w języku VBScript

Uruchamia niestandardowy kod VBScript i pobiera dane wyjściowe do zmiennej.

Użyj tej akcji, aby dodać własny niestandardowy kod VBScript do przepływu pulpitu. Możesz użyć zmiennych w skrypcie, aby utworzyć dynamiczną zawartość VBScript.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
VBScript do uruchomienia Tak Wartość tekstowa Kod VBScript do uruchomienia. Uwzględnij zmienne w skrypcie, ponieważ oceniają przed uruchomieniem języka VBScript.
Zakończ niepowodzeniem po przekroczeniu limitu czasu Tak Wartość logiczna Brak Określ, czy skrypt VBScript działa na zawsze, czy zatrzymuje się po upływie określonego czasu.
Przekroczenie limitu czasu Nie Wartość liczbowa 10 Maksymalna liczba sekund oczekiwania na ukończenie skryptu (-1 przez czas nieokreślony).

Utworzone zmienne

Argument Typ opis
VBScriptOutput Wartość tekstowa Dane wyjściowe skryptu.
ScriptError Wartość tekstowa Wszelkie błędy występujące podczas uruchamiania kodu VBScript.

Wyjątki

Wyjątek opis
Nie można uruchomić skryptu w wyznaczonym czasie Wskazuje problem z uruchomieniem podanego skryptu w przydzielonym czasie.

Uruchom kod w języku JavaScript

Uruchamia niestandardowy kod JavaScript i pobiera dane wyjściowe do zmiennej.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
JavaScript do uruchomienia Tak Wartość tekstowa Kod w języku JavaScript, który ma zostać wykonany. Uwzględnij zmienne w skrypcie, ponieważ oceniają przed uruchomieniem kodu JavaScript.
Zakończ niepowodzeniem po przekroczeniu limitu czasu Tak Wartość logiczna Określ, czy skrypt języka JavaScript jest uruchamiany w nieskończoność, czy kończy się niepowodzeniem po upływie określonego czasu.
Przekroczenie limitu czasu Nie Wartość liczbowa 10 Maksymalna liczba sekund oczekiwania na ukończenie skryptu (-1 przez czas nieokreślony).

Utworzone zmienne

Argument Typ opis
JavascriptOutput Wartość tekstowa Dane wyjściowe skryptu.
ScriptError Wartość tekstowa Błędy występujące podczas wykonywania kodu JavaScript.

Wyjątki

Wyjątek opis
Nie można uruchomić skryptu w wyznaczonym czasie Wskazuje problem z uruchomieniem podanego skryptu w przydzielonym czasie.

Uruchom skrypt programu PowerShell

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

Użyj tej akcji, aby uwzględnić własny niestandardowy kod programu PowerShell w przepływie pulpitu. Zmienne umożliwiają generowanie dynamicznej zawartości programu PowerShell.

Parametry wejściowe

Argument Opcjonalnie Akceptuje Wartość domyślna opis
Kod PowerShell do uruchomienia Tak Wartość tekstowa Kod PowerShell, który ma zostać wykonany. Uwzględnij zmienne w skrycie, ponieważ oceniają przed wykonaniem kodu programu PowerShell
Zakończ niepowodzeniem po przekroczeniu limitu czasu Tak Wartość logiczna Określ, czy skrypt programu PowerShell jest uruchamiany w nieskończoność, czy kończy się niepowodzeniem po upływie określonego czasu
Przekroczenie limitu czasu Nie Wartość liczbowa 10 Maksymalna liczba sekund oczekiwania na ukończenie skryptu (-1 przez czas nieokreślony).

Utworzone zmienne

Argument Typ opis
PowershellOutput Wartość tekstowa Dane wyjściowe skryptu
ScriptError Wartość tekstowa Błędy występujące 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 podanego skryptu w przydzielonym 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
skrypt Python do uruchomienia 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
Ścieżki z folderami modułów Tak Listafolderów Ścieżki folderów, w których znajdują się zewnętrzne moduły języka Python

Utworzone zmienne

Argument Typ opis
PythonScriptOutput Wartość tekstowa Dane wyjściowe skryptu
ScriptError Wartość tekstowa Błędy występujące podczas wykonywania kodu skryptu 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 Importowanie skryptu .NET do uwzględnienia w skry skrycie
Odwołania do ładowania Tak Folder Ścieżka główna, w której znajdują się odwołania do biblioteki linków dynamicznych .NET (.dll)
Parametry skryptu Tak Parametry skryptu zdefiniowane 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 generować zmienne w zależności od konfiguracji ustawionej w oknie Parametry skryptu .

Notatka

Jeśli skonfigurujesz akcję w celu wygenerowania parametrów wyjściowych przy użyciu kierunku wyjściowego , upewnij się, że parametr w skry skryptzie jest ustawiony na wartość inną niż null. W przeciwnym razie skrypt zwraca błąd, ponieważ parametr wyjściowy nie jest ustawiony.

Wyjątki

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