Scripthandlinger

Vigtigt

For at forhindre uautoriseret adgang kræver Windows administratorrettigheder for at få adgang til beskyttede ressourcer. Hvis du vil have adgang til beskyttede ressourcer (f.eks. filer) ved hjælp af scripthandlinger, skal du køre Power Automate med administratorrettigheder. Du kan finde flere oplysninger om, hvordan du kører Power Automate som administrator, under Kør Power Automate med administratorrettigheder.

Scriptinghandlinger gør det muligt for brugerne at køre kodeblokke og implementere brugerdefineret adfærd i dine skrivebordsflows.

Vigtigt

Som annonceret i oktober 2023 udfaser Windows VBScript. I fremtidige versioner af Windows vil VBScript være tilgængelig som en funktion efter anmodning, før den fjernes fra operativsystemet. Du kan finde flere oplysninger under Ressourcer til udfasede funktioner.

Alle scripthandlinger følger den grundlæggende struktur i det pågældende programmerings- eller scriptsprog: PowerShell, Python, VBScript, JavaScript og C#/VB.NET.

Bemærk

Understøttet version for C#: v 5.0. For VB.NET: v 11.0

Naturligt sprog til script, der leveres af Copilot (prøveversion)

[Dette emne er en foreløbig udgivelse af dokumentationen, og der kan forekomme ændringer.]

Naturligt sprog til script er en ny Copilot funktion, der er tilføjet i Power Automate til desktop. Den giver dig mulighed for hurtigt at generere den kode, der bruges i scripthandlinger, ved blot at beskrive den på et naturligt sprog. Denne funktion er tilgængelig i følgende scripthandlinger:

  • Kør PowerShell
  • Kør VBScript
  • Kør DOS-kommando
  • Kør Python
  • Kør JavaScript

Vigtigt

  • Dette er en forhåndsversion af funktionen.
  • Forhåndsversionsfunktionerne er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.
  • Du kan finde flere oplysninger under vilkår for forhåndsversion.

Tilgængelighedsområder

I øjeblikket er naturligt sprog til script tilgængeligt i miljøer, der er placeret i følgende områder:

  • Asien og Stillehavsområdet
  • Australien
  • Brasilien
  • Canada
  • Europa
  • Frankrig
  • Tyskland
  • Indien
  • Japan
  • Norge
  • Singapore
  • Sydafrika
  • Sydkorea
  • Sverige
  • Schweiz
  • Forenede Arabiske Emirater
  • Storbritannien
  • USA

Tilgængelighed efter kontotype

I øjeblikket er Copilot i Power Automate til skrivebord kun tilgængelig for brugere med en arbejds- eller skolekonto.

Bemærk

Hvis dit miljø er i et af de tidligere angivne områder, og du stadig har brug for at se copilot i Power Automate til skrivebord-oplevelsen, skal du kontakte lejeradministratoren.

Sådan genererer du scripts ved hjælp af Copilot og naturligt sprog

Hvis du vil generere scripts, skal du trække og slippe en af de understøttede scripthandlinger i designeren og derefter vælge Generér script med Copilot.

Skærmbillede af handlingen kør PowerShell med knappen Opret script med Copilot fremhævet

Skærmbilledet Opret prompt åbnes, hvor du kan skrive prompten for dit naturlige sprog.

Skærmbillede af handlingen til generering af PowerShell, hvor prompt-dialogboksen er åben

Hvis du vil oprette et script, skal du skrive prompten og vælge Opret. Hvis du har brug for at genoprette den, skal du ændre prompten og vælge Gendan. Ellers skal du vælge Brug dette script til at vende tilbage til hovedhandlingsvinduet, hvor du kan ændre det og tilføje eventuelle nødvendige variabler.

Skærmbillede af brug af dette script til PowerShell-handling, hvor prompt-dialogboksen er åben

Vigtigt

Gennemse altid det indhold, der genereres af AI-modellen.

Hjælp os med at forbedre denne funktion

Send feedback ved at vælge ikonet for tommel op eller tommel ned under det AI-genererede indhold. Når du vælger et ikon, vises der en feedbackdialogboks, som du kan bruge til at sende feedback til Microsoft. Gif-illustration, der viser, at medpiloten svarer på en brugers spørgsmål fra designeren.

Bemærk

Hvis du ikke kan se dialogboksen, har lejeradministratoren måske slået den fra. Du kan få flere oplysninger under Deaktivering af brugerfeedbackfunktionen.

Deaktivering af funktionaliteten for brugerfeedback

Som Power Platform-administrator kan du forhindre brugerne i at sende Copilot feedback til Microsoft ved hjælp af lejerindstillingen "Copilot feedback".

Anmodninger om data om emnerettigheder i brugerfeedback

Lejeradministratorer kan få vist, eksportere og slette feedback fra brugere ved at logge på Microsoft 365 Administration og derefter gå til Sundhed>Produkt-feedback.

AI med Power Automate-ressourcer

Arbejde med variabler i scripthandlinger

Hvis du vil erklære variabler i scripthandlinger og returnere resultater i Power Automate, skal du bruge følgende kommandoer:

  • Hvis du vil erklære nye variabler i PowerShell-scripts, skal du bruge $ som notation. Hvis du vil returnere værdier fra Kør PowerShell-script-handlinger til Power Automate, skal du bruge kommandoen Write-Output.

    $variableName = "variableValue"
    Write-Output $variableName
    
  • Python-scripts kræver ikke nogen særlig notation for at erklære nye variabler. Hvis du vil returnere værdier fra Kør Python-script-handlingerne, skal du bruge print-funktionen.

    variableName = "variableValue"
    print variableName
    
  • VBScript kræver ikke nogen særlig notation for at erklære nye variabler. Brug funktionen WScript.Echo til at returnere værdier fra Kør VBScript-handlinger til Power Automate.

    variableName = "variableValue"
    WScript.Echo variableName
    
  • I JavaScript-scripts skal du bruge notationen var til at erklære nye variabler og funktionen WScript.Echo til at returnere værdier fra Kør JavaScript-handlinger.

    var variableName = "variableValue";
    WScript.Echo(variableName);
    
  • I forbindelse med .NET-scripts skal du bruge vinduet Scriptparametre, der åbnes via konfigurationskortet for handlingen Kør .NET-script. Du kan angive typen af den pågældende variabel:

Skærmbillede af vinduet Scriptparametre i handlingen Kør .NET-script, hvor variabeltypen angives

Derudover kan du angive, om det er et input til .NET-scriptet (indstillingen Ind på rullelisten Retning), et output af scriptet (indstillingen Ud på rullelisten Retning) eller begge (indstilligenInd-Ud på rullelisten Retning).

Skærmbillede af vinduet Scriptparametre i handlingen Kør .NET-script, hvor retningen angives

Hvis du vil bruge Power Automate-variabler i scripthandlinger, skal du bruge procentnotationen (%) og håndtere variablerne på samme måde som hardcodede værdier.

Skærmbillede af et Python-script, der indeholder procentvis notation.

Kør DOS-kommando

Kører en DOS-kommando eller et konsolprogram i usynlig tilstand og returnerer outputtet, når det er færdigt.

Inputparametre

Argument Valgfrit Accepterer Standardværdi Beskrivelse
DOS-kommando eller -program Nej Fil Navnet på DOS-kommandoen eller et konsolprogram. Medtag argumenter, hvis det er nødvendigt.
Arbejdsmappe Ja Mappe Den fulde sti til den mappe, der skal arbejdes fra, hvis det er relevant.
Mislykkedes efter timeout Ja Boolesk værdi Angiv, om DOS-kommandoen eller -programmet kører på ubestemt tid eller mislykkes efter en angivet tidsperiode.
Timeout Nej Numerisk værdi 10 Det maksimale antal sekunder, der skal ventes på, at scriptet fuldføres (-1 i det uendelige).
Skift kodeside I/R Boolesk værdi False Angiver, om sessionens aktuelle tegntabel skal ændres.
Encoding Nej ASMO-708: Arabisk (ASMO 708), big5: Kinesisk - traditionelt (Big5), cp1025: IBM EBCDIC (Kyrillisk serbisk-bulgarsk), cp866: Kyrillisk (DOS), cp875: IBM EBCDIC (Græsk, moderne), csISO2022JP: Japansk (JIS-Allow 1 byte Kana), DOS-720: Arabisk (DOS), DOS-862: Hebraisk (DOS), EUC-CN: Kinesisk, forenklet (EUC), EUC-JP: Japansk (JIS 0208-1990 og 0212-1990), euc-jp: Japansk (EUC), euc-kr: Koreansk (EUC), GB18030: Kinesisk, forenklet (GB18030), gb2312: Kinesisk, forenklet (GB2312), hz-gb-2312: Kinesisk, forenklet (HZ), IBM-Thai: IBM EBCDIC (Thai), IBM00858: OEM Flersprogligt latin I, IBM00924: IBM Latin-1, IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (US-Canada-Euro), IBM01141: IBM EBCDIC (Tyskland-euro), IBM01142: IBM EBCDIC (Danmark-Norge-euro), IBM01143: IBM EBCDIC (Finland-Sverige-euro), IBM01144: IBM EBCDIC (Italien-Euro), IBM01145: IBM EBCDIC (Spanien-euro), IBM01146: IBM EBCDIC (Storbritannien-euro), IBM01147: IBM EBCDIC (Frankrig-euro), IBM01148: IBM EBCDIC (International-Euro), IBM01149: IBM EBCDIC (Island-euro), IBM037: IBM EBCDIC (USA-Canada), IBM1026: IBM EBCDIC (Tyrkisk latin-5), IBM273: IBM EBCDIC (Tyskland), IBM277: IBM EBCDIC (Danmark-Norge), IBM278: IBM EBCDIC (Finland-Sverige), IBM280: IBM EBCDIC (Italien), IBM284: IBM EBCDIC (Spanien), IBM285: IBM EBCDIC (Storbritannien), IBM290: IBM EBCDIC (Japansk katakana), IBM297: IBM EBCDIC (Frankrig), IBM420: IBM EBCDIC (Arabisk), IBM423: IBM EBCDIC (Græsk), IBM424: IBM EBCDIC (Hebraisk), IBM437: OEM USA, IBM500: IBM EBCDIC (International), ibm737: Græsk (DOS), ibm775: Baltisk (DOS), ibm850: Vesteuropæisk (DOS), ibm852: Centraleuropæisk (DOS), IBM855: OEM Kyrillisk, ibm857: Tyrkisk (DOS), IBM860: Portugisisk (DOS), ibm861: Islandsk (DOS), IBM863: Fransk canadisk (DOS), IBM864: Arabisk (864), IBM865: Nordisk (DOS), ibm869: Græsk, moderne (DOS), IBM870: IBM EBCDIC (Flersprogligt latin-2), IBM871: IBM EBCDIC (Islandsk), IBM880: IBM EBCDIC (Kyrillisk, russisk), IBM905: IBM EBCDIC (Tyrkisk), iso-2022-jp : Japansk (JIS), iso-2022-jp: Japansk (JIS-Allow 1 byte Kana - SO/SI), iso-2022-kr: Koreansk (ISO), iso-8859-1: Vesteuropæisk (ISO), iso-8859-13: Estisk (ISO), iso-8859-15: Latin 9 (ISO), iso-8859-2: Centraleuropæisk (ISO), iso-8859-3: Latin 3 (ISO), iso-8859-4: Baltisk (ISO), iso-8859-5: Kyrillisk (ISO), iso-8859-6: Arabisk (ISO), iso-8859-7 : Græsk (ISO), iso-8859-8: Hebraisk (ISO-Visual), iso-8859-8-i: Hebraisk (ISO-Logical), iso-8859-9: Tyrkisk (ISO), Johab: Koreansk (Johab), koi8-r: Kyrillisk (KOI8-R), koi8-u: Kyrillisk (KOI8-U), ks_c_5601-1987: Koreansk, macintosh: Vesteuropæisk (Mac), shift_jis: Japansk (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: Hebraisk (Windows), windows-1256: Arabisk (Windows), windows-1257: Baltisk (Windows), windows-1258: Vietnamesisk (Windows), windows-874: Thai (Windows), x-Chinese-CNS: Kinesisk, traditionelt (CNS), x-Chinese-Eten: Kinesisk, traditionelt (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: Chinese Simplified (GB2312-80), x-cp20949: Korean Wansung, x-cp50227: Chinese Simplified (ISO-2022), x-EBCDIC-KoreanExtended: IBM EBCDIC (Koreansk, udvidet), x-Europa: Europa, x-IA5: Vesteuropæisk (IA5), x-IA5-German: Tysk (IA5), x-IA5-Norwegian: Norsk (IA5), x-IA5-Swedish: Svensk (IA5), x-iscii-as: ISCII Assamesisk, x-iscii-be: ISCII Bengalsk, 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: Arabisk (Mac), x-mac-ce: Centraleuropæisk (Mac), x-mac-chinesesimp: Kinesisk forenklet (Mac), x-mac-chinesetrad: Kinesisk, traditionelt (Mac), x-mac-croatian: Kroatisk (Mac), x-mac-cyrillic: Kyrillisk (Mac), x-mac-greek: Græsk (Mac), x-mac-hebrew: Hebraisk (Mac), x-mac-icelandic: Islandsk (Mac), x-mac-japanese: Japansk (Mac), x-mac-korean: Koreansk (Mac), x-mac-romanian: Rumænsk (Mac), x-mac-thai: Thai (Mac), x-mac-turkish: Tyrkisk (Mac), x-mac-ukrainian: Ukrainsk (Mac)` utf-8 : Unicode (UTF-8) Den kodning, der skal bruges, når outputtet læses.

Variabler produceret

Argument Type Beskrivelse
CommandOutput Tekstværdi Tekstoutputtet fra DOS-kommandoen eller -programmet.
CommandErrorOutput Tekstværdi Den tekst, der beskriver eventuelle fejl, der opstod under udførelsen af DOS-kommandoen eller -programmet.
CommandExitCode Numerisk værdi Kommandoen eller programafslutningskode. Denne værdi er numerisk.

Undtagelser

Undtagelse Beskrivelse
Kan ikke udføre kommando eller konsolprogram Angiver et problem under udførelse af den angivne kommando eller det angivne konsolprogram.
Scriptet kunne ikke køres inden for den tildelte tid Angiver et problem med at køre det angivne script i den tildelte tid.

Kør VBScript

Kører brugerdefineret VBScript-kode og henter outputtet til en variabel.

Brug denne handling til at føje din egen brugerdefinerede VBScript-kode til desktopflowet. Du kan bruge variabler i scriptet til at oprette dynamisk VBScript-indhold.

Inputparametre

Argument Valgfrit Accepterer Standardværdi Beskrivelse
VBScript, der skal køres Ja Tekstværdi Den VBScript-kode, der skal køres. Medtag variabler i scriptet, fordi de evalueres, før VBScript kører.
Mislykkedes efter timeout Ja Boolesk værdi I/R Vælg, om VBScript skal køre for evigt eller stopper efter et angivet tidspunkt.
Timeout Nej Numerisk værdi 10 Det maksimale antal sekunder, der skal ventes på, at scriptet fuldføres (-1 i det uendelige).

Variabler produceret

Argument Type Beskrivelse
VBScriptOutput Tekstværdi Scriptets output.
ScriptError Tekstværdi Eventuelle fejl, der opstår, når VBScript-koden køres.

Undtagelser

Undtagelse Beskrivelse
Scriptet kunne ikke køres inden for den tildelte tid Angiver et problem med at køre det angivne script i den tildelte tid.

Kør JavaScript

Kører brugerdefineret JavaScript-kode og henter outputtet til en variabel.

Inputparametre

Argument Valgfrit Accepterer Standardværdi Beskrivelse
JavaScript, der skal køres Ja Tekstværdi JavaScriptkode, der skal køres. Medtag variabler i scriptet, fordi de evalueres, før JavaScript-koden kører.
Mislykkedes efter timeout Ja Boolesk værdi Angiv, om JavaScript-scriptet kører på ubestemt tid eller mislykkes efter en angivet tidsperiode.
Timeout Nej Numerisk værdi 10 Det maksimale antal sekunder, der skal ventes på, at scriptet fuldføres (-1 i det uendelige).

Variabler produceret

Argument Type Beskrivelse
JavascriptOutput Tekstværdi Scriptets output.
ScriptError Tekstværdi De fejl, der opstår under udførelsen af JavaScript-koden.

Undtagelser

Undtagelse Beskrivelse
Scriptet kunne ikke køres inden for den tildelte tid Angiver et problem med at køre det angivne script i den tildelte tid.

Kør PowerShell-script

Udfører et brugerdefineret PowerShell-script og henter outputtet til en variabel.

Brug denne handling til at inkludere din egen brugerdefinerede PowerShell-kode i desktopflowet. Du kan bruge variabler til at generere dynamisk PowerShell-indhold.

Inputparametre

Argument Valgfrit Accepterer Standardværdi Beskrivelse
PowerShell-kode, der skal køres Ja Tekstværdi PowerShell, der skal køres. Medtag variabler i scriptet, da de evalueres før udførelsen af PowerShell-koden
Mislykkedes efter timeout Ja Boolesk værdi Angiv, om PowerShell-scriptet kører på ubestemt tid eller mislykkes efter en angivet tidsperiode
Timeout Nej Numerisk værdi 10 Det maksimale antal sekunder, der skal ventes på, at scriptet fuldføres (-1 i det uendelige).

Variabler produceret

Argument Type Beskrivelse
PowershellOutput Tekstværdi Scriptets output
ScriptError Tekstværdi De fejl, der opstår under udførelsen af PowerShell-koden

Undtagelser

Undtagelse Beskrivelse
Kunne ikke køre PowerShell-script Angiver et problem med at køre det angivne PowerShell-script
Scriptet kunne ikke køres inden for den tildelte tid Angiver et problem med at køre det angivne script i den tildelte tid.

Kør Python-script

Udfører Python-scriptkode og henter outputtet.

Inputparametre

Argument Valgfrit Accepterer Standardværdi Beskrivelse
Python script, der skal køres Nej Tekstværdi Python-scriptkode, der skal køres
Python-version Nej Python 2.7, Python 3.4 Python 2.7 Angiv, hvilken version af Python der skal bruges ved udførelse af scriptet
Stierne til modulmapper Ja Liste over mapper Stierne til de mapper, hvor eksterne Python-moduler ligger

Variabler produceret

Argument Type Beskrivelse
PythonScriptOutput Tekstværdi Scriptets output
ScriptError Tekstværdi De fejl, der opstår under udførelsen af Python scriptkoden

Undtagelser

Undtagelse Beskrivelse
Kunne ikke køre Python-script Angiver et problem med at køre det angivne Python-script
Mappen blev ikke fundet Angiver, at mappen ikke blev fundet

Kør .NET-script

Udfører .NET (C#/VB.NET)-scriptkode og henter outputtet.

Inputparametre

Argument Valgfrit Accepterer Standardværdi Beskrivelse
Sprog I/R C#/ VB.NET C# Scriptets sprog
.NET-script importerer Ja Tekstværdi Det .NET script importeres, som skal medtages i scriptet
Referencer til indlæsning Ja Mappe Rodstien, hvor .NET referencer til DLL-biblioteket (.dll) er placeret
Scriptparametre Ja Scriptparametre som defineret af brugeren Angivelse af værdierne for de parametre, der er defineret i scriptet
.NET-kode, der skal køres Nej Tekstværdi Den .NET-kode, der skal køres

Variabler produceret

Denne handling kan medføre variabler, afhængigt af den konfiguration du har angivet i vinduet Scriptparametre .

Bemærk

Hvis du konfigurerer handlingen til at oprette outputparametre ved hjælp af retningen Ud , skal du sikre dig, at parameteren i scriptet er angivet til en anden værdi end null. Ellers returnerer scriptet en fejl, fordi outputparameteren ikke er angivet.

Undtagelser

Undtagelse Beskrivelse
.NET-scriptet kunne ikke køres Angiver et problem med at køre det angivne .NET-script