Delen via

Scriptacties

  • Artikel

Belangrijk

Als u ongeautoriseerde toegang wilt voorkomen, heeft Windows beheerdersrechten nodig om toegang te krijgen tot beveiligde resources. Als u toegang wilt krijgen tot beveiligde resources (zoals bestanden) met behulp van de scriptacties, voert u Power Automate uit met beheerdersrechten. Ga naar Power Automate uitvoeren met verhoogde rechten voor meer informatie over het uitvoeren van Power Automate als beheerder.

Met scriptacties kunt u codeblokken uitvoeren en aangepast gedrag implementeren in uw bureaubladstromen.

Belangrijk

Zoals aangekondigd in oktober 2023 is VBScript afgeschaft in Windows. In toekomstige versies van Windows wordt VBScript als functie op aanvraag beschikbaar voordat dit uit het besturingssysteem wordt verwijderd. Zie voor meer informatie Resources voor afgeschafte functies.

Alle scriptacties volgen de basisstructuur van de respectieve programmeer- of scripttaal: PowerShell, Python, VBScript, JavaScript en C#/VB.NET.

Opmerking

Ondersteunde versie voor C#: v 5.0. Voor VB.NET: v 11.0

Natuurlijke taal voor script mogelijk gemaakt door copilot (preview)

[Dit onderwerp maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Natuurlijke taal voor code is een nieuwe copilot-mogelijkheid die is toegevoegd in Power Automate voor bureaublad. Hiermee kunt u snel code genereren die wordt gebruikt in de scriptacties door deze te beschrijven. Deze functie is beschikbaar in de volgende scriptacties:

  • PowerShell uitvoeren
  • VBScript uitvoeren
  • DOS-opdracht uitvoeren
  • Python uitvoeren
  • JavaScript uitvoeren

Belangrijk

  • Dit is een preview-functie.
  • Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.

Beschikbaarheid per regio

Momenteel is copilot in Power Automate voor bureaublad alleen beschikbaar in omgevingen in de Verenigde Staten.

Beschikbaarheid per accounttype

Momenteel is copilot in Power Automate voor bureaublad alleen beschikbaar voor gebruikers met een werk- of schoolaccount.

Opmerking

Als uw omgeving zich in de hierboven genoemde regio bevindt en u de copilot nog steeds nodig hebt voor Power Automate voor bureaublad, neem dan contact op met uw tenantbeheerder. Mogelijk is de copilot-functionaliteit uitgeschakeld.

Hoe u scripts kunt genereren met copilot en natuurlijke taal

Om scripts te genereren in een van de ondersteunde scriptacties, sleept u de actie en zet u deze neer in de ontwerper en selecteert u Sscript genereren met Copilot.

Schermopname van de PowerShell-actie waarbij de knop Script genereren met Copilot is gemarkeerd

Het scherm voor het maken van een prompt wordt geopend, waar u uw prompt in natuurlijke taal kunt typen.

Schermopname van de PowerShell-actie Genereren terwijl het promptdialoogvenster is geopend

Als u een script wilt maken, schrijft u uw prompt en selecteert u Genereren. Als u het opnieuw moet maken, kunt u de prompt wijzigen en Opnieuw genereren selecteren. Anders selecteert u Dit script gebruiken om terug te gaan naar het hoofdactievenster, waar u het kunt wijzigen en eventueel benodigde variabelen kunt toevoegen.

Schermopname van de PowerShell-actie Dit script genereren terwijl het promptdialoogvenster is geopend

Belangrijk

Zorg ervoor dat u de door het AI-model gegenereerde inhoud altijd controleert.

Help ons deze functie te verbeteren

Stuur feedback door het duim omhoog- of duim omlaag-pictogram te selecteren onder de door AI gegenereerde inhoud. Zodra u dit doet, verschijnt er een feedbackdialoogvenster waarin u feedback kunt indienen bij Microsoft. GIF-animatie waarin de copilot de vraag van een gebruiker van de ontwerper beantwoordt.

Opmerking

Als u het dialoogvenster niet ziet, heeft de tenantbeheerder dit mogelijk uitgeschakeld. Meer informatie: De functionaliteit voor gebruikersfeedback uitschakelen

De functionaliteit voor gebruikersfeedback uitschakelen

Als tenantbeheerder kunt u voorkomen dat uw gebruikers feedback naar Microsoft sturen door de tenantinstelling disableSurveyFeedback uit te schakelen. Meer informatie over het bekijken en instellen van tenantinstellingen vindt u hier:

Aanvragen om rechten van betrokkenen voor gebruikersfeedback

Tenantbeheerders kunnen de feedback van hun gebruikers bekijken, exporteren en verwijderen door zich aan te melden bij het Microsoft 365-beheercentrum en vervolgens Status>Productfeedback te selecteren.

AI met Power Automate-resources

Werken met variabelen in scriptacties

Variabelen declareren in scriptacties en resultaten retourneren in Power Automate met de volgende opdrachten:

  • Als u nieuwe variabelen wilt declareren in PowerShell-scripts, gebruikt u de notatie $. Waarden retourneren uit PowerShell-script uitvoeren-acties in Power Automate, gebruik de opdracht Schrijf-output.

    $variableName = "variableValue"
Write-Output $variableName

  • Voor Python-scripts is geen speciale notatie nodig om nieuwe variabelen te declareren. Als u waarden wilt retourneren van acties van Python-script uitvoeren, gebruikt u de functie print.

    variableName = "variableValue"
print variableName

  • Voor VBScript is geen speciale notatie nodig om nieuwe variabelen te declareren. Gebruik de functie WScript.Echo om waarden uit acties VBScript uitvoeren te retourneren naar Power Automate.

    variableName = "variableValue"
WScript.Echo variableName

  • Gebruik in JavaScript-scripts de var-notatie om nieuwe variabelen te declareren en de functie WScript.Echo om waarden te retourneren van acties van JavaScript uitvoeren.

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

  • Gebruik voor .NET-scripts het venster Scriptparameters, toegankelijk via de configuratiekaart .NET-script uitvoeren van de actie. U kunt het type van de respectieve variabele instellen:

Schermopname van het venster Scriptparameters in de actie .NET-script uitvoeren, waarin het type variabele wordt ingesteld

Daarnaast kunt u instellen of het invoer is voor het .NET-script (de optie In in de vervolgkeuzelijst Richting), uitvoer van het script (de optie Uit in de vervolgkeuzelijst Richting) of beide (de optie In-Uit in de vervolgkeuzelijst Richting).

Schermopname van het venster Scriptparameters in de actie .NET-script uitvoeren, waarin de richting wordt ingesteld

Als u Power Automate-variabelen wilt gebruiken in scriptacties, gebruikt u de percentagenotatie (%) en behandelt u de variabelen op dezelfde manier als hardgecodeerde waarden.

Schermopname van een Python-script dat de percentagenotatie bevat.

DOS-opdracht uitvoeren

Hiermee wordt een DOS-opdracht of consoletoepassing uitgevoerd in de onzichtbare modus en wordt de uitvoer na afloop opgehaald.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
DOS command or application Nee Bestand De naam van een DOS-opdracht of een consoletoepassing, met argumenten, indien van toepassing
Working folder Ja Map Het volledige pad van de map om in te werken, indien van toepassing
Laten mislukken na time-out Ja Booleaanse waarde Geef op of de DOS-opdracht of -toepassing permanent moeten worden uitgevoerd of mislukken na een ingestelde periode
Timeout Nee Numerieke waarde 10 Het maximumaantal seconden dat moet worden gewacht totdat het script is voltooid (-1 voor permanent)
Change code page N.v.t. Booleaanse waarde False Geeft weer of de huidige codepagina van de sessie moet worden gewijzigd
Encoding Nee ASMO-708: Arabisch (ASMO 708), big5: Traditioneel Chinees (Big5), cp1025: IBM EBCDIC (Cyrillisch Servisch-Bulgaars), cp866: Cyrillisch (DOS), cp875: IBM EBCDIC (modern Grieks), csISO2022JP: Japans (JIS-1-byte Kana toestaan), DOS-720: Arabisch (DOS), DOS-862: Hebreeuws (DOS), EUC-CN: Vereenvoudigd Chinees (EUC), EUC-JP: Japans (JIS 0208-1990 en 0212-1990), euc-jp: Japans (EUC), euc-kr: Koreaans (EUC), GB18030: Vereenvoudigd Chinees (GB18030), gb2312: Vereenvoudigd Chinees (GB2312), hz-gb-2312: Vereenvoudigd Chinees (HZ), IBM-Thai: IBM EBCDIC (Thais), IBM00858: OEM Meertalig Latijn I, IBM00924: IBM Latijn-1, IBM01047: IBM Latijn-1, IBM01140: IBM EBCDIC (VS-Canada-Euro), IBM01141: IBM EBCDIC (Duitsland-Euro), IBM01142: IBM EBCDIC (Denemarken-Noorwegen-Euro), IBM01143: IBM EBCDIC (Finland-Zweden-Euro), IBM01144: IBM EBCDIC (Italië-Euro), IBM01145: IBM EBCDIC (Spanje-Euro), IBM01146: IBM EBCDIC (VK-Euro), IBM01147: IBM EBCDIC (Frankrijk-Euro), IBM01148: IBM EBCDIC (Internationaal-Euro), IBM01149: IBM EBCDIC (IJslands-Euro), IBM037: IBM EBCDIC (VS-Canada), IBM1026: IBM EBCDIC (Turks Latijn-5), IBM273: IBM EBCDIC (Duitsland), IBM277: IBM EBCDIC (Denemarken-Noorwegen), IBM278: IBM EBCDIC (Finland-Zweden), IBM280: IBM EBCDIC (Italië), IBM284: IBM EBCDIC (Spanje), IBM285: IBM EBCDIC (VK), IBM290: IBM EBCDIC (Japans katakana), IBM297: IBM EBCDIC (Frankrijk), IBM420: IBM EBCDIC (Arabisch), IBM423: IBM EBCDIC (Grieks), IBM424: IBM EBCDIC (Hebreeuws), IBM437: OEM Verenigde Staten, IBM500: IBM EBCDIC (Internationaal), ibm737: Grieks (DOS), ibm775: Baltisch (DOS), ibm850: West-Europees (DOS), ibm852: Centraal-Europees (DOS), IBM855: OEM Cyrillisch, ibm857: Turks (DOS), IBM860: Portugees (DOS), ibm861: IJslands (DOS), IBM863: Frans Canada (DOS), IBM864: Arabisch (864), IBM865: Noords (DOS), ibm869: Grieks, modern (DOS), IBM870: IBM EBCDIC (Meertalig Latijn-2), IBM871: IBM EBCDIC (IJslands), IBM880: IBM EBCDIC (Cyrillisch Russisch), IBM905: IBM EBCDIC (Turks), iso-2022-jp: Japans (JIS), iso-2022-jp: Japans (JIS-1-byte Kana toestaan - SO/SI), iso-2022-kr: Koreaans (ISO), iso-8859-1: West-Europees (ISO), iso-8859-13: Estlands (ISO), iso-8859-15: Latijn 9 (ISO), iso-8859-2: Centraal-Europees (ISO), iso-8859-3: Latijn 3 (ISO), iso-8859-4: Baltisch (ISO), iso-8859-5: Cyrillisch (ISO), iso-8859-6: Arabisch (ISO), iso-8859-7: Grieks (ISO), iso-8859-8: Hebreeuws (ISO-Visual), iso-8859-8-i: Hebreeuws (ISO-Logical), iso-8859-9: Turks (ISO), Johab: Koreaans (Johab), koi8-r: Cyrillisch (KOI8-R), koi8-u: Cyrillisch (KOI8-U), ks_c_5601-1987: Koreaans, macintosh: West-Europees (Mac), shift_jis: Japans (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: Centraal-Europees (Windows), windows-1251: Cyrillisch (Windows), Windows-1252: West-Europees (Windows), windows-1253: Grieks (Windows), windows-1254: Turks (Windows), windows-1255: Hebreeuws (Windows), windows-1256: Arabisch (Windows), windows-1257: Baltisch (Windows), windows-1258: Vietnamees (Windows), windows-874: Thais (Windows), x-Chinees-CNS: Traditioneel Chinees (CNS), x-Chinese-Eten: Traditioneel Chinees (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: Vereenvoudigd Chinees (GB2312-80), x-cp20949: Koreaans Wansung, x-cp50227: Vereenvoudigd Chinees (ISO-2022), x-EBCDIC-KoreanExtended: IBM EBCDIC (Koreaans uitgebreid), x-Europa: Europa, x-IA5: West-Europees (IA5), x-IA5-German: Duits (IA5), x-IA5-Norwegian: Noors (IA5), x-IA5-Swedish: Zweeds (IA5), x-iscii-as: ISCII Assamees, x-iscii-be: ISCII Bengaals, x-iscii-de: ISCII Devanagari, x-iscii-gu: ISCII Gujarati, x-iscii-ka: ISCII Kannada, x-iscii-ma: ISCII Malayalam, x-iscii-or: ISCII Oriya, x-iscii-pa: ISCII Punjabi, x-iscii-ta: ISCII Tamil, x-iscii-te: ISCII Telugu, x-mac-arabic: Arabisch (Mac), x-mac-ce: Centraal-Europees (Mac), x-mac-chinesesimp: Vereenvoudigd Chinees (Mac), x-mac-chinesetrad: Traditioneel Chinees (Mac), x-mac-croatian: Kroatisch (Mac), x-mac-cyrillic: Cyrillisch (Mac), x-mac-greek: Grieks (Mac), x-mac-hebrew: Hebreeuws (Mac), x-mac-icelandic: IJslands (Mac), x-mac-japanese: Japans (Mac), x-mac-korean: Koreaans (Mac), x-mac-romanian: Roemeens (Mac), x-mac-thai: Thais (Mac), x-mac-turkish: Turks (Mac), x-mac-ukrainian: Oekraïens (Mac)` utf-8: Unicode (UTF-8) De codering die moet worden gebruikt bij het lezen van de output

Variabelen gemaakt

Argument Type Omschrijving
CommandOutput Tekstwaarde De tekstuitvoer van de DOS-opdracht of de toepassing
CommandErrorOutput Tekstwaarde De tekst met een beschrijving van de fouten die zijn opgetreden (mits die zich voordeden) tijdens de uitvoering van de DOS-opdracht of de toepassing
CommandExitCode Numerieke waarde De afsluitcode van de opdracht of toepassing. Deze waarde is numeriek

Uitzonderingen

Uitzondering Omschrijving
Kan opdracht of consoletoepassing niet uitvoeren Duidt op een probleem bij het uitvoeren van de opgegeven opdracht of de consoletoepassing
Script kan niet worden uitgevoerd in de ingestelde tijd Hiermee wordt een probleem aangegeven bij het uitvoeren van het opgegeven script in de ingestelde tijd

VBScript uitvoeren

Hiermee wordt bepaalde aangepaste VBScript-code uitgevoerd en de uitvoer ervan in een variabele opgehaald.

U kunt deze actie gebruiken om uw eigen aangepaste VBScript-code op te nemen in de bureaubladstroom, terwijl u ook de mogelijkheid heeft om daarin variabelen te gebruiken om indien nodig dynamische VBScript-inhoud te genereren.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
VBScript to run Ja Tekstwaarde De VBScript-code die moet worden uitgevoerd. Er kunnen variabelen worden opgenomen in het script aangezien deze worden geëvalueerd voordat VBScript wordt uitgevoerd
Laten mislukken na time-out Ja Booleaanse waarde N.v.t. Geef op of het VBScript-script permanent moeten worden uitgevoerd of mislukken na een ingestelde periode
Timeout Nee Numerieke waarde 10 Het maximumaantal seconden dat moet worden gewacht totdat het script is voltooid (-1 voor permanent)

Geproduceerde variabelen

Argument Type Omschrijving
VBScriptOutput Tekstwaarde De uitvoer van het script
ScriptError Tekstwaarde De fouten die kunnen optreden tijdens de uitvoering van de VBScript-code

Uitzonderingen

Uitzondering Omschrijving
Script kan niet worden uitgevoerd in de ingestelde tijd Hiermee wordt een probleem aangegeven bij het uitvoeren van het opgegeven script in de ingestelde tijd

JavaScript uitvoeren

Hiermee wordt bepaalde aangepaste JavaScript-code uitgevoerd en de uitvoer ervan in een variabele opgehaald.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
JavaScript to run Ja Tekstwaarde De JavaScript-code die moet worden uitgevoerd. Er kunnen variabelen worden opgenomen in het script aangezien deze worden geëvalueerd voordat de JavaScript-code wordt uitgevoerd
Laten mislukken na time-out Ja Booleaanse waarde Geef op of het JavaScript-script permanent moeten worden uitgevoerd of mislukken na een ingestelde periode
Timeout Nee Numerieke waarde 10 Het maximumaantal seconden dat moet worden gewacht totdat het script is voltooid (-1 voor permanent)

Geproduceerde variabelen

Argument Type Omschrijving
JavascriptOutput Tekstwaarde De uitvoer van het script
ScriptError Tekstwaarde De fouten die kunnen optreden tijdens de uitvoering van de JavaScript-code

Uitzonderingen

Uitzondering Omschrijving
Script kan niet worden uitgevoerd in de ingestelde tijd Hiermee wordt een probleem aangegeven bij het uitvoeren van het opgegeven script in de ingestelde tijd

PowerShell-script uitvoeren

Hiermee wordt een aangepast PowerShell-script uitgevoerd en de uitvoer ervan in een variabele opgehaald.

U kunt deze actie gebruiken om uw eigen aangepaste PowerShell-code op te nemen in de bureaubladstroom, terwijl u ook de mogelijkheid heeft om daarin variabelen te gebruiken om indien nodig dynamische PowerShell-inhoud te genereren.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
PowerShell code to run Ja Tekstwaarde De PowerShell-code die moet worden uitgevoerd. Er kunnen variabelen worden opgenomen in het script aangezien deze worden geëvalueerd voordat de PowerShell-code wordt uitgevoerd
Laten mislukken na time-out Ja Booleaanse waarde Geef op of het PowerShell-script permanent moeten worden uitgevoerd of mislukken na een ingestelde periode
Timeout Nee Numerieke waarde 10 Het maximumaantal seconden dat moet worden gewacht totdat het script is voltooid (-1 voor permanent)

Geproduceerde variabelen

Argument Type Omschrijving
PowershellOutput Tekstwaarde De uitvoer van het script
ScriptError Tekstwaarde De fouten die kunnen optreden tijdens de uitvoering van de PowerShell-code

Uitzonderingen

Uitzondering Beschrijving
Het PowerShell-script kan niet worden uitgevoerd Duidt op een probleem bij het uitvoeren van het opgegeven PowerShell-script
Script kan niet worden uitgevoerd in de ingestelde tijd Hiermee wordt een probleem aangegeven bij het uitvoeren van het opgegeven script in de ingestelde tijd

Python-script uitvoeren

Hiermee wordt de Python-scriptcode uitgevoerd en de uitvoer ervan opgehaald.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
Uit te voeren Python-script Nee Tekstwaarde De Python-scriptcode die moet worden uitgevoerd
Python-versie Nee Python 2.7, Python 3.4 Python 2.7 Geef op welke Python-versie moet worden gebruikt bij het uitvoeren van het script
Mappaden van modules Ja Lijst met mappen De paden van mappen waar zich externe Python-modules bevinden

Variabelen gemaakt

Argument Type Omschrijving
PythonScriptOutput Tekstwaarde De uitvoer van het script
ScriptError Tekstwaarde De fouten die kunnen optreden tijdens de uitvoering van de Python-scriptcode

Uitzonderingen

Uitzondering Beschrijving
Het Python-script kan niet worden uitgevoerd Duidt op een probleem bij het uitvoeren van het opgegeven Python-script
Map niet gevonden Geeft aan dat de map niet is gevonden

.NET-script uitvoeren

Hiermee wordt .NET-scriptcode (C#/VB.NET) uitgevoerd en de uitvoer ervan opgehaald.

Invoerparameters

Argument Optioneel Accepteert Standaardwaarde Omschrijving
Taal N.v.t. C#/ VB.NET C# De taal van het script
.NET-scriptimports Ja Tekstwaarde De .NET-scriptimports die in het script moet worden opgenomen
Verwijzingen die moeten worden geladen Ja Map Het hoofdpad waar dynamische .NET-koppelingsbibliotheken (.dll-bestanden) zich bevinden
Scriptparameters Ja Scriptparameters zoals gedefinieerd door de gebruiker De waarden instellen van de parameters die in het script zijn gedefinieerd
.NET-code om uit te voeren Nee Tekstwaarde De .NET-code die moet worden uitgevoerd

Geproduceerde variabelen

Deze actie kan variabelen produceren, afhankelijk van de configuratie die door de gebruiker is gemaakt bij gebruik van het venster Scriptparameters.

Opmerking

In het geval dat de actie is geconfigureerd om uitvoerparameters te produceren (met behulp van de richting Uit bij het configureren ervan), moet u er altijd voor zorgen dat de parameter in het script is ingesteld op een waarde anders dan null. Anders resulteert de uitvoering van het script in een fout omdat de uitvoerparameter niet is ingesteld.

Uitzonderingen

Uitzondering Omschrijving
Kan het .NET-script niet uitvoeren Duidt op een probleem bij het uitvoeren van het opgegeven .NET-script